1 /*
2 * Copyright 2023 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.handler.ssl;
17
18 import io.netty.util.internal.ThrowableUtil;
19
20 import javax.net.ssl.SSLHandshakeException;
21
22 /**
23 * A {@link SSLHandshakeException} that does not fill in the stack trace.
24 */
25 final class StacklessSSLHandshakeException extends SSLHandshakeException {
26
27 private static final long serialVersionUID = -1244781947804415549L;
28
29 private StacklessSSLHandshakeException(String reason) {
30 super(reason);
31 }
32
33 @Override
34 public Throwable fillInStackTrace() {
35 // This is a performance optimization to not fill in the
36 // stack trace as this is a stackless exception.
37 return this;
38 }
39
40 /**
41 * Creates a new {@link StacklessSSLHandshakeException} which has the origin of the given {@link Class} and method.
42 */
43 static StacklessSSLHandshakeException newInstance(String reason, Class<?> clazz, String method) {
44 return ThrowableUtil.unknownStackTrace(new StacklessSSLHandshakeException(reason), clazz, method);
45 }
46 }