Класс HttpsParameters

java.lang.Object

com.sun.net.httpserver.HttpsParameters

public abstract class HttpsParameters extends Object

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

Базовые параметры SSL можно задать с помощью методов set/get этого класса либо с помощью объекта 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`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарел и будет удалён: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка времени.

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

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.