Класс 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), то используются эти параметры, а любые настройки в этом объекте игнорируются.

Since:: 1.6

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

HttpsParameters()

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

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

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

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

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

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

HttpsParameters

protected HttpsParameters()

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

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

getHttpsConfigurator

public abstract HttpsConfigurator getHttpsConfigurator()

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

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

getClientAddress

public abstract InetSocketAddress getClientAddress()

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

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

setSSLParameters

public abstract void setSSLParameters(SSLParameters params)

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

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

getCipherSuites

public String[] getCipherSuites()

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

Returns:: копия массива наборов шифрования или null если не задано ни одного

setCipherSuites

public void setCipherSuites(String[] cipherSuites)

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

Parameters:: cipherSuites - массив наборов шифрования (или null)

getProtocols

public String[] getProtocols()

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

Returns:: копия массива протоколов или null если не задано ни одного

setProtocols

public void setProtocols(String[] protocols)

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

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

getWantClientAuth

public boolean getWantClientAuth()

Возвращает, должна ли быть запрошена аутентификация клиента.

Returns:: должна ли быть запрошена аутентификация клиента

setWantClientAuth

public void setWantClientAuth(boolean wantClientAuth)

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

Parameters:: wantClientAuth - должна ли быть запрошена аутентификация клиента

getNeedClientAuth

public boolean getNeedClientAuth()

Возвращает, должна ли быть необходима аутентификация клиента.

Returns:: должна ли быть необходима аутентификация клиента

setNeedClientAuth

public void setNeedClientAuth(boolean needClientAuth)

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

Parameters:: needClientAuth - должна ли быть необходима аутентификация клиента

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