Spec-Zone .ru
спецификации, руководства, описания, API
|
public class SSLContext extends Object
SSLEngine
s. Этот class инициализируется с дополнительной группой ключевых и доверительных менеджеров и источником безопасных случайных байтов. Каждая реализация платформы Java обязана поддерживать следующий стандарт SSLContext
протокол:
Модификатор | Конструктор и Описание |
---|---|
protected |
SSLContext(SSLContextSpi contextSpi, Provider provider, String protocol)
Создает объект SSLContext.
|
Модификатор и Тип | Метод и Описание |
---|---|
SSLEngine |
createSSLEngine()
Создает новое
SSLEngine использование этого контекста. |
SSLEngine |
createSSLEngine(String peerHost, int peerPort)
Создает новое
SSLEngine использование этого контекста, используя консультацию взаимодействует с информацией. |
SSLSessionContext |
getClientSessionContext()
Возвращает клиентский контекст сеанса, который представляет набор сеансов SSL, доступных для использования во время фазы квитирования клиентских сокетов SSL.
|
static SSLContext |
getDefault()
Возвращает контекст SSL значения по умолчанию.
|
SSLParameters |
getDefaultSSLParameters()
Возвращает копию SSLParameters указание на настройки по умолчанию для этого контекста SSL.
|
static SSLContext |
getInstance(String protocol)
Возвраты a
SSLContext возразите, что реализует указанный протокол защищенного сокета. |
static SSLContext |
getInstance(String protocol, Provider provider)
Возвраты a
SSLContext возразите, что реализует указанный протокол защищенного сокета. |
static SSLContext |
getInstance(String protocol, String provider)
Возвраты a
SSLContext возразите, что реализует указанный протокол защищенного сокета. |
Строка |
getProtocol()
Возвращает имя протокола этого
SSLContext объект. |
Провайдер |
getProvider()
Возвращает провайдера этого
SSLContext объект. |
SSLSessionContext |
getServerSessionContext()
Возвращает контекст сеанса сервера, который представляет набор сеансов SSL, доступных для использования во время фазы квитирования серверных сокетов SSL.
|
SSLServerSocketFactory |
getServerSocketFactory()
Возвраты a
ServerSocketFactory объект для этого контекста. |
SSLSocketFactory |
getSocketFactory()
Возвраты a
SocketFactory объект для этого контекста. |
SSLParameters |
getSupportedSSLParameters()
Возвращает копию SSLParameters указание на поддерживаемые настройки для этого контекста SSL.
|
void |
init(KeyManager[] km, TrustManager[] tm, SecureRandom random)
Инициализирует этот контекст.
|
static void |
setDefault(SSLContext context)
Устанавливает контекст SSL значения по умолчанию.
|
protected SSLContext(SSLContextSpi contextSpi, Provider provider, String protocol)
contextSpi
- делегатprovider
- провайдерprotocol
- протоколpublic static SSLContext getDefault() throws NoSuchAlgorithmException
Если контекст значения по умолчанию был установлен, используя SSLContext.setDefault()
метод, это возвращается. Иначе, первый вызов этого метода инициировал вызов SSLContext.getInstance("Default")
. В случае успеха тот объект делается контекстом SSL значения по умолчанию и возвращается.
Контекст значения по умолчанию сразу применим и не требует инициализации.
NoSuchAlgorithmException
- если SSLContext.getInstance()
вызовите сбоиpublic static void setDefault(SSLContext context)
getDefault()
. Контекст значения по умолчанию должен быть сразу применимым и не потребовать инициализации.context
- SSLContextNullPointerException
- если контекст является нулемSecurityException
- если менеджер безопасности существует и checkPermission
метод не позволяет SSLPermission("setDefaultSSLContext")
public static SSLContext getInstance(String protocol) throws NoSuchAlgorithmException
SSLContext
возразите, что реализует указанный протокол защищенного сокета. Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект SSLContext инкапсуляция реализации SSLContextSpi от первого Провайдера, который поддерживает указанный протокол.
Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders()
метод.
protocol
- стандартное имя требуемого протокола. См. раздел SSLContext в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах протокола.SSLContext
объект.NoSuchAlgorithmException
- если никакой Провайдер не поддерживает реализацию SSLContextSpi для указанного протокола.NullPointerException
- если протокол является нулем.Provider
public static SSLContext getInstance(String protocol, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
SSLContext
возразите, что реализует указанный протокол защищенного сокета. Возвращается новый объект SSLContext инкапсуляция реализации SSLContextSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.
Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders()
метод.
protocol
- стандартное имя требуемого протокола. См. раздел SSLContext в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах протокола.provider
- имя провайдера.SSLContext
объект.NoSuchAlgorithmException
- если реализация SSLContextSpi для указанного протокола не доступна от указанного провайдера.NoSuchProviderException
- если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.IllegalArgumentException
- если имя провайдера является нулем или пустой.NullPointerException
- если протокол является нулем.Provider
public static SSLContext getInstance(String protocol, Provider provider) throws NoSuchAlgorithmException
SSLContext
возразите, что реализует указанный протокол защищенного сокета. Возвращается новый объект SSLContext инкапсуляция реализации SSLContextSpi от указанного объекта Провайдера. Отметьте, что указанный объект Провайдера не должен быть зарегистрирован в списке провайдера.
protocol
- стандартное имя требуемого протокола. См. раздел SSLContext в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах протокола.provider
- экземпляр провайдера.SSLContext
объект.NoSuchAlgorithmException
- если реализация SSLContextSpi для указанного протокола не доступна от указанного объекта Провайдера.IllegalArgumentException
- если провайдер является нулем.NullPointerException
- если протокол является нулем.Provider
public final String getProtocol()
SSLContext
объект. Это - то же самое имя, которое было определено в одном из getInstance
вызовы, которые создали это SSLContext
объект.
SSLContext
объект.public final Provider getProvider()
SSLContext
объект.SSLContext
объектpublic final void init(KeyManager[] km, TrustManager[] tm, SecureRandom random) throws KeyManagementException
Только первая инстанция определенной ключевой и/или доверительной реализации менеджера вводит массив, используется. (Например, только первый javax.net.ssl. X509KeyManager в массиве будет использоваться.)
km
- источники ключей аутентификации или нуляtm
- источники равноправной аутентификации доверяют решениям или нулюrandom
- источник случайности для этого генератора или нуляKeyManagementException
- если эта работа перестала работатьpublic final SSLSocketFactory getSocketFactory()
SocketFactory
объект для этого контекста.SocketFactory
объектIllegalStateException
- если SSLContextImpl требует инициализации и init()
не был вызванpublic final SSLServerSocketFactory getServerSocketFactory()
ServerSocketFactory
объект для этого контекста.ServerSocketFactory
объектIllegalStateException
- если SSLContextImpl требует инициализации и init()
не был вызванpublic final SSLEngine createSSLEngine()
SSLEngine
использование этого контекста. Приложения используя этот метод фабрики не обеспечивают подсказок для внутренней стратегии повторного использования сеанса. Если подсказки требуются, createSSLEngine(String, int)
должен использоваться вместо этого.
Некоторые комплекты шифра (такие как Kerberos) запрашивают удаленную информацию имени узла, когда этот метод фабрики не должен использоваться.
SSLEngine
объектUnsupportedOperationException
- если базовый провайдер не реализует работу.IllegalStateException
- если SSLContextImpl требует инициализации и init()
не был вызванpublic final SSLEngine createSSLEngine(String peerHost, int peerPort)
SSLEngine
использование этого контекста, используя консультацию взаимодействует с информацией. Приложения используя этот метод фабрики обеспечивают подсказки для внутренней стратегии повторного использования сеанса.
Некоторые комплекты шифра (такие как Kerberos) запрашивают удаленную информацию имени узла, когда peerHost должен быть определен.
peerHost
- неавторитетное имя узлаpeerPort
- неавторитетный портSSLEngine
объектUnsupportedOperationException
- если базовый провайдер не реализует работу.IllegalStateException
- если SSLContextImpl требует инициализации и init()
не был вызванpublic final SSLSessionContext getServerSessionContext()
Этот контекст может быть недоступным в некоторых средах, когда этот метод возвращает нуль. Например, когда базовый провайдер SSL не обеспечивает реализацию интерфейса SSLSessionContext, этого нуля возвратов метода. Контекст непустого сеанса возвращается иначе.
public final SSLSessionContext getClientSessionContext()
Этот контекст может быть недоступным в некоторых средах, когда этот метод возвращает нуль. Например, когда базовый провайдер SSL не обеспечивает реализацию интерфейса SSLSessionContext, этого нуля возвратов метода. Контекст непустого сеанса возвращается иначе.
public final SSLParameters getDefaultSSLParameters()
У параметров всегда будут ciphersuites и набор массивов протоколов к ненулевым значениям.
UnsupportedOperationException
- если параметры SSL значения по умолчанию не могли бы быть получены.public final SSLParameters getSupportedSSLParameters()
У параметров всегда будут ciphersuites и набор массивов протоколов к ненулевым значениям.
UnsupportedOperationException
- если поддерживаемые параметры SSL не могли бы быть получены.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92