查看本类的 API文档回源码主页

   /*
    * Copyright 2012 The Netty Project
    *
    * The Netty Project licenses this file to you under the Apache License,
    * version 2.0 (the "License"); you may not use this file except in compliance
    * with the License. You may obtain a copy of the License at:
    *
    *   http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
   * License for the specific language governing permissions and limitations
   * under the License.
   */
  package io.netty.channel;
  
  import io.netty.util.concurrent.AbstractFuture;
  import io.netty.util.concurrent.Future;
  import io.netty.util.concurrent.GenericFutureListener;
  
  import java.util.concurrent.TimeUnit;
  
  final class VoidChannelPromise extends AbstractFuture<Void> implements ChannelPromise {
  
      private final Channel channel;
      private final boolean fireException;
  
      /**
       * Creates a new instance.
       *
       * @param channel the {@link Channel} associated with this future
       */
      VoidChannelPromise(Channel channel, boolean fireException) {
          if (channel == null) {
              throw new NullPointerException("channel");
          }
          this.channel = channel;
          this.fireException = fireException;
      }
  
      @Override
      public VoidChannelPromise addListener(GenericFutureListener<? extends Future<? super Void>> listener) {
          fail();
          return this;
      }
  
      @Override
      public VoidChannelPromise addListeners(GenericFutureListener<? extends Future<? super Void>>... listeners) {
          fail();
          return this;
      }
  
      @Override
      public VoidChannelPromise removeListener(GenericFutureListener<? extends Future<? super Void>> listener) {
          // NOOP
          return this;
      }
  
      @Override
      public VoidChannelPromise removeListeners(GenericFutureListener<? extends Future<? super Void>>... listeners) {
          // NOOP
          return this;
      }
  
      @Override
      public VoidChannelPromise await() throws InterruptedException {
          if (Thread.interrupted()) {
              throw new InterruptedException();
          }
          return this;
      }
  
      @Override
      public boolean await(long timeout, TimeUnit unit) {
          fail();
          return false;
      }
  
      @Override
      public boolean await(long timeoutMillis) {
          fail();
          return false;
      }
  
      @Override
      public VoidChannelPromise awaitUninterruptibly() {
          fail();
          return this;
      }
  
      @Override
      public boolean awaitUninterruptibly(long timeout, TimeUnit unit) {
          fail();
          return false;
      }
  
      @Override
      public boolean awaitUninterruptibly(long timeoutMillis) {
         fail();
         return false;
     }
 
     @Override
     public Channel channel() {
         return channel;
     }
 
     @Override
     public boolean isDone() {
         return false;
     }
 
     @Override
     public boolean isSuccess() {
         return false;
     }
 
     @Override
     public boolean setUncancellable() {
         return true;
     }
 
     @Override
     public boolean isCancellable() {
         return false;
     }
 
     @Override
     public boolean isCancelled() {
         return false;
     }
 
     @Override
     public Throwable cause() {
         return null;
     }
 
     @Override
     public VoidChannelPromise sync() {
         fail();
         return this;
     }
 
     @Override
     public VoidChannelPromise syncUninterruptibly() {
         fail();
         return this;
     }
     @Override
     public VoidChannelPromise setFailure(Throwable cause) {
         fireException(cause);
         return this;
     }
 
     @Override
     public VoidChannelPromise setSuccess() {
         return this;
     }
 
     @Override
     public boolean tryFailure(Throwable cause) {
         fireException(cause);
         return false;
     }
 
     /**
      * {@inheritDoc}
      *
      * @param mayInterruptIfRunning this value has no effect in this implementation.
      */
     @Override
     public boolean cancel(boolean mayInterruptIfRunning) {
         return false;
     }
 
     @Override
     public boolean trySuccess() {
         return false;
     }
 
     private static void fail() {
         throw new IllegalStateException("void future");
     }
 
     @Override
     public VoidChannelPromise setSuccess(Void result) {
         return this;
     }
 
     @Override
     public boolean trySuccess(Void result) {
         return false;
     }
 
     @Override
     public Void getNow() {
         return null;
     }
 
     private void fireException(Throwable cause) {
         // Only fire the exception if the channel is open and registered
         // if not the pipeline is not setup and so it would hit the tail
         // of the pipeline.
         // See https://github.com/netty/netty/issues/1517
         if (fireException && channel.isRegistered()) {
             channel.pipeline().fireExceptionCaught(cause);
         }
     }
 }