Future (Netty API Reference (4.1.22.Final))

All Superinterfaces:

java.util.concurrent.Future <V>

All Known Subinterfaces:

ChannelFuture ， ChannelGroupFuture ， ChannelProgressiveFuture ， ChannelProgressivePromise ， ChannelPromise ， ProgressiveFuture <V>， ProgressivePromise <V>， Promise <V>， ScheduledFuture <V>

所有已知实现类：

DefaultChannelProgressivePromise ， DefaultChannelPromise ， DefaultProgressivePromise ， DefaultPromise ， DelegatingChannelPromiseNotifier ， VoidChannelPromise
```
public interface Future<V>
extends java.util.concurrent.Future<V>
```
异步操作的结果。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`Future<V>`	`addListener(GenericFutureListener<? extends Future<? super V>> listener)` 将指定的侦听器添加到此将来。
`Future<V>`	`addListeners(GenericFutureListener<? extends Future<? super V>>... listeners)` 将指定的侦听器添加到此将来。
`Future<V>`	`await()` 等待这个未来的完成。
`boolean`	`await(long timeoutMillis)` 等待这个未来在规定的时限内完成。
`boolean`	`await(long timeout, java.util.concurrent.TimeUnit unit)` 等待这个未来在规定的时限内完成。
`Future<V>`	`awaitUninterruptibly()` 等待这个未来不中断地完成。
`boolean`	`awaitUninterruptibly(long timeoutMillis)` 等待这个未来在规定的时间内完成而不会中断。
`boolean`	`awaitUninterruptibly(long timeout, java.util.concurrent.TimeUnit unit)` 等待这个未来在规定的时间内完成而不会中断。
`boolean`	`cancel(boolean mayInterruptIfRunning)` 如果取消成功，将会以 `CancellationException`失败。
`java.lang.Throwable`	`cause()` 如果I / O操作失败，则返回失败的I / O操作的原因。
`V`	`getNow()` 无阻塞地返回结果。
`boolean`	`isCancellable()` 返回 `true`当且仅当该操作可通过取消 `cancel(boolean)` 。
`boolean`	`isSuccess()` 当且仅当I / O操作成功完成时返回 `true` 。
`Future<V>`	`removeListener(GenericFutureListener<? extends Future<? super V>> listener)` 从此将来删除指定侦听器的第一个匹配项。
`Future<V>`	`removeListeners(GenericFutureListener<? extends Future<? super V>>... listeners)` 为将来的每个听众删除第一个匹配项。
`Future<V>`	`sync()` 等待这个未来，直到完成，并且在这个未来失败的时候重新引发失败的原因。
`Future<V>`	`syncUninterruptibly()` 等待这个未来，直到完成，并且在这个未来失败的时候重新引发失败的原因。

Methods inherited from interface java.util.concurrent.Future
get, get, isCancelled, isDone

- 方法详细信息
  - isSuccess
```
boolean isSuccess()
```
    当且仅当I / O操作成功完成时返回 true 。
  - isCancellable
```
boolean isCancellable()
```
    返回 true当且仅当该操作可通过取消 cancel(boolean) 。
  - cause
```
java.lang.Throwable cause()
```
    如果I / O操作失败，则返回失败的I / O操作的原因。
    
    结果
    
    失败的原因。 null如果成功或未来尚未完成。
  - addListener
```
Future<V> addListener(GenericFutureListener<? extends Future<? super V>> listener)
```
    将指定的侦听器添加到此将来。当这个未来完成时，通知指定的监听器。如果这个未来已经完成，立即通知指定的监听器。
  - addListeners
```
Future<V> addListeners(GenericFutureListener<? extends Future<? super V>>... listeners)
```
    将指定的侦听器添加到此将来。这个未来完成时，通知指定的监听者。如果这个未来已经完成，则立即通知指定的监听者。
  - removeListener
```
Future<V> removeListener(GenericFutureListener<? extends Future<? super V>> listener)
```
    从此将来删除指定侦听器的第一个匹配项。未来完成时，指定的监听器不再通知。如果指定的侦听器未与此将来关联，则此方法不执行任何操作并以静默方式返回。
  - removeListeners
```
Future<V> removeListeners(GenericFutureListener<? extends Future<? super V>>... listeners)
```
    为将来的每个听众删除第一个匹配项。未来完成时，指定的监听器不再通知。如果指定的侦听器未与此将来关联，则此方法不执行任何操作并以静默方式返回。
  - sync
```
Future<V> sync()
        throws java.lang.InterruptedException
```
    等待这个未来，直到完成，并且在这个未来失败的时候重新引发失败的原因。
    
    异常
    
    java.lang.InterruptedException
  - syncUninterruptibly
```
Future<V> syncUninterruptibly()
```
    等待这个未来，直到完成，并且在这个未来失败的时候重新引发失败的原因。
  - await
```
Future<V> await()
         throws java.lang.InterruptedException
```
    等待这个未来的完成。
    
    异常
    
    java.lang.InterruptedException - 如果当前线程中断
  - awaitUninterruptibly
```
Future<V> awaitUninterruptibly()
```
    等待这个未来不中断地完成。此方法捕获InterruptedException并以静默方式丢弃它。
  - await
```
boolean await(long timeout,
              java.util.concurrent.TimeUnit unit)
       throws java.lang.InterruptedException
```
    等待这个未来在规定的时限内完成。
    
    结果
    
    true当且仅当未来是在规定的期限内完成
    
    异常
    
    java.lang.InterruptedException - 如果当前线程中断
  - await
```
boolean await(long timeoutMillis)
       throws java.lang.InterruptedException
```
    等待这个未来在规定的时限内完成。
    
    结果
    
    true当且仅当未来是在规定的期限内完成
    
    异常
    
    java.lang.InterruptedException - 如果当前线程中断
  - awaitUninterruptibly
```
boolean awaitUninterruptibly(long timeout,
                             java.util.concurrent.TimeUnit unit)
```
    等待这个未来在规定的时间内完成而不会中断。该方法捕获InterruptedException ，并以静默方式丢弃它。
    
    结果
    
    true当且仅当未来在规定的时限内完成
  - awaitUninterruptibly
```
boolean awaitUninterruptibly(long timeoutMillis)
```
    等待这个未来在规定的时间内完成而不会中断。此方法捕获InterruptedException并以静默方式丢弃它。
    
    结果
    
    true当且仅当未来在规定的时限内完成
  - getNow
```
V getNow()
```
    无阻塞地返回结果。如果未来还没有完成，这将返回null 。由于null值可能用于标记未来成功，因此您还需要检查未来是否真的用Future.isDone()完成，而不是在返回的null值上进行中继。
  - cancel
```
boolean cancel(boolean mayInterruptIfRunning)
```
    如果取消成功，将会以 CancellationException未来失败。
    
    Specified by:
    
    cancel在界面 java.util.concurrent.Future<V>

Interface Future<V>

方法摘要

Methods inherited from interface java.util.concurrent.Future

方法详细信息

isSuccess

isCancellable

cause

addListener

addListeners

removeListener

removeListeners

sync

syncUninterruptibly

await

awaitUninterruptibly

await

await

awaitUninterruptibly

awaitUninterruptibly

getNow

cancel