Класс SslRMIServerSocketFactory

java.lang.Object

javax.rmi.ssl.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.

Since:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`SslRMIServerSocketFactory()`	Создаёт новый `SslRMIServerSocketFactory` с конфигурацией сокета SSL по умолчанию.
`SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)`	Создаёт новый `SslRMIServerSocketFactory` с указанной конфигурацией сокета SSL.
`SslRMIServerSocketFactory(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)`	Создаёт новый `SslRMIServerSocketFactory` с указанной `SSLContext` и конфигурацией сокета SSL.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ServerSocket`	`createServerSocket(int port)`	Создаёт сокет сервера, принимающий SSL-соединения, сконфигурированные в соответствии с параметрами конфигурации SSL-сокета этого фабрики.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект "равным" этому объекту.
`final String[]`	`getEnabledCipherSuites()`	Возвращает имена наборов шифров, включенных в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или `null` если эта фабрика использует наборы шифров, включённые по умолчанию.
`final String[]`	`getEnabledProtocols()`	Возвращает имена версий протоколов, включённых в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или `null` если эта фабрика использует версии протоколов, включённые по умолчанию.
`final boolean`	`getNeedClientAuth()`	Возвращает `true` если проверка клиента требуется в SSL-соединениях, принимаемых сокетами сервера, созданными этой фабрикой.
`int`	`hashCode()`	Возвращает код хэша для этого объекта `SslRMIServerSocketFactory`.

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

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().

Исключения:

С:

1.7

См. также:

Подробное описание методов

getEnabledCipherSuites

public final String[] getEnabledCipherSuites()

Возвращает имена наборов шифров, включённых для SSL-соединений, принимаемых серверными сокетами, созданными этим фабричным объектом, или null если этот фабричный объект использует наборы шифров по умолчанию.

Возвращает:

массив включённых наборов шифров, или null

См. также:

SSLSocket.setEnabledCipherSuites(java.lang.String[])

getEnabledProtocols

public final String[] getEnabledProtocols()

Возвращает имена версий протоколов, включённых для SSL-соединений, принимаемых серверными сокетами, созданными этим фабричным объектом, или null если этот фабричный объект использует версии протоколов по умолчанию.

Возвращает:

массив включённых версий протоколов, или null

См. также:

SSLSocket.setEnabledProtocols(java.lang.String[])

getNeedClientAuth

public final boolean getNeedClientAuth()

Возвращает true , если требуется аутентификация клиента для SSL-соединений, принимаемых серверными сокетами, созданными этим фабричным объектом.

Возвращает:

true , если требуется аутентификация клиента

См. также:

SSLSocket.setNeedClientAuth(boolean)

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, 2021, 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/17/docs/api/java.rmi/javax/rmi/ssl/SslRMIServerSocketFactory.html