io.netty.handler.ssl

Enum ApplicationProtocolConfig.SelectorFailureBehavior

java.lang.Object

java.lang.Enum<ApplicationProtocolConfig.SelectorFailureBehavior>

io.netty.handler.ssl.ApplicationProtocolConfig.SelectorFailureBehavior

All Implemented Interfaces:

Serializable, Comparable<ApplicationProtocolConfig.SelectorFailureBehavior>

Enclosing class:

ApplicationProtocolConfig

public static enum ApplicationProtocolConfig.SelectorFailureBehavior
extends Enum<ApplicationProtocolConfig.SelectorFailureBehavior>

Defines the most common behaviors for the peer that selects the application protocol.

Enum Constant Summary

Enum Constants

Enum Constant and Description
CHOOSE_MY_LAST_PROTOCOL If the peer who selects the application protocol doesn't find a match it will just select the last protocol it advertised support for.
FATAL_ALERT If the peer who selects the application protocol doesn't find a match this will result in the failing the handshake with a fatal alert.
NO_ADVERTISE If the peer who selects the application protocol doesn't find a match it will pretend no to support the TLS extension by not advertising support for the TLS extension in the handshake.

Method Summary

Modifier and Type	Method and Description
static ApplicationProtocolConfig.SelectorFailureBehavior	valueOf(String name) Returns the enum constant of this type with the specified name.
static ApplicationProtocolConfig.SelectorFailureBehavior[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

FATAL_ALERT

public static final ApplicationProtocolConfig.SelectorFailureBehavior FATAL_ALERT

If the peer who selects the application protocol doesn't find a match this will result in the failing the handshake with a fatal alert.

For example in the case of ALPN this will result in a no_application_protocol(120) alert.

NO_ADVERTISE

public static final ApplicationProtocolConfig.SelectorFailureBehavior NO_ADVERTISE

If the peer who selects the application protocol doesn't find a match it will pretend no to support the TLS extension by not advertising support for the TLS extension in the handshake. This is used in cases where a "best effort" is desired to talk even if there is no matching protocol.

CHOOSE_MY_LAST_PROTOCOL

public static final ApplicationProtocolConfig.SelectorFailureBehavior CHOOSE_MY_LAST_PROTOCOL

If the peer who selects the application protocol doesn't find a match it will just select the last protocol it advertised support for. This is used in cases where a "best effort" is desired to talk even if there is no matching protocol, and the assumption is the "most general" fallback protocol is typically listed last.

This may be illegal for some RFCs but was observed behavior by some SSL implementations, and is supported for flexibility/compatibility.

Method Detail

values

public static ApplicationProtocolConfig.SelectorFailureBehavior[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (ApplicationProtocolConfig.SelectorFailureBehavior c : ApplicationProtocolConfig.SelectorFailureBehavior.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static ApplicationProtocolConfig.SelectorFailureBehavior valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null