Класс 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 - если конфигурация null

getHttpsConfigurator

public abstract HttpsConfigurator getHttpsConfigurator()

Возвращает объект HttpsConfigurator этого сервера, если он был задан.

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

© 1993, 2023, 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/21/docs/api/jdk.httpserver/com/sun/net/httpserver/HttpsServer.html