Package org.opends.server.protocols.http

Class HTTPConnectionHandler

    • Constructor Detail

      • HTTPConnectionHandler

        public HTTPConnectionHandler()
        Default constructor. It is invoked by reflection to create this ConnectionHandler.

    • Method Detail

      • finalizeConnectionHandler

        public void finalizeConnectionHandler​(org.forgerock.i18n.LocalizableMessage finalizeReason)
        Description copied from class: ConnectionHandler
        Closes this connection handler so that it will no longer accept new client connections. Implementations should disconnect any existing connections.
        Specified by:
        finalizeConnectionHandler in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Parameters:
        finalizeReason - The reason that this connection handler should be finalized.

      • getAlerts

        public Map<String,​String> getAlerts()
        Description copied from interface: AlertGenerator
        Retrieves information about the set of alerts that this generator may produce. The map returned should be between the notification type for a particular notification and the human-readable description for that notification. This alert generator must not generate any alerts with types that are not contained in this list.
        Specified by:
        getAlerts in interface AlertGenerator
        Returns:
        Information about the set of alerts that this generator may produce.

      • getClassName

        public String getClassName()
        Description copied from interface: AlertGenerator
        Retrieves the fully-qualified name of the Java class for this alert generator implementation.
        Specified by:
        getClassName in interface AlertGenerator
        Returns:
        The fully-qualified name of the Java class for this alert generator implementation.

      • getConnectionHandlerName

        public String getConnectionHandlerName()
        Description copied from class: ConnectionHandler
        Retrieves a name that may be used to refer to this connection handler. Every connection handler instance (even handlers of the same type) must have a unique name.
        Specified by:
        getConnectionHandlerName in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Returns:
        A unique name that may be used to refer to this connection handler.

      • getEnabledSSLCipherSuites

        public Collection<String> getEnabledSSLCipherSuites()
        Description copied from class: ConnectionHandler
        Retrieves an unmodifiable set of enabled SSL cipher suites configured for this connection handler, if applicable. Implementations must return an empty set if use of SSL/TLS is not possible.
        Overrides:
        getEnabledSSLCipherSuites in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Returns:
        The set of enabled SSL cipher suites configured for this connection handler.

      • getListeners

        public Collection<HostPort> getListeners()
        Description copied from class: ConnectionHandler
        Retrieves information about the listener(s) that will be used to accept client connections.
        Specified by:
        getListeners in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Returns:
        Information about the listener(s) that will be used to accept client connections, or an empty list if this connection handler does not accept connections from network clients.

      • getProtocol

        public String getProtocol()
        Description copied from class: ConnectionHandler
        Retrieves the name of the protocol used to communicate with clients. It should take into account any special naming that may be needed to express any security mechanisms or other constraints in place (e.g., "LDAPS" for LDAP over SSL).
        Specified by:
        getProtocol in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Returns:
        The name of the protocol used to communicate with clients.

      • getStatTracker

        public HTTPStatistics getStatTracker()
        Retrieves the set of statistics maintained by this connection handler.
        Returns:
        The set of statistics maintained by this connection handler.

      • isConfigurationAcceptable

        public boolean isConfigurationAcceptable​(ConnectionHandlerCfg configuration,
                                         List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)
        Description copied from class: ConnectionHandler
        Indicates whether the provided configuration is acceptable for this connection handler. It should be possible to call this method on an uninitialized connection handler instance in order to determine whether the connection handler would be able to use the provided configuration.

        Note that implementations which use a subclass of the provided configuration class will likely need to cast the configuration to the appropriate subclass type.
        Overrides:
        isConfigurationAcceptable in class ConnectionHandler<HTTPConnectionHandlerCfg>
        Parameters:
        configuration - The connection handler configuration for which to make the determination.
        unacceptableReasons - A list that may be used to hold the reasons that the provided configuration is not acceptable.
        Returns:
        true if the provided configuration is acceptable for this connection handler, or false if not.

      • isConfigurationChangeAcceptable

        public boolean isConfigurationChangeAcceptable​(HTTPConnectionHandlerCfg configuration,
                                               List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)
        Description copied from interface: ConfigurationChangeListener
        Indicates whether the proposed change to the configuration is acceptable to this change listener.
        Specified by:
        isConfigurationChangeAcceptable in interface ConfigurationChangeListener<HTTPConnectionHandlerCfg>
        Parameters:
        configuration - The new configuration containing the changes.
        unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.
        Returns:
        Returns true if the proposed change is acceptable, or false if it is not.

      • keepStats

        public boolean keepStats()
        Indicates whether this connection handler should maintain usage statistics.
        Returns:
        true if this connection handler should maintain usage statistics, or false if not.

      • processServerShutdown

        public void processServerShutdown​(org.forgerock.i18n.LocalizableMessage reason)
        Description copied from interface: ServerShutdownListener
        Indicates that the Directory Server has received a request to stop running and that this shutdown listener should take any action necessary to prepare for it.
        Specified by:
        processServerShutdown in interface ServerShutdownListener
        Parameters:
        reason - The human-readable reason for the shutdown.

      • start

        public void start()

        Deliberately left unsynchronized, unlike the overridden Thread.start(): the state this method touches is guarded by the waitListen monitor, and holding the thread's own monitor across waitListen.wait() would block Thread.join().

        Overrides:
        start in class Thread