Класс SSLContextSpi

java.lang.Object

javax.net.ssl.SSLContextSpi

public abstract class SSLContextSpi extends Object

Этот класс определяет интерфейс поставщика службы (SPI) для класса SSLContext.

Все абстрактные методы этого класса должны быть реализованы каждым поставщиком криптографических служб, который желает предоставить реализацию определённого SSL-контекста.

Начиная с:

1.4

См. также:

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

Конструктор	Описание
`SSLContextSpi()`	Конструктор для вызова из подклассов.

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

Модификатор и тип	Метод	Описание
`protected abstract SSLEngine`	`engineCreateSSLEngine()`	Создаёт новый `SSLEngine` с использованием этого контекста.
`protected abstract SSLEngine`	`engineCreateSSLEngine(String host, int port)`	Создаёт `SSLEngine` с использованием этого контекста.
`protected abstract SSLSessionContext`	`engineGetClientSessionContext()`	Возвращает объект клиентского `SSLSessionContext` для этого контекста.
`protected SSLParameters`	`engineGetDefaultSSLParameters()`	Возвращает копию SSLParameters, указывающую настройки по умолчанию для этого SSL-контекста.
`protected abstract SSLSessionContext`	`engineGetServerSessionContext()`	Возвращает объект серверного `SSLSessionContext` для этого контекста.
`protected abstract SSLServerSocketFactory`	`engineGetServerSocketFactory()`	Возвращает объект `ServerSocketFactory` для этого контекста.
`protected abstract SSLSocketFactory`	`engineGetSocketFactory()`	Возвращает объект `SocketFactory` для этого контекста.
`protected SSLParameters`	`engineGetSupportedSSLParameters()`	Возвращает копию SSLParameters, указывающую максимально допустимые настройки для этого SSL-контекста.
`protected abstract void`	`engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr)`	Инициализирует этот контекст.

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

SSLContextSpi

public SSLContextSpi()

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

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

engineInit

protected abstract void engineInit(KeyManager[] km, TrustManager[] tm, SecureRandom sr) throws KeyManagementException

Инициализирует этот контекст.

Параметры:

km — источники ключей аутентификации

tm — источники решений о доверии при аутентификации узла-партнёра

sr — источник случайных данных

Выбрасывает:

KeyManagementException — если эта операция завершается с ошибкой

См. также:

engineGetSocketFactory

protected abstract SSLSocketFactory engineGetSocketFactory()

Возвращает объект SocketFactory для этого контекста.

Возвращает:

объект SocketFactory

Выбрасывает:

UnsupportedOperationException — если базовый поставщик не реализует эту операцию.

IllegalStateException — если SSLContextImpl требует инициализации, а engineInit() не был вызван

См. также:

engineGetServerSocketFactory

protected abstract SSLServerSocketFactory engineGetServerSocketFactory()

Возвращает объект ServerSocketFactory для этого контекста.

Возвращает:

объект ServerSocketFactory

Выбрасывает:

UnsupportedOperationException — если базовый поставщик не реализует эту операцию.

IllegalStateException — если SSLContextImpl требует инициализации, а engineInit() не был вызван

См. также:

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine()

Создаёт новый SSLEngine с использованием этого контекста.

Приложения, использующие этот фабричный метод, не предоставляют подсказок для внутренней стратегии повторного использования сеансов. Если нужны такие подсказки, следует использовать engineCreateSSLEngine(String, int).

Для некоторых наборов шифров (например, Kerberos) требуется информация об удалённом имени узла; в этом случае не следует использовать этот фабричный метод.

Примечание по реализации:

Зависит от поставщика, будет ли возвращённый SSLEngine по умолчанию использовать клиентский или серверный режим для соединения (D)TLS. Реализация поставщика JDK SunJSSE по умолчанию использует серверный режим. Однако рекомендуется всегда явно задавать нужный режим, вызывая SSLEngine.setUseClientMode() перед вызовом других методов SSLEngine.

Возвращает:

объект SSLEngine

Выбрасывает:

IllegalStateException — если SSLContextImpl требует инициализации, а engineInit() не был вызван

Начиная с:

1.5

См. также:

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine(String host, int port)

Создаёт SSLEngine с использованием этого контекста.

Приложения, использующие этот фабричный метод, предоставляют подсказки для внутренней стратегии повторного использования сеансов.

Для некоторых наборов шифров (например, Kerberos) требуется информация об удалённом имени узла; в этом случае необходимо указать peerHost.

Примечание по реализации:

Параметры:

host — неавторитетное имя узла

port — неавторитетный номер порта

Возвращает:

объект SSLEngine

Выбрасывает:

IllegalStateException — если SSLContextImpl требует инициализации, а engineInit() не был вызван

Начиная с:

1.5

См. также:

engineGetServerSessionContext

protected abstract SSLSessionContext engineGetServerSessionContext()

Возвращает объект серверного SSLSessionContext для этого контекста.

Возвращает:

объект SSLSessionContext

См. также:

engineGetClientSessionContext

protected abstract SSLSessionContext engineGetClientSessionContext()

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

Возвращает:

объект SSLSessionContext

См. также:

engineGetDefaultSSLParameters

protected SSLParameters engineGetDefaultSSLParameters()

Возвращает копию SSLParameters, указывающую настройки по умолчанию для этого SSL-контекста.

Массивы наборов шифров и протоколов в параметрах всегда имеют ненулевые значения.

Реализация по умолчанию получает параметры из SSLSocket, созданного вызовом метода SocketFactory.createSocket() фабрики SocketFactory этого контекста.

Возвращает:: копию объекта SSLParameters с настройками по умолчанию
Выбрасывает:: UnsupportedOperationException — если не удалось получить параметры SSL по умолчанию.
Начиная с:: 1.6

engineGetSupportedSSLParameters

protected SSLParameters engineGetSupportedSSLParameters()

Возвращает копию SSLParameters, указывающую максимально поддерживаемые настройки для этого SSL-контекста.

Массивы наборов шифров и протоколов в параметрах всегда имеют ненулевые значения.

Возвращает:: копию объекта SSLParameters с максимально поддерживаемыми настройками
Выбрасывает:: UnsupportedOperationException — если не удалось получить поддерживаемые параметры SSL.
Начиная с:: 1.6

© 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.