Class DefaultConnectingIOReactor
- All Implemented Interfaces:
ConnectingIOReactor
,IOReactor
ConnectingIOReactor
. This class extends
AbstractMultiworkerIOReactor
with capability to connect to remote
hosts.- Since:
- 4.0
-
Nested Class Summary
Nested classes/interfaces inherited from class org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
AbstractMultiworkerIOReactor.DefaultThreadFactory, AbstractMultiworkerIOReactor.Worker
-
Field Summary
FieldsFields inherited from class org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
auditLog, config, exceptionHandler, interestOpsQueueing, params, selector, selectTimeout, status
-
Constructor Summary
ConstructorsConstructorDescriptionCreates an instance of DefaultConnectingIOReactor with default configuration.DefaultConnectingIOReactor
(int workerCount, ThreadFactory threadFactory, HttpParams params) Deprecated.DefaultConnectingIOReactor
(int workerCount, HttpParams params) Deprecated.Creates an instance of DefaultConnectingIOReactor with the given configuration.DefaultConnectingIOReactor
(IOReactorConfig config, ThreadFactory threadFactory) Creates an instance of DefaultConnectingIOReactor with the given configuration. -
Method Summary
Modifier and TypeMethodDescriptionprotected void
Triggered to cancel pending session requests.connect
(SocketAddress remoteAddress, SocketAddress localAddress, Object attachment, SessionRequestCallback callback) Requests a connection to a remote host.private void
processEvent
(SelectionKey key) protected void
processEvents
(int readyCount) Triggered to process I/O events registered by the mainSelector
.private void
private void
processTimeouts
(Set<SelectionKey> keys) private void
validateAddress
(SocketAddress address) Methods inherited from class org.apache.http.impl.nio.reactor.AbstractMultiworkerIOReactor
addChannel, addExceptionEvent, addExceptionEvent, awaitShutdown, closeChannel, convert, doShutdown, execute, getAuditLog, getStatus, prepareSocket, registerChannel, setExceptionHandler, shutdown, shutdown
-
Field Details
-
requestQueue
-
lastTimeoutCheck
private long lastTimeoutCheck
-
-
Constructor Details
-
DefaultConnectingIOReactor
public DefaultConnectingIOReactor(IOReactorConfig config, ThreadFactory threadFactory) throws IOReactorException Creates an instance of DefaultConnectingIOReactor with the given configuration.- Parameters:
config
- I/O reactor configuration.threadFactory
- the factory to create threads. Can benull
.- Throws:
IOReactorException
- in case if a non-recoverable I/O error.- Since:
- 4.2
-
DefaultConnectingIOReactor
Creates an instance of DefaultConnectingIOReactor with the given configuration.- Parameters:
config
- I/O reactor configuration. Can benull
.- Throws:
IOReactorException
- in case if a non-recoverable I/O error.- Since:
- 4.2
-
DefaultConnectingIOReactor
Creates an instance of DefaultConnectingIOReactor with default configuration.- Throws:
IOReactorException
- in case if a non-recoverable I/O error.- Since:
- 4.2
-
DefaultConnectingIOReactor
@Deprecated public DefaultConnectingIOReactor(int workerCount, ThreadFactory threadFactory, HttpParams params) throws IOReactorException Deprecated.- Throws:
IOReactorException
-
DefaultConnectingIOReactor
@Deprecated public DefaultConnectingIOReactor(int workerCount, HttpParams params) throws IOReactorException Deprecated.- Throws:
IOReactorException
-
-
Method Details
-
cancelRequests
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 classAbstractMultiworkerIOReactor
- Throws:
IOReactorException
- in case if a non-recoverable I/O error.
-
processEvents
Description copied from class:AbstractMultiworkerIOReactor
Triggered to process I/O events registered by the mainSelector
.Super-classes can implement this method to react to the event.
- Specified by:
processEvents
in classAbstractMultiworkerIOReactor
- Parameters:
readyCount
- event count.- Throws:
IOReactorException
- in case if a non-recoverable I/O error.
-
processEvent
-
processTimeouts
-
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 interfaceConnectingIOReactor
- Parameters:
remoteAddress
- the socket address of the remote host.localAddress
- the local socket address. Can benull
, in which can the default local address and a random port will be used.attachment
- the attachment object. Can benull
.callback
- interface. Can benull
.- Returns:
- session request object.
-
validateAddress
- Throws:
UnknownHostException
-
processSessionRequests
- Throws:
IOReactorException
-
DefaultConnectingIOReactor(IOReactorConfig, ThreadFactory)