模块 java.base

软件包 javax.net.ssl

Class SNIMatcher

java.lang.Object

javax.net.ssl.SNIMatcher

public abstract class SNIMatcherextends Object

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

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

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

从以下版本开始：

1.8

另请参见：

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

构造方法摘要

构造方法

变量	构造器	描述
protected	SNIMatcher(int type)	使用指定的服务器名称类型创建 SNIMatcher 。

方法摘要

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

声明方法的类 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（包括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