Класс SslRMIServerSocketFactory
- Все реализованные интерфейсы:
RMIServerSocketFactory
public class SslRMIServerSocketFactory extends Object implements RMIServerSocketFactory
Экземпляр класса SslRMIServerSocketFactory используется RMI-средой для получения сокетов сервера для вызовов RMI через SSL.
Этот класс реализует RMIServerSocketFactory по протоколам Secure Sockets Layer (SSL) или Transport Layer Security (TLS).
Этот класс создаёт SSL-сокеты, используя по умолчанию SSLSocketFactory (см. SSLSocketFactory.getDefault()) или по умолчанию SSLServerSocketFactory (см. SSLServerSocketFactory.getDefault()), если не используется конструктор, принимающий SSLContext, в этом случае SSL-сокеты создаются с помощью SSLSocketFactory возвращаемого SSLContext.getSocketFactory() или SSLServerSocketFactory возвращаемого SSLContext.getServerSocketFactory(). Если SSLContext не предоставлен, все экземпляры этого класса используют один и тот же хранилище ключей и то же самое хранилище доверия (если проверка клиента требуется сервером). Это поведение можно изменить, предоставив уже инициализированный экземпляр SSLContext.
- С тех пор:
- 1.5
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
SslRMIServerSocketFactory() |
Создаёт новый SslRMIServerSocketFactory с конфигурацией сокетов SSL по умолчанию. |
SslRMIServerSocketFactory |
Создаёт новый SslRMIServerSocketFactory с указанной конфигурацией сокетов SSL. |
SslRMIServerSocketFactory |
Создаёт новый SslRMIServerSocketFactory с указанным SSLContext и конфигурацией сокетов SSL. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
ServerSocket |
createServerSocket |
Создаёт сокет сервера, принимающий SSL-соединения, настроенные в соответствии с параметрами конфигурации сокетов SSL этого фабричного объекта. |
boolean |
equals |
Указывает, является ли другой объект "равным" этому. |
final String[] |
getEnabledCipherSuites() |
Возвращает имена наборов шифрования, включенных в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или null, если эта фабрика использует наборы шифрования, включённые по умолчанию. |
final String[] |
getEnabledProtocols() |
Возвращает имена версий протокола, включенных в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или null, если эта фабрика использует версии протокола, включённые по умолчанию. |
final boolean |
getNeedClientAuth() |
Возвращает true, если проверка клиента требуется для SSL-соединений, принимаемых сокетами сервера, созданными этой фабрикой. |
int |
hashCode() |
Возвращает значение кода хэша для этого объекта SslRMIServerSocketFactory. |
Подробное описание конструкторов
SslRMIServerSocketFactory
public SslRMIServerSocketFactory()
Создаёт новый SslRMIServerSocketFactory с конфигурацией сокета SSL по умолчанию.
Подключаемые через серверные сокеты, созданные этим фабричным объектом, SSL-соединения используют стандартные наборы шифров и протоколы, а также не требуют аутентификации клиента.
SslRMIServerSocketFactory
public SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) throws IllegalArgumentException
Создаёт новый SslRMIServerSocketFactory со указанной конфигурацией сокета SSL.
- Параметры:
-
enabledCipherSuites- имена всех наборов шифров, которые необходимо включить для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, илиnullдля использования наборов шифров по умолчанию -
enabledProtocols- имена всех версий протоколов, которые необходимо включить для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, илиnullдля использования версий протоколов по умолчанию -
needClientAuth-trueдля требования аутентификации клиента при SSL-соединениях, принимаемых серверными сокетами, созданными этой фабрикой;falseдля отмены требования аутентификации клиента - Исключения:
-
IllegalArgumentException- если один или несколько наборов шифров, указанных вenabledCipherSuitesпараметре, не поддерживаются, если одна или несколько версий протоколов, указанных вenabledProtocolsпараметре, не поддерживаются, или если возникла проблема при проверке поддержки указанных наборов шифров и версий протоколов. - См. также:
SslRMIServerSocketFactory
public SslRMIServerSocketFactory(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) throws IllegalArgumentException
Создаёт новый SslRMIServerSocketFactory с указанным SSLContext и конфигурацией сокета SSL.
- Параметры:
-
context- контекст SSL, используемый для создания сокетов SSL. Еслиcontextимеет значение null, то будет использован по умолчаниюSSLSocketFactoryилиSSLServerSocketFactory. В противном случае, будет использован фабричный объект сокета, возвращаемыйSSLContext.getSocketFactory()илиSSLContext.getServerSocketFactory(). -
enabledCipherSuites- имена всех наборов шифров, которые необходимо включить для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, илиnullдля использования наборов шифров по умолчанию -
enabledProtocols- имена всех версий протоколов, которые необходимо включить для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, илиnullдля использования версий протоколов по умолчанию -
needClientAuth-trueдля требования аутентификации клиента при SSL-соединениях, принимаемых серверными сокетами, созданными этой фабрикой;falseдля отмены требования аутентификации клиента - Исключения:
-
IllegalArgumentException- если один или несколько наборов шифров, указанных вenabledCipherSuitesпараметре, не поддерживаются, если одна или несколько версий протоколов, указанных вenabledProtocolsпараметре, не поддерживаются, или если возникла проблема при проверке поддержки указанных наборов шифров и версий протоколов. - С:
- 1.7
- См. также:
Подробное описание методов
getEnabledCipherSuites
public final String[] getEnabledCipherSuites()
Возвращает имена наборов шифров, включенных для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, или null если эта фабрика использует наборы шифров по умолчанию.
- Возвращает:
- массив включенных наборов шифров, или
null - См. также:
getEnabledProtocols
public final String[] getEnabledProtocols()
Возвращает имена версий протоколов, включенных для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой, или null если эта фабрика использует версии протоколов по умолчанию.
- Возвращает:
- массив включённых версий протоколов, или
null - См. также:
getNeedClientAuth
public final boolean getNeedClientAuth()
Возвращает true если требуется аутентификация клиента для SSL-соединений, принимаемых серверными сокетами, созданными этой фабрикой.
- Возвращает:
-
trueесли требуется аутентификация клиента - См. также:
createServerSocket
public ServerSocket createServerSocket(int port) throws IOException
Создаёт серверный сокет, который принимает SSL-соединения, настроенные в соответствии с параметрами конфигурации сокета SSL этой фабрики.
- Определено в:
-
createServerSocketв интерфейсеRMIServerSocketFactory - Параметры:
-
port- номер порта - Возвращает:
- серверный сокет на указанном порту
- Исключения:
-
IOException- если во время создания серверного сокета произошла ошибка ввода-вывода
equals
public boolean equals(Object obj)
Указывает, является ли другой объект "равным" данному.
Два объекта SslRMIServerSocketFactory равны, если они были созданы с одинаковым контекстом SSL и параметрами конфигурации сокета SSL.
Подкласс должен переопределить этот метод (а также hashCode()), если он добавляет состояние экземпляра, влияющее на равенство.
- Переопределяет:
-
equalsв классеObject - Параметры:
-
obj- ссылка на объект для сравнения. - Возвращает:
-
trueесли этот объект такой же, как аргумент obj;falseв противном случае. - См. также:
hashCode
public int hashCode()
Возвращает значение кода хэша для этого SslRMIServerSocketFactory.
- Переопределяет:
-
hashCodeв классеObject - Возвращает:
- значение кода хэша для этого
SslRMIServerSocketFactory. - См. также:
© 1993, 2023, 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/21/docs/api/java.rmi/javax/rmi/ssl/SslRMIServerSocketFactory.html