Класс 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() Создаёт новый |
protected abstract SSLEngine |
engineCreateSSLEngine(String host,
int port) Создаёт |
protected abstract SSLSessionContext |
engineGetClientSessionContext() Возвращает объект клиентского |
protected SSLParameters |
engineGetDefaultSSLParameters() Возвращает копию SSLParameters, указывающую параметры по умолчанию для этого контекста SSL. |
protected abstract SSLSessionContext |
engineGetServerSessionContext() Возвращает объект серверного |
protected abstract SSLServerSocketFactory |
engineGetServerSocketFactory() Возвращает объект |
protected abstract SSLSocketFactory |
engineGetSocketFactory() Возвращает объект |
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 - Исключения:
-
IllegalStateException- если SSLContextImpl требует инициализации, и методengineInit()не был вызван - См. также:
SSLContext.getSocketFactory()
engineGetServerSocketFactory
protected abstract SSLServerSocketFactory engineGetServerSocketFactory()
Возвращает объект ServerSocketFactory для этого контекста.
- Возвращает:
- объект
ServerSocketFactory - Исключения:
-
IllegalStateException- если SSLContextImpl требует инициализации, и методengineInit()не был вызван - См. также:
SSLContext.getServerSocketFactory()
engineCreateSSLEngine
protected abstract SSLEngine engineCreateSSLEngine()
Создаёт новый SSLEngine с использованием этого контекста.
Приложения, использующие этот фабричный метод, не предоставляют подсказок для внутренней стратегии повторного использования сеанса. Если подсказки необходимы, следует использовать engineCreateSSLEngine(String, int).
Некоторые наборы шифров (например, Kerberos) требуют информации о удалённом имени хоста, в этом случае этот фабричный метод не следует использовать.
- Возвращает:
- объект
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 всегда будут иметь ненулевые значения.
Реализация по умолчанию получает параметры из SSLSocket, созданного вызовом метода SocketFactory.createSocket() SocketFactory этого контекста.
- Возвращает:
- копию объекта SSLParameters с максимальными поддерживаемыми параметрами
- Исключения:
-
UnsupportedOperationException- если поддерживаемые параметры SSL получить не удалось. - Since:
- 1.6
© 1993, 2020, 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.