Class AbstractIOReactorBase
- java.lang.Object
-
- org.apache.hc.core5.reactor.AbstractIOReactorBase
-
- All Implemented Interfaces:
java.io.Closeable
,java.lang.AutoCloseable
,ModalCloseable
,ConnectionInitiator
,IOReactor
,IOReactorService
- Direct Known Subclasses:
DefaultConnectingIOReactor
,DefaultListeningIOReactor
abstract class AbstractIOReactorBase extends java.lang.Object implements ConnectionInitiator, IOReactorService
-
-
Constructor Summary
Constructors Constructor Description AbstractIOReactorBase()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description 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)
Requests a connection to a remote host.(package private) abstract IOWorkers.Selector
getWorkerSelector()
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.apache.hc.core5.reactor.IOReactor
awaitShutdown, close, getStatus, initiateShutdown
-
Methods inherited from interface org.apache.hc.core5.reactor.IOReactorService
start
-
-
-
-
Method Detail
-
connect
public final 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 interfaceConnectionInitiator
- Parameters:
remoteEndpoint
- name of the remote host.remoteAddress
- remote socket address.localAddress
- local socket address. Can benull
, in which can the default local address and a random port will be used.timeout
- connect timeout.attachment
- the attachment object. Can benull
.callback
- interface. Can benull
.- Returns:
- session request object.
- Throws:
IOReactorShutdownException
-
getWorkerSelector
abstract IOWorkers.Selector getWorkerSelector()
-
-