Класс 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-соединений.

Вся остальная конфигурация аналогична HttpServer.

Начиная с версии:: 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` этого сервера.

Методы, объявленные в классе HttpServer

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

Методы, объявленные в классе 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
Начиная с версии:: 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://docs.oracle.com/en/java/javase/25/docs/api/jdk.httpserver/com/sun/net/httpserver/HttpsServer.html