public class

DefaultConnectingIOReactor

extends AbstractMultiworkerIOReactor
implements ConnectingIOReactor
java.lang.Object
   ↳ org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
     ↳ org.apache.http.impl.nio.reactor.DefaultConnectingIOReactor

Class Overview

Default implementation of ConnectingIOReactor. This class extends AbstractMultiworkerIOReactor with capability to connect to remote hosts.

The following parameters can be used to customize the behavior of this class:

Summary

[Expand]
Inherited Fields
From class org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
Public Constructors
DefaultConnectingIOReactor(int workerCount, ThreadFactory threadFactory, HttpParams params)
DefaultConnectingIOReactor(int workerCount, HttpParams params)
Public Methods
SessionRequest connect(SocketAddress remoteAddress, SocketAddress localAddress, Object attachment, SessionRequestCallback callback)
Requests a connection to a remote host.
Protected Methods
void cancelRequests()
Triggered to cancel pending session requests.
void processEvents(int readyCount)
Triggered to process I/O events registered by the main Selector.
[Expand]
Inherited Methods
From class org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
From class java.lang.Object
From interface org.apache.http.nio.reactor.ConnectingIOReactor
From interface org.apache.http.nio.reactor.IOReactor

Public Constructors

public DefaultConnectingIOReactor (int workerCount, ThreadFactory threadFactory, HttpParams params)

public DefaultConnectingIOReactor (int workerCount, HttpParams params)

Public Methods

public SessionRequest connect (SocketAddress remoteAddress, SocketAddress localAddress, Object attachment, SessionRequestCallback callback)

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.

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.

Protected Methods

protected void cancelRequests ()

Triggered to cancel pending session requests.

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

protected void processEvents (int readyCount)

Triggered to process I/O events registered by the main Selector.

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

Parameters
readyCount event count.