Класс SSLContextSpi

java.lang.Object

javax.net.ssl.SSLContextSpi

public abstract class SSLContextSpi extends Object

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

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

Since:

1.4

См. также:

SSLContext

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

Конструктор	Описание
`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 - если операция завершилась неудачно

См. также:

SSLContext.init(KeyManager [], TrustManager [], SecureRandom)

engineGetSocketFactory

protected abstract SSLSocketFactory engineGetSocketFactory()

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

Возвращает:

объект SocketFactory

Исключения:

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

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

См. также:

SSLContext.getSocketFactory()

engineGetServerSocketFactory

protected abstract SSLServerSocketFactory engineGetServerSocketFactory()

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

Возвращает:

объект ServerSocketFactory

Исключения:

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

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

См. также:

SSLContext.getServerSocketFactory()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine()

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

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

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

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

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

Возвращает:

объект SSLEngine

Исключения:

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

Since:

1.5

См. также:

SSLContext.createSSLEngine()

engineCreateSSLEngine

protected abstract SSLEngine engineCreateSSLEngine(String host, int port)

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

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

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

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

Параметры:

host - неофициальное имя хоста

port - неофициальная порт

Возвращает:

объект SSLEngine

Исключения:

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

Since:

1.5

См. также:

SSLContext.createSSLEngine(String, int)

engineGetServerSessionContext

protected abstract SSLSessionContext engineGetServerSessionContext()

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

Возвращает:

объект SSLSessionContext

См. также:

SSLContext.getServerSessionContext()

engineGetClientSessionContext

protected abstract SSLSessionContext engineGetClientSessionContext()

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

Возвращает:

объект SSLSessionContext

См. также:

SSLContext.getClientSessionContext()

engineGetDefaultSSLParameters

protected SSLParameters engineGetDefaultSSLParameters()

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

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

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

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

engineGetSupportedSSLParameters

protected SSLParameters engineGetSupportedSSLParameters()

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

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

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

© 1993, 2021, 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/17/docs/api/java.base/javax/net/ssl/SSLContextSpi.html