public class AsyncRequester extends Object implements IOReactorService
Constructor and Description |
---|
AsyncRequester(IOEventHandlerFactory eventHandlerFactory,
IOReactorConfig ioReactorConfig,
Decorator<IOSession> ioSessionDecorator,
Callback<Exception> exceptionCallback,
IOSessionListener sessionListener,
Callback<IOSession> sessionShutdownCallback,
Resolver<HttpHost,InetSocketAddress> addressResolver) |
Modifier and Type | Method and Description |
---|---|
void |
awaitShutdown(TimeValue waitTime)
Blocks for the given period of time in milliseconds awaiting
the completion of the reactor shutdown.
|
void |
close() |
void |
close(CloseMode closeMode)
Shuts down the I/O reactor either gracefully or immediately.
|
Future<IOSession> |
connect(NamedEndpoint remoteEndpoint,
SocketAddress remoteAddress,
SocketAddress localAddress,
Timeout timeout,
Object attachment,
FutureCallback<IOSession> callback)
Requests a connection to a remote host.
|
IOReactorStatus |
getStatus()
Returns the current status of the reactor.
|
void |
initiateShutdown()
Initiates shutdown of the reactor without blocking.
|
Future<IOSession> |
requestSession(HttpHost host,
Timeout timeout,
Object attachment,
FutureCallback<IOSession> callback) |
void |
start()
Starts I/O reactor.
|
@Internal public AsyncRequester(IOEventHandlerFactory eventHandlerFactory, IOReactorConfig ioReactorConfig, Decorator<IOSession> ioSessionDecorator, Callback<Exception> exceptionCallback, IOSessionListener sessionListener, Callback<IOSession> sessionShutdownCallback, Resolver<HttpHost,InetSocketAddress> addressResolver)
public Future<IOSession> requestSession(HttpHost host, Timeout timeout, Object attachment, FutureCallback<IOSession> callback)
public void start()
IOReactorService
start
in interface IOReactorService
public IOReactorStatus getStatus()
IOReactor
public void initiateShutdown()
IOReactor
initiateShutdown
in interface IOReactor
public void awaitShutdown(TimeValue waitTime) throws InterruptedException
IOReactor
awaitShutdown
in interface IOReactor
waitTime
- wait time.InterruptedException
public void close(CloseMode closeMode)
IOReactor
close
in interface ModalCloseable
close
in interface IOReactor
closeMode
- How to close the I/O reactor.public void close() throws IOException
close
in interface Closeable
close
in interface AutoCloseable
IOException
public final Future<IOSession> connect(NamedEndpoint remoteEndpoint, SocketAddress remoteAddress, SocketAddress localAddress, Timeout timeout, Object attachment, FutureCallback<IOSession> callback)
ConnectionInitiator
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.
connect
in interface ConnectionInitiator
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
.Copyright © 2005–2021 The Apache Software Foundation. All rights reserved.