Класс HttpsParameters

java.lang.Object

com.sun.net.httpserver.HttpsParameters

public abstract class HttpsParameters extends Object

Представляет набор параметров для каждого установленного HTTPS-соединения с клиентами. Один из таких объектов создаётся и передаётся в HttpsConfigurator.configure(HttpsParameters) для каждого входящего HTTPS-соединения, чтобы определить используемые параметры.

Подлежащие параметры SSL могут быть установлены либо методами этого класса, либо через объект SSLParameters. SSLParameters является предпочтительным методом, поскольку в будущем в этом классе могут быть добавлены дополнительные возможности конфигурации, и проще определить набор поддерживаемых параметров и их значения по умолчанию с помощью SSLParameters. Также, если объект SSLParameters предоставлен через setSSLParameters(SSLParameters), то используются эти настройки параметров, а любые настройки в этом объекте игнорируются.

С:: 1.6

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

HttpsParameters()

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

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

Модификатор и тип	Метод	Описание
`String[]`	`getCipherSuites()`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`abstract InetSocketAddress`	`getClientAddress()`	Возвращает адрес удалённого клиента, инициирующего подключение.
`abstract HttpsConfigurator`	`getHttpsConfigurator()`	Возвращает `HttpsConfigurator` для этого `HttpsParameters`.
`boolean`	`getNeedClientAuth()`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`String[]`	`getProtocols()`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`boolean`	`getWantClientAuth()`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`void`	`setCipherSuites(String[] cipherSuites)`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`void`	`setNeedClientAuth(boolean needClientAuth)`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`void`	`setProtocols(String[] protocols)`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.
`abstract void`	`setSSLParameters(SSLParameters params)`	Устанавливает `SSLParameters` для использования с этим `HttpsParameters`.
`void`	`setWantClientAuth(boolean wantClientAuth)`	Устарело. Рекомендуется настраивать и читать параметры SSL через использование `SSLParameters`.

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

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

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

HttpsParameters

protected HttpsParameters()

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

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

getHttpsConfigurator

public abstract HttpsConfigurator getHttpsConfigurator()

Возвращает HttpsConfigurator для этого HttpsParameters.

Возвращает:: HttpsConfigurator для этого экземпляра HttpsParameters

getClientAddress

public abstract InetSocketAddress getClientAddress()

Возвращает адрес удалённого клиента, инициирующего соединение.

Возвращает:: адрес удалённого клиента, инициирующего соединение

setSSLParameters

public abstract void setSSLParameters(SSLParameters params)

Устанавливает SSLParameters для использования с этим HttpsParameters. Параметры должны поддерживаться SSLContext, содержащимся в HttpsConfigurator, связанным с этим HttpsParameters. Если параметры не заданы, используется поведение по умолчанию с параметрами по умолчанию из связанного SSLContext.

Параметры:: params - устанавливаемые SSLParameters. Если null, существующие параметры (если таковые имеются) остаются неизменными
Исключения:: IllegalArgumentException - если какие-либо параметры неверны или не поддерживаются

getCipherSuites

@Deprecated(since="23") public String[] getCipherSuites()

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters.

Возвращает копию массива наборов шифров или null, если они не были заданы.

Возвращает:: копию массива наборов шифров или null, если они не были заданы

setCipherSuites

@Deprecated(since="23") public void setCipherSuites(String[] cipherSuites)

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters. Используйте SSLParameters.setCipherSuites(String[]) вместо этого.

Устанавливает массив наборов шифров.

Параметры:: cipherSuites - массив наборов шифров (или null)

getProtocols

@Deprecated(since="23") public String[] getProtocols()

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters.

Возвращает копию массива протоколов или null, если они не были заданы.

Возвращает:: копию массива протоколов или null, если они не были заданы

setProtocols

@Deprecated(since="23") public void setProtocols(String[] protocols)

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters. Используйте SSLParameters.setProtocols(String[]) вместо этого.

Устанавливает массив протоколов.

Параметры:: protocols - массив протоколов (или null)

getWantClientAuth

@Deprecated(since="23") public boolean getWantClientAuth()

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters.

Возвращает, требуется ли запросить аутентификацию клиента.

Возвращает:: требуется ли запросить аутентификацию клиента

setWantClientAuth

@Deprecated(since="23") public void setWantClientAuth(boolean wantClientAuth)

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters. Используйте SSLParameters.setWantClientAuth(boolean) вместо этого.

Устанавливает, требуется ли запросить аутентификацию клиента. Вызов этого метода сбрасывает флаг needClientAuth.

Параметры:: wantClientAuth - требуется ли запросить аутентификацию клиента

getNeedClientAuth

@Deprecated(since="23") public boolean getNeedClientAuth()

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters.

Возвращает, требуется ли обязательная аутентификация клиента.

Возвращает:: требуется ли обязательная аутентификация клиента

setNeedClientAuth

@Deprecated(since="23") public void setNeedClientAuth(boolean needClientAuth)

Устаревший.

Рекомендуется настраивать и читать параметры SSL с помощью SSLParameters. Используйте SSLParameters.setNeedClientAuth(boolean) вместо этого.

Устанавливает, требуется ли обязательная аутентификация клиента. Вызов этого метода сбрасывает флаг wantClientAuth.

Параметры:: needClientAuth - требуется ли обязательная аутентификация клиента

© 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/HttpsParameters.html