Class DefaultConnectingIOReactor

java.lang.Object
org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
org.apache.http.impl.nio.reactor.DefaultConnectingIOReactor
All Implemented Interfaces:
ConnectingIOReactor, IOReactor

public class DefaultConnectingIOReactor extends AbstractMultiworkerIOReactor implements ConnectingIOReactor
Default implementation of ConnectingIOReactor. This class extends AbstractMultiworkerIOReactor with capability to connect to remote hosts.
Since:
4.0
  • Field Details

    • requestQueue

      private final Queue<SessionRequestImpl> requestQueue
    • lastTimeoutCheck

      private long lastTimeoutCheck
  • Constructor Details

  • Method Details

    • cancelRequests

      protected void cancelRequests() throws IOReactorException
      Description copied from class: AbstractMultiworkerIOReactor
      Triggered to cancel pending session requests.

      Super-classes can implement this method to react to the event.

      Specified by:
      cancelRequests in class AbstractMultiworkerIOReactor
      Throws:
      IOReactorException - in case if a non-recoverable I/O error.
    • processEvents

      protected void processEvents(int readyCount) throws IOReactorException
      Description copied from class: AbstractMultiworkerIOReactor
      Triggered to process I/O events registered by the main Selector.

      Super-classes can implement this method to react to the event.

      Specified by:
      processEvents in class AbstractMultiworkerIOReactor
      Parameters:
      readyCount - event count.
      Throws:
      IOReactorException - in case if a non-recoverable I/O error.
    • processEvent

      private void processEvent(SelectionKey key)
    • processTimeouts

      private void processTimeouts(Set<SelectionKey> keys)
    • connect

      public SessionRequest connect(SocketAddress remoteAddress, SocketAddress localAddress, Object attachment, SessionRequestCallback callback)
      Description copied from interface: ConnectingIOReactor
      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 SessionRequest 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 SessionRequestCallback instance to get notified of events related to session requests, such as request completion, cancellation, failure or timeout.

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

      private void validateAddress(SocketAddress address) throws UnknownHostException
      Throws:
      UnknownHostException
    • processSessionRequests

      private void processSessionRequests() throws IOReactorException
      Throws:
      IOReactorException