Класс 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.

Since:: 1.6

Краткое описание конструкторов

HttpsServer()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static HttpsServer`	`create()`	Создаёт экземпляр `HttpsServer`, который первоначально не привязан к какому-либо локальному адресу/порту.
`static HttpsServer`	`create(InetSocketAddress addr, int backlog)`	Создаёт экземпляр `HttpsServer`, который будет привязан к указанному `InetSocketAddress` (IP-адрес и номер порта).
`static HttpsServer`	`create(InetSocketAddress addr, int backlog, String path, HttpHandler handler, Filter... filters)`	Создаёт экземпляр `HttpsServer` с начальным контекстом.
`abstract HttpsConfigurator`	`getHttpsConfigurator()`	Получает объект `HttpsConfigurator` этого сервера, если он был установлен.
`abstract void`	`setHttpsConfigurator(HttpsConfigurator config)`	Устанавливает объект `HttpsConfigurator` этого сервера.

Методы, объявленные в классе com.sun.net.httpserver.HttpServer

bind, createContext, createContext, getAddress, getExecutor, removeContext, removeContext, setExecutor, start, stop

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

HttpsServer

protected HttpsServer()

Конструктор для вызова подклассами.

Подробное описание методов

create

public static HttpsServer create() throws IOException

Создаёт экземпляр HttpsServer, который первоначально не привязан к какому-либо локальному адресу/порту. HttpsServer берётся из текущего установленного HttpServerProvider. Сервер должен быть привязан с помощью HttpServer.bind(InetSocketAddress,int) перед использованием. Сервер также должен иметь установленный HttpsConfigurator с помощью setHttpsConfigurator(HttpsConfigurator).

Возвращает:: экземпляр HttpsServer
Выбрасывает:: IOException - если произошла ошибка ввода-вывода

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 - если произошла ошибка ввода-вывода

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.

Сервер должен иметь установленный HttpsConfigurator с помощью setHttpsConfigurator(HttpsConfigurator).

Параметры:: addr - адрес для прослушивания, если null, то bind должен быть вызван для установки адреса; backlog - количество элементов в очереди сокета. Если значение меньше или равно нулю, то используется системное значение по умолчанию; path - путь корневого URI контекста, должен быть абсолютным; handler - HttpHandler для контекста; filters - фильтры для контекста, необязательно
Возвращает:: объект HttpsServer
Выбрасывает:: BindException - если сервер не может привязаться к адресу; IOException - если произошла ошибка ввода-вывода; IllegalArgumentException - если путь недопустим; NullPointerException - если любой из: path, handler, filters или любой элемент filters, является null
Since:: 18

setHttpsConfigurator

public abstract void setHttpsConfigurator(HttpsConfigurator config)

Устанавливает объект HttpsConfigurator этого сервера.

Параметры:: config - устанавливаемый объект HttpsConfigurator
Выбрасывает:: NullPointerException - если config является null

getHttpsConfigurator

public abstract HttpsConfigurator getHttpsConfigurator()

Получает объект HttpsConfigurator этого сервера, если он был установлен.

Возвращает:: объект HttpsConfigurator для этого сервера или null, если не установлен

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.httpserver/com/sun/net/httpserver/HttpsServer.html