T
- the type of result that this operation producespublic abstract class AbstractIoFuture<T> extends Object implements IoFuture<T>
IoFuture
objects. Used to easily produce implementations.IoFuture.HandlingNotifier<T,A>, IoFuture.Notifier<T,A>, IoFuture.Status
Modifier | Constructor and Description |
---|---|
protected |
AbstractIoFuture()
Construct a new instance.
|
Modifier and Type | Method and Description |
---|---|
protected void |
addCancelHandler(Cancellable cancellable)
Add a cancellation handler.
|
<A> IoFuture<T> |
addNotifier(IoFuture.Notifier<? super T,A> notifier,
A attachment)
Add a notifier to be called when this operation is complete.
|
IoFuture.Status |
await()
Wait for the operation to complete.
|
IoFuture.Status |
await(long time,
TimeUnit timeUnit)
Wait for the operation to complete, with a timeout.
|
IoFuture.Status |
awaitInterruptibly()
Wait for the operation to complete.
|
IoFuture.Status |
awaitInterruptibly(long time,
TimeUnit timeUnit)
Wait for the operation to complete, with a timeout.
|
IoFuture<T> |
cancel()
Cancel an operation.
|
T |
get()
Get the result of the operation.
|
IOException |
getException()
Get the failure reason.
|
T |
getInterruptibly()
Get the result of the operation.
|
protected Executor |
getNotifierExecutor()
Get the executor used to run asynchronous notifiers.
|
IoFuture.Status |
getStatus()
Get the current status.
|
protected void |
runNotifier(Runnable runnable)
Run a notifier.
|
protected boolean |
setCancelled()
Acknowledge the cancellation of this operation.
|
protected boolean |
setException(IOException exception)
Set the exception for this operation.
|
protected boolean |
setResult(T result)
Set the result for this operation.
|
public IoFuture.Status getStatus()
public IoFuture.Status await()
IoFuture.Status.WAITING
.public IoFuture.Status await(long time, TimeUnit timeUnit)
IoFuture.Status.WAITING
,
or the given time elapses. If the time elapses before the operation is complete, IoFuture.Status.WAITING
is
returned.await
in interface IoFuture<T>
time
- the amount of time to waittimeUnit
- the time unitIoFuture.Status.WAITING
if the timeout expiredpublic IoFuture.Status awaitInterruptibly() throws InterruptedException
IoFuture.Status.WAITING
,
or the current thread is interrupted.awaitInterruptibly
in interface IoFuture<T>
InterruptedException
- if the operation is interruptedpublic IoFuture.Status awaitInterruptibly(long time, TimeUnit timeUnit) throws InterruptedException
IoFuture.Status.WAITING
,
the given time elapses, or the current thread is interrupted. If the time elapses before the operation is complete, IoFuture.Status.WAITING
is
returned.awaitInterruptibly
in interface IoFuture<T>
time
- the amount of time to waittimeUnit
- the time unitIoFuture.Status.WAITING
if the timeout expiredInterruptedException
- if the operation is interruptedpublic T get() throws IOException, CancellationException
get
in interface IoFuture<T>
IOException
- if the operation failedCancellationException
- if the operation was cancelledpublic T getInterruptibly() throws IOException, InterruptedException, CancellationException
getInterruptibly
in interface IoFuture<T>
IOException
- if the operation failedInterruptedException
- if the operation is interruptedCancellationException
- if the operation was cancelledpublic IOException getException() throws IllegalStateException
getException
in interface IoFuture<T>
IllegalStateException
- if the operation did not failpublic <A> IoFuture<T> addNotifier(IoFuture.Notifier<? super T,A> notifier, A attachment)
addNotifier
in interface IoFuture<T>
A
- the attachment typenotifier
- the notifier to be calledattachment
- the attachment to pass in to the notifierprotected boolean setException(IOException exception)
exception
- the exception to setfalse
if the operation was already completed, true
otherwiseprotected boolean setResult(T result)
result
- the result to setfalse
if the operation was already completed, true
otherwiseprotected boolean setCancelled()
false
if the operation was already completed, true
otherwisepublic IoFuture<T> cancel()
setCancelled()
method to indicate that the cancel was successful. The
default implementation calls any registered cancel handlers.cancel
in interface Cancellable
cancel
in interface IoFuture<T>
IoFuture
instanceprotected void addCancelHandler(Cancellable cancellable)
IoFuture
is cancelled. If
the IoFuture
is already cancelled when this method is called, the handler will be called directly.cancellable
- the cancel handlerprotected void runNotifier(Runnable runnable)
Executor
retrieved via getNotifierExecutor()
.runnable
- the runnable taskprotected Executor getNotifierExecutor()
Copyright © 2021 JBoss by Red Hat. All rights reserved.