org.jboss.netty.channel

## Class FailedChannelFuture

- java.lang.Object
- - org.jboss.netty.channel.CompleteChannelFuture
  - - org.jboss.netty.channel.FailedChannelFuture

All Implemented Interfaces:
  ChannelFuture

    public class FailedChannelFuture
    extends CompleteChannelFuture

The `CompleteChannelFuture` which is failed already. It is recommended to use `Channels.failedFuture(Channel, Throwable)` instead of calling the constructor of this future.

### Constructor Summary

Constructors
Constructor and Description
`FailedChannelFuture(Channel channel, Throwable cause)` Creates a new instance.

### Method Summary

Methods
`Throwable` `getCause()` Returns the cause of the failed I/O operation if the I/O operation has failed.
`boolean` `isSuccess()` Returns `true` if and only if the I/O operation was completed successfully.
`ChannelFuture` `rethrowIfFailed()`
`ChannelFuture` `sync()` Waits for this future until it is done, and rethrows the cause of the failure if this future failed.
`ChannelFuture` `syncUninterruptibly()` Waits for this future until it is done, and rethrows the cause of the failure if this future failed.

### Methods inherited from class org.jboss.netty.channel.CompleteChannelFuture

`addListener, await, await, await, awaitUninterruptibly, awaitUninterruptibly, awaitUninterruptibly, cancel, getChannel, isCancelled, isDone, removeListener, setFailure, setProgress, setSuccess`

### Methods inherited from class java.lang.Object

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

### Constructor Detail

#### FailedChannelFuture

    public FailedChannelFuture(Channel channel,
                       Throwable cause)

Creates a new instance.

Parameters:
  `channel` - the `Channel` associated with this future
  `cause` - the cause of failure

### Method Detail

#### 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.

Returns:
  the cause of the failure. `null` if succeeded or this future is not completed yet.

#### isSuccess

    public boolean isSuccess()

Description copied from interface: `ChannelFuture`
Returns `true` if and only if the I/O operation was completed successfully.

#### rethrowIfFailed

    public ChannelFuture rethrowIfFailed()
                                  throws Exception

Throws:
  `Exception`

#### 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.

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.