SSLContext (Платформа Java SE 7)

java.lang. Объект
- javax.net.ssl. SSLContext

```
public class SSLContext
extends Object
```
Экземпляры этого класса представляют реализацию протокола защищенного сокета, которая действует как фабрика для фабрик защищенного сокета или SSLEngines. Этот класс инициализируется с дополнительной группой ключевых и доверительных менеджеров и источником безопасных случайных байтов.
Каждая реализация платформы Java обязана поддерживать следующий стандарт SSLContext протокол:
- TLSv1
Этот протокол описывается в разделе SSLContext Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.
С тех пор:

1.4

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`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 по умолчанию.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SSLContext

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

SSLContext

Деталь метода

getDefault

setDefault

getInstance

getInstance

getInstance

getProtocol

getProvider

init

getSocketFactory

getServerSocketFactory

createSSLEngine

createSSLEngine

getServerSessionContext

getClientSessionContext

getDefaultSSLParameters

getSupportedSSLParameters