Класс SSLContextSpi

java.lang.Object

javax.net.ssl.SSLContextSpi

public abstract class SSLContextSpi extends Object

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

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

Since:

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)`	Инициализирует этот контекст.

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

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

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

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. Реализация поставщика SunJSSE JDK использует по умолчанию режим сервера. Однако рекомендуется всегда явно задавать необходимый режим, вызвав 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.

Массивы ciphersuite и protocols в параметрах всегда будут иметь значения не равные null.

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

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

engineGetSupportedSSLParameters

protected SSLParameters engineGetSupportedSSLParameters()

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

Массивы ciphersuite и protocols в параметрах всегда будут иметь значения не равные null.

Возвращает:: копию объекта 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/net/ssl/SSLContextSpi.html