在Netty使用ChannelFuture和ChannelPromise进行异步操作的处理
这是官方给出的ChannelFutur描述
1 * | Completed successfully | 2 * +---------------------------+ 3 * +----> isDone() = true | 4 * +--------------------------+ | | isSuccess() = true | 5 * | Uncompleted | | +===========================+ 6 * +--------------------------+ | | Completed with failure | 7 * | isDone() = false | | +---------------------------+ 8 * | isSuccess() = false |----+----> isDone() = true | 9 * | isCancelled() = false | | | cause() = non-null | 10 * | cause() = null | | +===========================+ 11 * +--------------------------+ | | Completed by cancellation | 12 * | +---------------------------+ 13 * +----> isDone() = true | 14 * | isCancelled() = true | 15 * +---------------------------+
由图可以知道ChannelFutur有四种状态:Uncompleted、Completed successfully、Completed with failure、Completed by cancellation,这几种状态是由isDone、isSuccess、isCancelled、cause这四种方法的返回值决定的。
ChannelFutur接口的定义如下:
1 public interface ChannelFuture extends Future<Void> { 2 Channel channel(); 3 4 ChannelFuture addListener(GenericFutureListener<? extends Future<? super Void>> var1); 5 6 ChannelFuture addListeners(GenericFutureListener... var1); 7 8 ChannelFuture removeListener(GenericFutureListener<? extends Future<? super Void>> var1); 9 10 ChannelFuture removeListeners(GenericFutureListener... var1); 11 12 ChannelFuture sync() throws InterruptedException; 13 14 ChannelFuture syncUninterruptibly(); 15 16 ChannelFuture await() throws InterruptedException; 17 18 ChannelFuture awaitUninterruptibly(); 19 20 boolean isVoid(); 21 }
继承自Netty的Future:
1 public interface Future<V> extends java.util.concurrent.Future<V> { 2 boolean isSuccess(); 3 4 boolean isCancellable(); 5 6 Throwable cause(); 7 8 Future<V> addListener(GenericFutureListener<? extends Future<? super V>> var1); 9 10 Future<V> addListeners(GenericFutureListener... var1); 11 12 Future<V> removeListener(GenericFutureListener<? extends Future<? super V>> var1); 13 14 Future<V> removeListeners(GenericFutureListener... var1); 15 16 Future<V> sync() throws InterruptedException; 17 18 Future<V> syncUninterruptibly(); 19 20 Future<V> await() throws InterruptedException; 21 22 Future<V> awaitUninterruptibly(); 23 24 boolean await(long var1, TimeUnit var3) throws InterruptedException; 25 26 boolean await(long var1) throws InterruptedException; 27 28 boolean awaitUninterruptibly(long var1, TimeUnit var3); 29 30 boolean awaitUninterruptibly(long var1); 31 32 V getNow(); 33 34 boolean cancel(boolean var1); 35 }
Netty的Future又继承自JDK的Future:
1 public interface Future<V> { 2 3 boolean cancel(boolean mayInterruptIfRunning); 4 5 boolean isCancelled(); 6 7 boolean isDone(); 8 9 V get() throws InterruptedException, ExecutionException; 10 11 V get(long timeout, TimeUnit unit) 12 throws InterruptedException, ExecutionException, TimeoutException; 13 }
ChannelPromise继承了ChannelFuture:
1 public interface ChannelPromise extends ChannelFuture, Promise<Void> { 2 Channel channel(); 3 4 ChannelPromise setSuccess(Void var1); 5 6 ChannelPromise setSuccess(); 7 8 boolean trySuccess(); 9 10 ChannelPromise setFailure(Throwable var1); 11 12 ChannelPromise addListener(GenericFutureListener<? extends Future<? super Void>> var1); 13 14 ChannelPromise addListeners(GenericFutureListener... var1); 15 16 ChannelPromise removeListener(GenericFutureListener<? extends Future<? super Void>> var1); 17 18 ChannelPromise removeListeners(GenericFutureListener... var1); 19 20 ChannelPromise sync() throws InterruptedException; 21 22 ChannelPromise syncUninterruptibly(); 23 24 ChannelPromise await() throws InterruptedException; 25 26 ChannelPromise awaitUninterruptibly(); 27 28 ChannelPromise unvoid(); 29 }
其中Promise接口定义如下:
1 public interface Promise<V> extends Future<V> { 2 Promise<V> setSuccess(V var1); 3 4 boolean trySuccess(V var1); 5 6 Promise<V> setFailure(Throwable var1); 7 8 boolean tryFailure(Throwable var1); 9 10 boolean setUncancellable(); 11 12 Promise<V> addListener(GenericFutureListener<? extends Future<? super V>> var1); 13 14 Promise<V> addListeners(GenericFutureListener... var1); 15 16 Promise<V> removeListener(GenericFutureListener<? extends Future<? super V>> var1); 17 18 Promise<V> removeListeners(GenericFutureListener... var1); 19 20 Promise<V> await() throws InterruptedException; 21 22 Promise<V> awaitUninterruptibly(); 23 24 Promise<V> sync() throws InterruptedException; 25 26 Promise<V> syncUninterruptibly(); 27 }
在Netty中,无论是服务端还是客户端,在Channel注册时都会为其绑定一个ChannelPromise,默认实现是DefaultChannelPromise
DefaultChannelPromise定义如下:
1 public class DefaultChannelPromise extends DefaultPromise<Void> implements ChannelPromise, FlushCheckpoint { 2 3 private final Channel channel; 4 private long checkpoint; 5 6 public DefaultChannelPromise(Channel channel) { 7 this.channel = checkNotNull(channel, "channel"); 8 } 9 10 public DefaultChannelPromise(Channel channel, EventExecutor executor) { 11 super(executor); 12 this.channel = checkNotNull(channel, "channel"); 13 } 14 15 @Override 16 protected EventExecutor executor() { 17 EventExecutor e = super.executor(); 18 if (e == null) { 19 return channel().eventLoop(); 20 } else { 21 return e; 22 } 23 } 24 25 @Override 26 public Channel channel() { 27 return channel; 28 } 29 30 @Override 31 public ChannelPromise setSuccess() { 32 return setSuccess(null); 33 } 34 35 @Override 36 public ChannelPromise setSuccess(Void result) { 37 super.setSuccess(result); 38 return this; 39 } 40 41 @Override 42 public boolean trySuccess() { 43 return trySuccess(null); 44 } 45 46 @Override 47 public ChannelPromise setFailure(Throwable cause) { 48 super.setFailure(cause); 49 return this; 50 } 51 52 @Override 53 public ChannelPromise addListener(GenericFutureListener<? extends Future<? super Void>> listener) { 54 super.addListener(listener); 55 return this; 56 } 57 58 @Override 59 public ChannelPromise addListeners(GenericFutureListener<? extends Future<? super Void>>... listeners) { 60 super.addListeners(listeners); 61 return this; 62 } 63 64 @Override 65 public ChannelPromise removeListener(GenericFutureListener<? extends Future<? super Void>> listener) { 66 super.removeListener(listener); 67 return this; 68 } 69 70 @Override 71 public ChannelPromise removeListeners(GenericFutureListener<? extends Future<? super Void>>... listeners) { 72 super.removeListeners(listeners); 73 return this; 74 } 75 76 @Override 77 public ChannelPromise sync() throws InterruptedException { 78 super.sync(); 79 return this; 80 } 81 82 @Override 83 public ChannelPromise syncUninterruptibly() { 84 super.syncUninterruptibly(); 85 return this; 86 } 87 88 @Override 89 public ChannelPromise await() throws InterruptedException { 90 super.await(); 91 return this; 92 } 93 94 @Override 95 public ChannelPromise awaitUninterruptibly() { 96 super.awaitUninterruptibly(); 97 return this; 98 } 99 100 @Override 101 public long flushCheckpoint() { 102 return checkpoint; 103 } 104 105 @Override 106 public void flushCheckpoint(long checkpoint) { 107 this.checkpoint = checkpoint; 108 } 109 110 @Override 111 public ChannelPromise promise() { 112 return this; 113 } 114 115 @Override 116 protected void checkDeadLock() { 117 if (channel().isRegistered()) { 118 super.checkDeadLock(); 119 } 120 } 121 122 @Override 123 public ChannelPromise unvoid() { 124 return this; 125 } 126 127 @Override 128 public boolean isVoid() { 129 return false; 130 } 131 }
可以看到这个DefaultChannelPromise仅仅是将Channel封装了,而且其基本上所有方法的实现都依赖于父类DefaultPromise
DefaultPromise中的实现是整个ChannelFuture和ChannelPromise的核心所在:
DefaultPromise中有如下几个状态量:
1 private static final int MAX_LISTENER_STACK_DEPTH = Math.min(8, 2 SystemPropertyUtil.getInt("io.netty.defaultPromise.maxListenerStackDepth", 8)); 3 private static final Object SUCCESS = new Object(); 4 private static final Object UNCANCELLABLE = new Object(); 5 private static final CauseHolder CANCELLATION_CAUSE_HOLDER = new CauseHolder(ThrowableUtil.unknownStackTrace( 6 new CancellationException(), DefaultPromise.class, "cancel(...)")); 7 private static final AtomicReferenceFieldUpdater<DefaultPromise, Object> RESULT_UPDATER = 8 AtomicReferenceFieldUpdater.newUpdater(DefaultPromise.class, Object.class, "result");
MAX_LISTENER_STACK_DEPTH: 表示最多可执行listeners的数量,默认是8
SUCCESS :表示异步操作正常完成
UNCANCELLABLE:表示异步操作不可取消,并且尚未完成
CANCELLATION_CAUSE_HOLDER:表示异步操作取消监听,用于cancel操作,
而CauseHolder 的实例对象是用来表示异步操作异常结束,同时保存异常信息:
1 private static final class CauseHolder { 2 final Throwable cause; 3 CauseHolder(Throwable cause) { 4 this.cause = cause; 5 } 6 }
RESULT_UPDATER:是一个原子更新器,通过CAS操作,原子化更新 DefaultPromise对象的名为result的成员,这个result成员是其异步操作判断的关键所在
DefaultPromise的成员及构造方法定义:
1 public class DefaultPromise<V> extends AbstractFuture<V> implements Promise<V> { 2 private volatile Object result; 3 private final EventExecutor executor; 4 private Object listeners; 5 private short waiters; 6 private boolean notifyingListeners; 7 8 public DefaultPromise(EventExecutor executor) { 9 this.executor = checkNotNull(executor, "executor"); 10 } 11 }
result:就是前面说的,判断异步操作状态的关键
result的取值有:SUCCESS 、UNCANCELLABLE、CauseHolder以及null (其实还可以是泛型V类型的任意对象,这里暂不考虑)
executor:就是Channel绑定的NioEventLoop,在我之前的博客说过,Channel的异步操作都是在NioEventLoop的线程中完成的([Netty中NioEventLoopGroup的创建源码分析](https://blog.csdn.net/Z_ChenChen/article/details/90567863))
listeners:通过一个Object保存所有对异步操作的监听,用于异步操作的回调
waiters:记录阻塞中的listeners的数量
notifyingListeners:是否需要唤醒的标志
首先来看isDone方法,通过之前的图可以知道,
isDone为false对应了Uncompleted状态,即异步操作尚未完成;
isDone为true则代表了异步操作完成,但是还是有三种完成情况,需要结合别的判断方法才能具体知道是哪种情况;
isDone方法:
1 @Override 2 public boolean isDone() { 3 return isDone0(result); 4 }
调用isDone0:
1 private static boolean isDone0(Object result) { 2 return result != null && result != UNCANCELLABLE; 3 }
有如下几种情况:
result等于null,result没有赋值,表示异步操作尚未完成(从这里就能想到异步操作完成,需要调用某个set方法来改变result的状态)
result是UNCANCELLABLE状态,表示执行中的异步操作不可取消,当然也就是异步操作尚未完成
result不等于null,且不等于UNCANCELLABLE,就表示异步操作完成(包括正常完成,以及异常结束,需要由cause方法进一步判断)
isSuccess方法:
1 @Override 2 public boolean isSuccess() { 3 Object result = this.result; 4 return result != null && result != UNCANCELLABLE && !(result instanceof CauseHolder); 5 }
由这里可以知道当且仅当result 为SUCCESS状态时,才返回true(其余除UNCANCELLABLE和null的值其实也可以,这里暂不考虑)
isCancelled方法:
1 @Override 2 public boolean isCancelled() { 3 return isCancelled0(result); 4 }
调用isCancelled0方法:
1 private static boolean isCancelled0(Object result) { 2 return result instanceof CauseHolder && ((CauseHolder) result).cause instanceof CancellationException; 3 }
只有当result是CancellationException的实例时,表示取消异步操作
接着来看cause方法:
1 @Override 2 public Throwable cause() { 3 Object result = this.result; 4 return (result instanceof CauseHolder) ? ((CauseHolder) result).cause : null; 5 }
和上面同理,通过判别resul是否是CauseHolder的实现类,若是,将CauseHolder保存的异常返回。
几种状态的判别说完了,下面看一下如何设置这几种状态的:
setSuccess方法:
1 @Override 2 public Promise<V> setSuccess(V result) { 3 if (setSuccess0(result)) { 4 notifyListeners(); 5 return this; 6 } 7 throw new IllegalStateException("complete already: " + this); 8 }
首先调用setSuccess0方法,其中result的泛型通过DefaultChannelPromise可知是Void,在DefaultChannelPromise中所有的set和try操作参数都是null,这里的result也就不去考虑:
1 private boolean setSuccess0(V result) { 2 return setValue0(result == null ? SUCCESS : result); 3 }
继续调用setValue0方法:
1 private boolean setValue0(Object objResult) { 2 if (RESULT_UPDATER.compareAndSet(this, null, objResult) || 3 RESULT_UPDATER.compareAndSet(this, UNCANCELLABLE, objResult)) { 4 checkNotifyWaiters(); 5 return true; 6 } 7 return false; 8 }
通过CAS操作,将result状态变为SUCCESS
其中checkNotifyWaiters方法:
1 private synchronized void checkNotifyWaiters() { 2 if (waiters > 0) { 3 notifyAll(); 4 } 5 }
检查waiters的个数,唤醒所有阻塞中的this,sync方法会引起阻塞
回到setSuccess方法中,setSuccess0通过CAS操作,将result状态更新为SUCCESS成功后,调用
notifyListeners方法,唤醒所有listener完成对异步操作的回调
listeners是通过addListener方法添加的,用来对异步操作进行侦听:
看到addListener方法:
1 @Override 2 public Promise<V> addListener(GenericFutureListener<? extends Future<? super V>> listener) { 3 checkNotNull(listener, "listener"); 4 5 synchronized (this) { 6 addListener0(listener); 7 } 8 9 if (isDone()) { 10 notifyListeners(); 11 } 12 13 return this; 14 } 15 16 @Override 17 public Promise<V> addListeners(GenericFutureListener<? extends Future<? super V>>... listeners) { 18 checkNotNull(listeners, "listeners"); 19 20 synchronized (this) { 21 for (GenericFutureListener<? extends Future<? super V>> listener : listeners) { 22 if (listener == null) { 23 break; 24 } 25 addListener0(listener); 26 } 27 } 28 29 if (isDone()) { 30 notifyListeners(); 31 } 32 33 return this; 34 }
其中GenericFutureListener接口定义如下:
1 public interface GenericFutureListener<F extends Future<?>> extends EventListener { 2 /** 3 * Invoked when the operation associated with the {@link Future} has been completed. 4 * 5 * @param future the source {@link Future} which called this callback 6 */ 7 void operationComplete(F future) throws Exception; 8 }
可以看到listener其实就是通过operationComplete方法,来完成回调,对Future对象进行处理,由注释可知operationComplete方法是在future操作完成时调用
addListeners方法的实现比较简单,实现核心是在addListener0中:
1 private void addListener0(GenericFutureListener<? extends Future<? super V>> listener) { 2 if (listeners == null) { 3 listeners = listener; 4 } else if (listeners instanceof DefaultFutureListeners) { 5 ((DefaultFutureListeners) listeners).add(listener); 6 } else { 7 listeners = new DefaultFutureListeners((GenericFutureListener<?>) listeners, listener); 8 } 9 }
其中DefaultFutureListeners是将GenericFutureListener对象封装的一个数组:
1 final class DefaultFutureListeners { 2 3 private GenericFutureListener<? extends Future<?>>[] listeners; 4 private int size; 5 private int progressiveSize; 6 7 @SuppressWarnings("unchecked") 8 DefaultFutureListeners( 9 GenericFutureListener<? extends Future<?>> first, GenericFutureListener<? extends Future<?>> second) { 10 listeners = new GenericFutureListener[2]; 11 listeners[0] = first; 12 listeners[1] = second; 13 size = 2; 14 if (first instanceof GenericProgressiveFutureListener) { 15 progressiveSize ++; 16 } 17 if (second instanceof GenericProgressiveFutureListener) { 18 progressiveSize ++; 19 } 20 } 21 22 public void add(GenericFutureListener<? extends Future<?>> l) { 23 GenericFutureListener<? extends Future<?>>[] listeners = this.listeners; 24 final int size = this.size; 25 if (size == listeners.length) { 26 this.listeners = listeners = Arrays.copyOf(listeners, size << 1); 27 } 28 listeners[size] = l; 29 this.size = size + 1; 30 31 if (l instanceof GenericProgressiveFutureListener) { 32 progressiveSize ++; 33 } 34 } 35 36 public void remove(GenericFutureListener<? extends Future<?>> l) { 37 final GenericFutureListener<? extends Future<?>>[] listeners = this.listeners; 38 int size = this.size; 39 for (int i = 0; i < size; i ++) { 40 if (listeners[i] == l) { 41 int listenersToMove = size - i - 1; 42 if (listenersToMove > 0) { 43 System.arraycopy(listeners, i + 1, listeners, i, listenersToMove); 44 } 45 listeners[-- size] = null; 46 this.size = size; 47 48 if (l instanceof GenericProgressiveFutureListener) { 49 progressiveSize --; 50 } 51 return; 52 } 53 } 54 } 55 56 public GenericFutureListener<? extends Future<?>>[] listeners() { 57 return listeners; 58 } 59 60 public int size() { 61 return size; 62 } 63 64 public int progressiveSize() { 65 return progressiveSize; 66 } 67 }
size:记录listeners的个数
progressiveSize:记录GenericProgressiveFutureListener类型的listeners的个数
DefaultFutureListeners 中对数组的操作比较简单,
add方法,当size达到数组长度时,进行二倍扩容,
其中GenericProgressiveFutureListener继承自GenericFutureListener:
1 public interface GenericProgressiveFutureListener<F extends ProgressiveFuture<?>> extends GenericFutureListener<F> { 2 /** 3 * Invoked when the operation has progressed. 4 * 5 * @param progress the progress of the operation so far (cumulative) 6 * @param total the number that signifies the end of the operation when {@code progress} reaches at it. 7 * {@code -1} if the end of operation is unknown. 8 */ 9 void operationProgressed(F future, long progress, long total) throws Exception; 10 }
由注释可知operationProgressed是在future操作进行时调用,这里不对GenericProgressiveFutureListener过多讨论
回到addListener0方法,由DefaultFutureListeners就可以知道,实际上通过DefaultFutureListeners管理的一维数组来保存listeners
在addListener方法完成对listener的添加后,还会调用isDone方法检查当前异步操作是否完成,若是完成需要调用notifyListeners,直接唤醒所有listeners完后对异步操作的回调
有add就有remove,removeListener方法:
1 @Override 2 public Promise<V> removeListener(final GenericFutureListener<? extends Future<? super V>> listener) { 3 checkNotNull(listener, "listener"); 4 5 synchronized (this) { 6 removeListener0(listener); 7 } 8 9 return this; 10 } 11 12 @Override 13 public Promise<V> removeListeners(final GenericFutureListener<? extends Future<? super V>>... listeners) { 14 checkNotNull(listeners, "listeners"); 15 16 synchronized (this) { 17 for (GenericFutureListener<? extends Future<? super V>> listener : listeners) { 18 if (listener == null) { 19 break; 20 } 21 removeListener0(listener); 22 } 23 } 24 25 return this; 26 }
还是由removeListener0来实现:
1 private void removeListener0(GenericFutureListener<? extends Future<? super V>> listener) { 2 if (listeners instanceof DefaultFutureListeners) { 3 ((DefaultFutureListeners) listeners).remove(listener); 4 } else if (listeners == listener) { 5 listeners = null; 6 } 7 }
看过之前的内容在看这里就比较简单了,通过DefaultFutureListeners去删除
notifyListeners方法:
1 private void notifyListeners() { 2 EventExecutor executor = executor(); 3 if (executor.inEventLoop()) { 4 final InternalThreadLocalMap threadLocals = InternalThreadLocalMap.get(); 5 final int stackDepth = threadLocals.futureListenerStackDepth(); 6 if (stackDepth < MAX_LISTENER_STACK_DEPTH) { 7 threadLocals.setFutureListenerStackDepth(stackDepth + 1); 8 try { 9 notifyListenersNow(); 10 } finally { 11 threadLocals.setFutureListenerStackDepth(stackDepth); 12 } 13 return; 14 } 15 } 16 17 safeExecute(executor, new Runnable() { 18 @Override 19 public void run() { 20 notifyListenersNow(); 21 } 22 }); 23 }
其中executor方法:
1 protected EventExecutor executor() { 2 return executor; 3 }
用来获取executor轮询线程对象
判断executor是否处于轮询,否则需要通过safeExecute方法处理listeners的侦听,
safeExecute方法:
1 private static void safeExecute(EventExecutor executor, Runnable task) { 2 try { 3 executor.execute(task); 4 } catch (Throwable t) { 5 rejectedExecutionLogger.error("Failed to submit a listener notification task. Event loop shut down?", t); 6 } 7 }
这里保证了listeners的侦听回调是异步执行
InternalThreadLocalMap在我之前的博客中说过,是Netty使用的ThreadLocal (Netty中FastThreadLocal源码分析)
去线程本地变量中找futureListenerStackDepth(默认为0),判断stackDepth是否小于MAX_LISTENER_STACK_DEPTH,否则也要通过safeExecute方法处理listeners的侦听
核心都是调用notifyListenersNow方法:
1 private void notifyListenersNow() { 2 Object listeners; 3 synchronized (this) { 4 // Only proceed if there are listeners to notify and we are not already notifying listeners. 5 if (notifyingListeners || this.listeners == null) { 6 return; 7 } 8 notifyingListeners = true; 9 listeners = this.listeners; 10 this.listeners = null; 11 } 12 for (;;) { 13 if (listeners instanceof DefaultFutureListeners) { 14 notifyListeners0((DefaultFutureListeners) listeners); 15 } else { 16 notifyListener0(this, (GenericFutureListener<?>) listeners); 17 } 18 synchronized (this) { 19 if (this.listeners == null) { 20 // Nothing can throw from within this method, so setting notifyingListeners back to false does not 21 // need to be in a finally block. 22 notifyingListeners = false; 23 return; 24 } 25 listeners = this.listeners; 26 this.listeners = null; 27 } 28 } 29 }
先检查是否需要监听,满足条件后,判断listeners是否是DefaultFutureListeners,即包装后的数组
notifyListeners0方法:
1 private void notifyListeners0(DefaultFutureListeners listeners) { 2 GenericFutureListener<?>[] a = listeners.listeners(); 3 int size = listeners.size(); 4 for (int i = 0; i < size; i ++) { 5 notifyListener0(this, a[i]); 6 } 7 }
遍历这个数组,实则调用notifyListener0方法:
1 private static void notifyListener0(Future future, GenericFutureListener l) { 2 try { 3 l.operationComplete(future); 4 } catch (Throwable t) { 5 if (logger.isWarnEnabled()) { 6 logger.warn("An exception was thrown by " + l.getClass().getName() + ".operationComplete()", t); 7 } 8 } 9 }
这里就可以看到,完成了对operationComplete的回调,处理future
setSuccess结束,再来看trySuccess方法:
1 @Override 2 public boolean trySuccess(V result) { 3 if (setSuccess0(result)) { 4 notifyListeners(); 5 return true; 6 } 7 return false; 8 }
对比setSuccess来看,只有返回值不一样
setFailure方法:
1 @Override 2 public Promise<V> setFailure(Throwable cause) { 3 if (setFailure0(cause)) { 4 notifyListeners(); 5 return this; 6 } 7 throw new IllegalStateException("complete already: " + this, cause); 8 } 9 10 private boolean setFailure0(Throwable cause) { 11 return setValue0(new CauseHolder(checkNotNull(cause, "cause"))); 12 } 13 14 private boolean setValue0(Object objResult) { 15 if (RESULT_UPDATER.compareAndSet(this, null, objResult) || 16 RESULT_UPDATER.compareAndSet(this, UNCANCELLABLE, objResult)) { 17 checkNotifyWaiters(); 18 return true; 19 } 20 return false; 21 }
和setSuccess逻辑一样,只不过CAS操作将状态变为了CauseHolder对象,成功后唤醒listeners对异步操作的回调
tryFailure方法:
1 @Override 2 public boolean tryFailure(Throwable cause) { 3 if (setFailure0(cause)) { 4 notifyListeners(); 5 return true; 6 } 7 return false; 8 }
也都是一个逻辑
还有一个setUncancellable方法:
1 @Override 2 public boolean setUncancellable() { 3 if (RESULT_UPDATER.compareAndSet(this, null, UNCANCELLABLE)) { 4 return true; 5 } 6 Object result = this.result; 7 return !isDone0(result) || !isCancelled0(result); 8 }
若是result状态为null,异步操作尚未结束,直接通过CAS操作将状态变为UNCANCELLABLE
否则若是根据状态来判断
下来看到cancel方法:
1 /** 2 * {@inheritDoc} 3 * 4 * @param mayInterruptIfRunning this value has no effect in this implementation. 5 */ 6 @Override 7 public boolean cancel(boolean mayInterruptIfRunning) { 8 if (RESULT_UPDATER.compareAndSet(this, null, CANCELLATION_CAUSE_HOLDER)) { 9 checkNotifyWaiters(); 10 notifyListeners(); 11 return true; 12 } 13 return false; 14 }
mayInterruptIfRunning正如注释中所说,在这里没有什么作用
还是通过CAS操作,将状态变为CANCELLATION_CAUSE_HOLDER,调用checkNotifyWaiters唤醒因sync阻塞的线程,notifyListeners方法回调listeners的侦听
最后看到sync方法:
1 @Override 2 public Promise<V> sync() throws InterruptedException { 3 await(); 4 rethrowIfFailed(); 5 return this; 6 }
先调用await方法:
1 @Override 2 public Promise<V> await() throws InterruptedException { 3 if (isDone()) { 4 return this; 5 } 6 7 if (Thread.interrupted()) { 8 throw new InterruptedException(toString()); 9 } 10 11 checkDeadLock(); 12 13 synchronized (this) { 14 while (!isDone()) { 15 incWaiters(); 16 try { 17 wait(); 18 } finally { 19 decWaiters(); 20 } 21 } 22 } 23 return this; 24 }
先判断能否执行(异步操作尚未结束,当前线程没有被中断),然后调用checkDeadLock方法:
1 protected void checkDeadLock() { 2 EventExecutor e = executor(); 3 if (e != null && e.inEventLoop()) { 4 throw new BlockingOperationException(toString()); 5 } 6 }
检查轮询线程是否在工作
在synchronized块中以自身为锁,自旋等待异步操作的完成,若是没完成,调用incWaiters方法:
1 private void incWaiters() { 2 if (waiters == Short.MAX_VALUE) { 3 throw new IllegalStateException("too many waiters: " + this); 4 } 5 ++waiters; 6 }
在小于Short.MAX_VALUE的情况下,对waiters自增,
然后使用wait将自身阻塞,等待被唤醒
所以在之前setValue0时,checkNotifyWaiters操作会notifyAll,
由此可以知道sync方法的作用:在某一线程中调用sync方法会使得当前线程被阻塞,只有当异步操作执完毕,通过上面的set方法改变状态后,才会调用checkNotifyWaiters方法唤醒当前线程。
当从阻塞中被唤醒后调用decWaiters方法:
1 private void decWaiters() { 2 --waiters; 3 }
使得waiters自减
通过这样一种自旋方式,一直等到isDone成立,结束自旋,进而结束await方法,然后调用rethrowIfFailed方法:
1 private void rethrowIfFailed() { 2 Throwable cause = cause(); 3 if (cause == null) { 4 return; 5 } 6 7 PlatformDependent.throwException(cause); 8 }
根据异步操作是否有异常,进而使用PlatformDependent抛出异常。
至此Netty中的ChannelFuture和ChannelPromise分析到此全部结束。