1 /* 2 * Copyright 2017 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.UnstableApi; 19 20 /** 21 * Event that is fired once we did a selection of a {@link SslContext} based on the {@code SNI hostname}, 22 * which may be because it was successful or there was an error. 23 */ 24 @UnstableApi 25 public final class SniCompletionEvent extends SslCompletionEvent { 26 private final String hostname; 27 28 public SniCompletionEvent(String hostname) { 29 this.hostname = hostname; 30 } 31 32 public SniCompletionEvent(String hostname, Throwable cause) { 33 super(cause); 34 this.hostname = hostname; 35 } 36 37 public SniCompletionEvent(Throwable cause) { 38 this(null, cause); 39 } 40 41 /** 42 * Returns the SNI hostname send by the client if we were able to parse it, {@code null} otherwise. 43 */ 44 public String hostname() { 45 return hostname; 46 } 47 48 @Override 49 public String toString() { 50 final Throwable cause = cause(); 51 return cause == null ? getClass().getSimpleName() + "(SUCCESS='" + hostname + "'\")": 52 getClass().getSimpleName() + '(' + cause + ')'; 53 } 54 }