Класс SSLContext

public class SSLContext
extends Object

Экземпляры этого класса представляют реализацию протокола защищённого сокета, действующую как фабрика для фабрик защищённых сокетов или SSLEngine. Этот класс инициализируется с набором (необязательным) управляющих ключами и доверенных сертификатов, а также источником защищённых случайных байтов.

Каждая реализация Java платформы обязана поддерживать следующие стандартные SSLContext протоколы:

• TLSv1

Этот протокол описан в разделе SSLContext документации Java Cryptography Architecture Standard Algorithm Name. Обратитесь к документации реализации для просмотра поддержки других алгоритмов.

Конструкторы

SSLContext

protected SSLContext(SSLContextSpi contextSpi,
                     Provider provider,
                     String protocol)

Создаёт объект SSLContext.

Параметры:

contextSpi - делегат

provider - поставщик

protocol - протокол

Методы

getDefault

public static SSLContext getDefault()
                             throws NoSuchAlgorithmException

Возвращает:

стандартный SSL-контекст

Исключение:

NoSuchAlgorithmException - если вызов SSLContext.getInstance() завершается ошибкой

С:

1.6

setDefault

public static void setDefault(SSLContext context)

Устанавливает стандартный SSL-контекст. Он будет возвращаться последующими вызовами getDefault(). Стандартный контекст должен быть сразу готов к использованию и не требовать инициализации.

Параметры:

context - SSLContext

Исключение:

NullPointerException - если контекст равен null

SecurityException - если менеджер безопасности существует и его метод checkPermission не разрешает SSLPermission("setDefaultSSLContext")

С:

1.6

getInstance

public static SSLContext getInstance(String protocol)
                              throws NoSuchAlgorithmException

Параметры:

protocol - стандартное имя запрошенного протокола. См. раздел SSLContext в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах протоколов.

Возвращает:

новый объект SSLContext.

Исключение:

NoSuchAlgorithmException - если ни один поставщик не поддерживает реализацию SSLContextSpi для указанного протокола.

NullPointerException - если протокол равен null.

См. также:

Provider

getInstance

public static SSLContext getInstance(String protocol,
                                     String provider)
                              throws NoSuchAlgorithmException,
                                     NoSuchProviderException

Параметры:

protocol - стандартное имя запрошенного протокола. См. раздел SSLContext в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах протоколов.

provider - имя поставщика.

Возвращает:

новый объект SSLContext.

Исключение:

NoSuchAlgorithmException - если реализация SSLContextSpi для указанного протокола недоступна от указанного поставщика.

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

IllegalArgumentException - если имя поставщика равно null или пустое.

NullPointerException - если протокол равен null.

См. также:

Provider

getInstance

public static SSLContext getInstance(String protocol,
                                     Provider provider)
                              throws NoSuchAlgorithmException

Параметры:

protocol - стандартное имя запрошенного протокола. См. раздел SSLContext в Java Cryptography Architecture Standard Algorithm Name Documentation для получения информации о стандартных именах протоколов.

provider - экземпляр поставщика.

Возвращает:

новый объект SSLContext.

Исключение:

NoSuchAlgorithmException - если реализация SSLContextSpi для указанного протокола недоступна от указанного объекта поставщика.

IllegalArgumentException - если поставщик равен null.

NullPointerException - если протокол равен null.

См. также:

Provider

getProtocol

public final String getProtocol()

Возвращает:

имя протокола этого объекта SSLContext.

getProvider

public final Provider getProvider()

Возвращает поставщика этого объекта SSLContext.

Возвращает:

поставщика этого объекта SSLContext

init

public final void init(KeyManager[] km,
                       TrustManager[] tm,
                       SecureRandom random)
                throws KeyManagementException

Параметры:

km - источники ключей аутентификации или null

tm - источники решений по доверенности peer аутентификации или null

random - источник случайности для этого генератора или null

Исключение:

KeyManagementException - если эта операция завершается ошибкой

getSocketFactory

public final SSLSocketFactory getSocketFactory()

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

Возвращает:

объект SocketFactory

Исключение:

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

getServerSocketFactory

public final SSLServerSocketFactory getServerSocketFactory()

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

Возвращает:

объект ServerSocketFactory

Исключение:

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

createSSLEngine

public final SSLEngine createSSLEngine()

Возвращает:

объект SSLEngine

Исключение:

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

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

С:

1.5

createSSLEngine

public final SSLEngine createSSLEngine(String peerHost,
                                       int peerPort)

Параметры:

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

peerPort - неофициальный порт

Возвращает:

новый объект SSLEngine

Исключение:

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

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

С:

1.5

getServerSessionContext

public final SSLSessionContext getServerSessionContext()

Возвращает:

контекст серверной сессии, связанный с этим SSL-контекстом

getClientSessionContext

public final SSLSessionContext getClientSessionContext()

Возвращает:

контекст клиентской сессии, связанный с этим SSL-контекстом

getDefaultSSLParameters

public final SSLParameters getDefaultSSLParameters()

Возвращает:

копию объекта SSLParameters с параметрами по умолчанию

Выбрасывает:

UnsupportedOperationException - если параметры SSL по умолчанию получить не удалось.

С тех пор:

1.6

getSupportedSSLParameters

public final SSLParameters getSupportedSSLParameters()

Возвращает:

копию объекта SSLParameters с поддерживаемыми настройками

Выбрасывает:

UnsupportedOperationException - если поддерживаемые параметры SSL получить не удалось.

С тех пор:

1.6