在Netty中的所有的I/O操作都是异步执行的,这就意味着任何一个I/O操作会立刻返回,不保证在调用结束的时候操作会执行完成。因此,会返回一个ChannelFuture的实例,通过这个实例可以获取当前I/O操作的状态。
ChannelFuture为完成或未完成状态。完成和未完成可对应的各种I/O操作结果如下所示
* + ---------------------------+
* | Completed successfully |
* + ---------------------------+
* + ----> isDone() = <b>true </b> |
* +--------------------------+ | | isSuccess() = <b>true</b> |
* | Uncompleted | | +===========================+
* +--------------------------+ | | Completed with failure |
* | isDone() = <b>false</b> | | +--------------------------- +
* | isSuccess() = false | ----+----> isDone() = <b>true </b> |
* | isCancelled() = false | | | getCause() = <b>non- null</b> |
* | getCause() = null | | +===========================+
* +--------------------------+ | | Completed by cancellation |
* | + ---------------------------+
* + ----> isDone() = <b>true </b> |
* | isCancelled() = <b>true</b> |
* + ---------------------------+
通过ChannelFuture可以了解I/O操作的一些额外的详细信息。
当然,也提供了阻塞当前线程等待I/O执行结果的方法,就是awaitUninterruptibly 。
与这个接口紧密相关的是ChannelFutureListener,为特定的事项添加监听器。当事件发生时,会出发监听器指定相应的动作。
最后一点要指出调用await系列方法指定的等待超时时间和I/O超时时间之间是没有特定关系的。如果没有设置I/O超时时间,那么可能在await方法超时之后,future方法其实是没有执行完的。