org.apache.sshd.common.future

Class AbstractSshFuture<T extends SshFuture>

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.common.future.AbstractSshFuture<T>

Type Parameters:

T - Type of future

All Implemented Interfaces:

SshFuture<T>, WaitableFuture

Direct Known Subclasses:

DefaultSshFuture

public abstract class AbstractSshFuture<T extends SshFuture>
extends AbstractLoggingBean
implements SshFuture<T>

Author:

Apache MINA SSHD Project

Field Summary

Fields

Modifier and Type	Field and Description
protected static Object	CANCELED A default value to indicate the future has been canceled

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSshFuture()

Method Summary

Modifier and Type	Method and Description
protected SshFutureListener<T>	asListener(Object o)
protected T	asT()
boolean	await(long timeoutMillis) Wait for the asynchronous operation to complete with the specified timeout.
protected abstract Object	await0(long timeoutMillis, boolean interruptable) Wait for the Future to be ready.
boolean	awaitUninterruptibly(long timeoutMillis) Wait for the asynchronous operation to complete with the specified timeout uninterruptibly.
protected void	notifyListener(SshFutureListener<T> l)
protected <R> R	verifyResult(Class<? extends R> expectedType, long timeout) Waits (interruptible) for the specified timeout (msec.) and then checks the result: If result is null then timeout is assumed to have expired - throw an appropriate IOException If the result is of the expected type, then cast and return it If the result is an IOException then re-throw it If the result is a Throwable then throw an IOException whose cause is the original exception Otherwise (should never happen), throw a StreamCorruptedException with the name of the result type

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.sshd.common.future.SshFuture

addListener, removeListener

Methods inherited from interface org.apache.sshd.common.future.WaitableFuture

await, await, awaitUninterruptibly, awaitUninterruptibly, isDone

Field Detail

CANCELED

protected static final Object CANCELED

A default value to indicate the future has been canceled

Constructor Detail

AbstractSshFuture

protected AbstractSshFuture()

Method Detail

await

public boolean await(long timeoutMillis)
              throws IOException

Description copied from interface: WaitableFuture

Wait for the asynchronous operation to complete with the specified timeout.

Specified by:

await in interface WaitableFuture

Parameters:

timeoutMillis - Wait time in milliseconds

Returns:

true if the operation is completed.

Throws:

IOException - if failed - specifically InterruptedIOException if waiting was interrupted

awaitUninterruptibly

public boolean awaitUninterruptibly(long timeoutMillis)

Description copied from interface: WaitableFuture

Wait for the asynchronous operation to complete with the specified timeout uninterruptibly.

Specified by:

awaitUninterruptibly in interface WaitableFuture

Parameters:

timeoutMillis - Wait time in milliseconds

Returns:

true if the operation is finished.

verifyResult

protected <R> R verifyResult(Class<? extends R> expectedType,
                             long timeout)
                      throws IOException

Waits (interruptible) for the specified timeout (msec.) and then checks the result:

• If result is null then timeout is assumed to have expired - throw an appropriate IOException

• If the result is of the expected type, then cast and return it

• If the result is an IOException then re-throw it

• If the result is a Throwable then throw an IOException whose cause is the original exception

• Otherwise (should never happen), throw a StreamCorruptedException with the name of the result type

Type Parameters:

R - The generic result type

Parameters:

expectedType - The expected result type

timeout - The timeout (millis) to wait for a result

Returns:

The (never null) result

Throws:

IOException - If failed to retrieve the expected result on time

await0

protected abstract Object await0(long timeoutMillis,
                                 boolean interruptable)
                          throws InterruptedIOException

Wait for the Future to be ready. If the requested delay is 0 or negative, this method returns immediately.

Parameters:

timeoutMillis - The delay we will wait for the Future to be ready

interruptable - Tells if the wait can be interrupted or not. If true and the thread is interrupted then an InterruptedIOException is thrown.

Returns:

The non-null result object if the Future is ready, null if the timeout expired and no result was received

Throws:

InterruptedIOException - If the thread has been interrupted when it's not allowed.

asListener

protected SshFutureListener<T> asListener(Object o)

notifyListener

protected void notifyListener(SshFutureListener<T> l)

asT

protected T asT()