模块 jdk.httpserver
包 com.sun.net.httpserver

类 HttpsServer

java.lang.Object
com.sun.net.httpserver.HttpServer
com.sun.net.httpserver.HttpsServer
public abstract class HttpsServer extends HttpServer
此类是 HttpServer 的扩展，它提供对 HTTPS 的支持。

HttpsServer 必须具有关联的 HttpsConfigurator 对象，用于为 SSL 连接建立 SSL 配置。

所有其他配置与 HttpServer 相同。

自从：
1.6

  • 构造方法详细信息

    • HttpsServer

      protected HttpsServer()
      子类调用的构造方法。

  • 方法详情

    • create

      public static HttpsServer  create() throws IOException
      创建一个最初未绑定到任何本地地址/端口的HttpsServer实例。 HttpsServer 是从当前安装的 HttpServerProvider 获取的。服务必须使用HttpServer.bind(InetSocketAddress,int) 绑定后才能使用。服务还必须有一个 HttpsConfigurator 与 setHttpsConfigurator(HttpsConfigurator) 建立。
      返回：
      HttpsServer 的实例
      抛出：
      IOException - 如果发生 I/O 错误

    • create

      public static HttpsServer  create(InetSocketAddress  addr, int backlog) throws IOException
      创建一个 HttpsServer 实例，它将绑定到指定的 InetSocketAddress （IP 地址和端口号）。还可以指定最大积压。这是监听套接字上允许的最大排队传入连接数。排队的 TCP 连接超过此限制可能会被 TCP 实现拒绝。 HttpsServer 是从当前安装的 HttpServerProvider 获取的。服务必须有一个 HttpsConfigurator 与 setHttpsConfigurator(HttpsConfigurator) 建立。
      参数：
      addr - 要监听的地址，如果是 null 则必须调用 HttpServer.bind(InetSocketAddress,int) 来设置地址
      backlog - 套接字积压。如果此值小于或等于零，则使用系统默认值。
      返回：
      HttpsServer 的实例
      抛出：
      BindException - 如果服务无法绑定到请求的地址，或者服务已经绑定
      IOException - 如果发生 I/O 错误

    • create

      public static HttpsServer  create(InetSocketAddress  addr, int backlog, String  path, HttpHandler  handler, Filter ... filters) throws IOException
      创建一个带有初始上下文的 HttpsServer 实例。

      服务是用一个创建的初始上下文将 URI path 映射到交换 handler 。初始上下文是通过调用 createContext(path) 创建的。 filters（如果有的话）按照给定的顺序添加到初始上下文中。返回的服务未启动，因此可以根据需要进一步配置。

      服务实例将绑定到给定的 InetSocketAddress 。

      还可以指定最大积压。这是监听套接字上允许的最大排队传入连接数。排队的 TCP 连接超过此限制可能会被 TCP 实现拒绝。 HttpsServer 是从当前安装的 HttpServerProvider 获取的。

      服务必须具有使用 setHttpsConfigurator(HttpsConfigurator) 建立的 HttpsConfigurator。

      参数：
      addr - 要监听的地址，如果是 null 则必须调用 bind 来设置地址
      backlog - 套接字积压。如果此值小于或等于零，则使用系统默认值
      path - 上下文的根 URI 路径，必须是绝对的
      handler - 上下文的 HttpHandler
      filters - 上下文过滤器，可选
      返回：
      HTTPS服务
      抛出：
      BindException - 如果服务无法绑定到地址
      IOException - 如果发生 I/O 错误
      IllegalArgumentException - 如果路径无效
      NullPointerException - 如果以下任何一项：path、handler、filters 或 filters 的任何元素是 null
      自从：
      18

    • setHttpsConfigurator

      public abstract void setHttpsConfigurator(HttpsConfigurator  config)
      设置此服务的 HttpsConfigurator 对象。
      参数：
      config - 要设置的 HttpsConfigurator
      抛出：
      NullPointerException - 如果配置是 null

    • getHttpsConfigurator

      public abstract HttpsConfigurator  getHttpsConfigurator()
      获取此服务的 HttpsConfigurator 对象（如果已设置）。
      返回：
      此服务的 HttpsConfigurator，如果未设置则为 null