Module java.base

软件包 javax.net.ssl

Class SNIMatcher

java.lang.Object

javax.net.ssl.SNIMatcher

public abstract class SNIMatcher
extends Object

此类的实例表示在SNIServerName实例上执行匹配操作的匹配器。

服务器可以使用服务器名称指示（SNI）信息来确定特定的SSLSocket或SSLEngine实例是否应该接受连接。 例如，当多个“虚拟”或“基于名称”的服务器托管在单个底层网络地址上时，服务器应用程序可以使用SNI信息来确定该服务器是否是客户端要访问的确切服务器。 服务器可以使用此类的实例来验证特定类型的可接受的服务器名称，例如主机名。

SNIMatcher对象是不可变的。 子类不能提供可以在创建实例后更改实例状态的方法。

从以下版本开始：

1.8

另请参见：

SNIServerName ， SNIHostName ， SSLParameters.getSNIMatchers() ， SSLParameters.setSNIMatchers(Collection)

构造方法摘要

构造方法

Modifier	Constructor	描述
protected	SNIMatcher(int type)	使用指定的服务器名称类型创建一个 SNIMatcher 。

方法摘要

Modifier and Type	方法	描述
int	getType()	返回此 SNIMatcher对象的服务器名称类型。
abstract boolean	matches(SNIServerName serverName)	尝试匹配给定的SNIServerName 。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

SNIMatcher

protected SNIMatcher(int type)

使用指定的服务器名称类型创建 SNIMatcher 。

参数

type - 该匹配器执行的服务器名称的类型

异常

IllegalArgumentException - 如果 type不在0到255（含）范围内。

方法详细信息

getType

public final int getType()

返回此 SNIMatcher对象的服务器名称类型。

结果

这个 SNIMatcher对象的服务器名称类型。

另请参见：

SNIServerName

matches

public abstract boolean matches(SNIServerName serverName)

尝试匹配给定的SNIServerName 。

参数

serverName - 该匹配器执行匹配操作的SNIServerName实例

结果

true如果，并且只有匹配器匹配给定的 serverName

异常

NullPointerException - 如果 serverName是 null

IllegalArgumentException - 如果 serverName不是此匹配器的给定服务器名称类型

另请参见：

SNIServerName