Class DefaultChannelFuture

java.lang.Object
org.jboss.netty.channel.DefaultChannelFuture
All Implemented Interfaces:
ChannelFuture
Direct Known Subclasses:
AbstractChannel.ChannelCloseFuture, ChannelRunnableWrapper, SslHandler.SSLEngineInboundCloseFuture
public class DefaultChannelFuture extends Object implements ChannelFuture
The default ChannelFuture implementation. It is recommended to use Channels.future(Channel) and Channels.future(Channel, boolean) to create a new ChannelFuture rather than calling the constructor explicitly.

  • Field Details

    • logger

      private static final InternalLogger logger

    • CANCELLED

      private static final Throwable CANCELLED

    • useDeadLockChecker

      private static volatile boolean useDeadLockChecker

    • disabledDeadLockCheckerOnce

      private static boolean disabledDeadLockCheckerOnce

    • channel

      private final Channel channel

    • cancellable

      private final boolean cancellable

    • firstListener

      private ChannelFutureListener firstListener

    • otherListeners

      private List<ChannelFutureListener> otherListeners

    • progressListeners

      private List<ChannelFutureProgressListener> progressListeners

    • done

      private boolean done

    • cause

      private Throwable cause

    • waiters

      private int waiters

  • Constructor Details

    • DefaultChannelFuture

      public DefaultChannelFuture(Channel channel, boolean cancellable)
      Creates a new instance.
      Parameters:
      channel - the Channel associated with this future
      cancellable - true if and only if this future can be canceled

  • Method Details

    • isUseDeadLockChecker

      public static boolean isUseDeadLockChecker()
      Returns true if and only if the dead lock checker is enabled.

    • setUseDeadLockChecker

      public static void setUseDeadLockChecker(boolean useDeadLockChecker)
      Enables or disables the dead lock checker. It is not recommended to disable the dead lock checker. Disable it at your own risk!

    • getChannel

      public Channel getChannel()
      Description copied from interface: ChannelFuture
      Returns a channel where the I/O operation associated with this future takes place.
      Specified by:
      getChannel in interface ChannelFuture

    • isDone

      public boolean isDone()
      Description copied from interface: ChannelFuture
      Returns true if and only if this future is complete, regardless of whether the operation was successful, failed, or cancelled.
      Specified by:
      isDone in interface ChannelFuture

    • isSuccess

      public boolean isSuccess()
      Description copied from interface: ChannelFuture
      Returns true if and only if the I/O operation was completed successfully.
      Specified by:
      isSuccess in interface ChannelFuture

    • getCause

      public Throwable getCause()
      Description copied from interface: ChannelFuture
      Returns the cause of the failed I/O operation if the I/O operation has failed.
      Specified by:
      getCause in interface ChannelFuture
      Returns:
      the cause of the failure. null if succeeded or this future is not completed yet.

    • isCancelled

      public boolean isCancelled()
      Description copied from interface: ChannelFuture
      Returns true if and only if this future was cancelled by a ChannelFuture.cancel() method.
      Specified by:
      isCancelled in interface ChannelFuture

    • addListener

      public void addListener(ChannelFutureListener listener)
      Description copied from interface: ChannelFuture
      Adds the specified listener to this future. The specified listener is notified when this future is done. If this future is already completed, the specified listener is notified immediately.
      Specified by:
      addListener in interface ChannelFuture

    • removeListener

      public void removeListener(ChannelFutureListener listener)
      Description copied from interface: ChannelFuture
      Removes the specified listener from this future. The specified listener is no longer notified when this future is done. If the specified listener is not associated with this future, this method does nothing and returns silently.
      Specified by:
      removeListener in interface ChannelFuture

    • sync

      public ChannelFuture sync() throws InterruptedException
      Description copied from interface: ChannelFuture
      Waits for this future until it is done, and rethrows the cause of the failure if this future failed. If the cause of the failure is a checked exception, it is wrapped with a new ChannelException before being thrown.
      Specified by:
      sync in interface ChannelFuture
      Throws:
      InterruptedException

    • syncUninterruptibly

      public ChannelFuture syncUninterruptibly()
      Description copied from interface: ChannelFuture
      Waits for this future until it is done, and rethrows the cause of the failure if this future failed. If the cause of the failure is a checked exception, it is wrapped with a new ChannelException before being thrown.
      Specified by:
      syncUninterruptibly in interface ChannelFuture

    • rethrowIfFailed0

      private void rethrowIfFailed0()

    • await

      public ChannelFuture await() throws InterruptedException
      Description copied from interface: ChannelFuture
      Waits for this future to be completed.
      Specified by:
      await in interface ChannelFuture
      Throws:
      InterruptedException - if the current thread was interrupted

    • await

      public boolean await(long timeout, TimeUnit unit) throws InterruptedException
      Description copied from interface: ChannelFuture
      Waits for this future to be completed within the specified time limit.
      Specified by:
      await in interface ChannelFuture
      Returns:
      true if and only if the future was completed within the specified time limit
      Throws:
      InterruptedException - if the current thread was interrupted

    • await

      public boolean await(long timeoutMillis) throws InterruptedException
      Description copied from interface: ChannelFuture
      Waits for this future to be completed within the specified time limit.
      Specified by:
      await in interface ChannelFuture
      Returns:
      true if and only if the future was completed within the specified time limit
      Throws:
      InterruptedException - if the current thread was interrupted

    • awaitUninterruptibly

      public ChannelFuture awaitUninterruptibly()
      Description copied from interface: ChannelFuture
      Waits for this future to be completed without interruption. This method catches an InterruptedException and discards it silently.
      Specified by:
      awaitUninterruptibly in interface ChannelFuture

    • awaitUninterruptibly

      public boolean awaitUninterruptibly(long timeout, TimeUnit unit)
      Description copied from interface: ChannelFuture
      Waits for this future to be completed within the specified time limit without interruption. This method catches an InterruptedException and discards it silently.
      Specified by:
      awaitUninterruptibly in interface ChannelFuture
      Returns:
      true if and only if the future was completed within the specified time limit

    • awaitUninterruptibly

      public boolean awaitUninterruptibly(long timeoutMillis)
      Description copied from interface: ChannelFuture
      Waits for this future to be completed within the specified time limit without interruption. This method catches an InterruptedException and discards it silently.
      Specified by:
      awaitUninterruptibly in interface ChannelFuture
      Returns:
      true if and only if the future was completed within the specified time limit

    • await0

      private boolean await0(long timeoutNanos, boolean interruptable) throws InterruptedException
      Throws:
      InterruptedException

    • checkDeadLock

      private static void checkDeadLock()

    • setSuccess

      public boolean setSuccess()
      Description copied from interface: ChannelFuture
      Marks this future as a success and notifies all listeners.
      Specified by:
      setSuccess in interface ChannelFuture
      Returns:
      true if and only if successfully marked this future as a success. Otherwise false because this future is already marked as either a success or a failure.

    • setFailure

      public boolean setFailure(Throwable cause)
      Description copied from interface: ChannelFuture
      Marks this future as a failure and notifies all listeners.
      Specified by:
      setFailure in interface ChannelFuture
      Returns:
      true if and only if successfully marked this future as a failure. Otherwise false because this future is already marked as either a success or a failure.

    • cancel

      public boolean cancel()
      Description copied from interface: ChannelFuture
      Cancels the I/O operation associated with this future and notifies all listeners if canceled successfully.
      Specified by:
      cancel in interface ChannelFuture
      Returns:
      true if and only if the operation has been canceled. false if the operation can't be canceled or is already completed.

    • notifyListeners

      private void notifyListeners()

    • notifyListener

      private void notifyListener(ChannelFutureListener l)

    • setProgress

      public boolean setProgress(long amount, long current, long total)
      Description copied from interface: ChannelFuture
      Notifies the progress of the operation to the listeners that implements ChannelFutureProgressListener. Please note that this method will not do anything and return false if this future is complete already.
      Specified by:
      setProgress in interface ChannelFuture
      Returns:
      true if and only if notification was made.

    • notifyProgressListener

      private void notifyProgressListener(ChannelFutureProgressListener l, long amount, long current, long total)