Класс 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для создания SSL-сокетов. В противном случае, вместо этого будет использован фабричный объект сокета, возвращаемый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()), если он добавляет состояние экземпляра, влияющее на равенство.
hashCode
© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.rmi/javax/rmi/ssl/SslRMIServerSocketFactory.html