View Javadoc
1   /*
2    * Copyright 2012 The Netty Project
3    *
4    * The Netty Project licenses this file to you under the Apache License,
5    * version 2.0 (the "License"); you may not use this file except in compliance
6    * with the License. You may obtain a copy of the License at:
7    *
8    *   https://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
12   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
13   * License for the specific language governing permissions and limitations
14   * under the License.
15   */
16  package io.netty.channel;
17  
18  import io.netty.util.internal.ThrowableUtil;
19  import io.netty.util.internal.UnstableApi;
20  
21  /**
22   * A {@link RuntimeException} which is thrown when an I/O operation fails.
23   */
24  public class ChannelException extends RuntimeException {
25  
26      private static final long serialVersionUID = 2908618315971075004L;
27  
28      /**
29       * Creates a new exception.
30       */
31      public ChannelException() {
32      }
33  
34      /**
35       * Creates a new exception.
36       */
37      public ChannelException(String message, Throwable cause) {
38          super(message, cause);
39      }
40  
41      /**
42       * Creates a new exception.
43       */
44      public ChannelException(String message) {
45          super(message);
46      }
47  
48      /**
49       * Creates a new exception.
50       */
51      public ChannelException(Throwable cause) {
52          super(cause);
53      }
54  
55      protected ChannelException(String message, Throwable cause, boolean shared) {
56          super(message, cause, false, true);
57          assert shared;
58      }
59  
60      static ChannelException newStatic(String message, Class<?> clazz, String method) {
61          ChannelException exception = new StacklessChannelException(message, null, true);
62          return ThrowableUtil.unknownStackTrace(exception, clazz, method);
63      }
64  
65      private static final class StacklessChannelException extends ChannelException {
66          private static final long serialVersionUID = -6384642137753538579L;
67  
68          StacklessChannelException(String message, Throwable cause, boolean shared) {
69              super(message, cause, shared);
70          }
71  
72          // Override fillInStackTrace() so we not populate the backtrace via a native call and so leak the
73          // Classloader.
74  
75          @Override
76          public Throwable fillInStackTrace() {
77              return this;
78          }
79      }
80  }