Module java.base
Package 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
参见:

  • Constructor Summary

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

  • Method Summary

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

    Methods declared in class java.lang.Object

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

  • Constructor Details

    • SNIMatcher

      protected SNIMatcher(int type)
      使用指定的服务器名称类型创建一个SNIMatcher。
      参数:
      type - 此匹配器执行匹配操作的服务器名称类型
      抛出:
      IllegalArgumentException - 如果type不在0到255的范围内（包括0和255）

  • Method Details

    • getType

      public final int getType()
      返回此SNIMatcher对象的服务器名称类型。
      返回:
      此SNIMatcher对象的服务器名称类型。
      参见:

    • matches

      public abstract boolean matches(SNIServerName serverName)
      尝试匹配给定的SNIServerName。
      参数:
      serverName - 此匹配器执行匹配操作的SNIServerName实例
      返回:
      如果匹配器匹配给定的serverName，则返回true
      抛出:
      NullPointerException - 如果serverName为null
      IllegalArgumentException - 如果serverName不是此匹配器给定的服务器名称类型
      参见: