Package org.apache.hc.core5.reactor

Class SingleCoreIOReactor

    • Field Detail

      • closedSessions

        private final java.util.Queue<IOSession> closedSessions

      • channelQueue

        private final java.util.Queue<ChannelEntry> channelQueue

      • shutdownInitiated

        private final java.util.concurrent.atomic.AtomicBoolean shutdownInitiated

      • selectTimeoutMillis

        private final long selectTimeoutMillis

      • lastTimeoutCheckMillis

        private volatile long lastTimeoutCheckMillis

      • lastSelectMillis

        private volatile long lastSelectMillis

      • totalWaitTime

        private final java.util.concurrent.atomic.AtomicLong totalWaitTime

      • processedRequestCount

        private final java.util.concurrent.atomic.AtomicInteger processedRequestCount

    • Method Detail

      • initiateSessionShutdown

        private void initiateSessionShutdown()

      • validateActiveChannels

        private void validateActiveChannels()

      • processEvents

        private void processEvents​(java.util.Set<java.nio.channels.SelectionKey> selectedKeys)

      • processPendingChannels

        private void processPendingChannels()
                             throws java.io.IOException
        Throws:
        java.io.IOException

      • processClosedSessions

        private void processClosedSessions()

      • checkTimeout

        private void checkTimeout​(java.nio.channels.SelectionKey key,
                          long nowMillis)

      • connect

        public java.util.concurrent.Future<IOSession> connect​(NamedEndpoint remoteEndpoint,
                                                      java.net.SocketAddress remoteAddress,
                                                      java.net.SocketAddress localAddress,
                                                      Timeout timeout,
                                                      java.lang.Object attachment,
                                                      FutureCallback<IOSession> callback)
                                               throws IOReactorShutdownException
        Description copied from interface: ConnectionInitiator
        Requests a connection to a remote host.

        Opening a connection to a remote host usually tends to be a time consuming process and may take a while to complete. One can monitor and control the process of session initialization by means of the Future interface.

        There are several parameters one can use to exert a greater control over the process of session initialization:

        A non-null local socket address parameter can be used to bind the socket to a specific local address.

        An attachment object can added to the new session's context upon initialization. This object can be used to pass an initial processing state to the protocol handler.

        It is often desirable to be able to react to the completion of a session request asynchronously without having to wait for it, blocking the current thread of execution. One can optionally provide an implementation FutureCallback instance to get notified of events related to session requests, such as request completion, cancellation, failure or timeout.

        Specified by:
        connect in interface ConnectionInitiator
        Parameters:
        remoteEndpoint - name of the remote host.
        remoteAddress - remote socket address.
        localAddress - local socket address. Can be null, in which can the default local address and a random port will be used.
        timeout - connect timeout.
        attachment - the attachment object. Can be null.
        callback - interface. Can be null.
        Returns:
        session request object.
        Throws:
        IOReactorShutdownException

      • prepareSocket

        private void prepareSocket​(java.nio.channels.SocketChannel socketChannel)
                    throws java.io.IOException
        Throws:
        java.io.IOException

      • validateAddress

        private void validateAddress​(java.net.SocketAddress address)
                      throws java.net.UnknownHostException
        Throws:
        java.net.UnknownHostException

      • processPendingConnectionRequests

        private void processPendingConnectionRequests()

      • openSocketFor

        private static java.nio.channels.SocketChannel openSocketFor​(java.net.SocketAddress remoteAddress)
                                                      throws java.io.IOException
        Throws:
        java.io.IOException

      • processConnectionRequest

        private void processConnectionRequest​(java.nio.channels.SocketChannel socketChannel,
                                      IOSessionRequest sessionRequest)
                               throws java.io.IOException
        Throws:
        java.io.IOException

      • closeOpenChannels

        private void closeOpenChannels()

      • closePendingChannels

        private void closePendingChannels()

      • closePendingConnectionRequests

        private void closePendingConnectionRequests()

      • reportStatusToThreadPoolListener

        private void reportStatusToThreadPoolListener()
        Reports the current status of the I/O reactor's thread pool to the configured metrics listener.

        This method gathers three key metrics:

        • Active Threads: The number of currently active threads handling I/O sessions.
        • Pending Connections: The number of connection requests waiting to be processed.
        • Saturation Percentage: The ratio of active threads to the maximum allowed connections (defined by MAX_CHANNEL_REQUESTS), expressed as a percentage. It provides insight into how saturated the thread pool is relative to its maximum capacity. The formula for calculating saturation is: 
               saturationPercentage = (activeThreads / MAX_CHANNEL_REQUESTS) * 100.0

        If the number of pending connections exceeds MAX_CHANNEL_REQUESTS, resource starvation is detected, and an appropriate event is reported.