Класс 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
См. также:
SSLSocketFactory, SSLServerSocketFactory, SslRMIClientSocketFactory

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

Конструктор Описание
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)

Указывает, является ли другой объект "равным" этому.
String[] getEnabledCipherSuites()

Возвращает имена наборов шифров, включенных в SSL соединения, принимаемые серверными сокетами, созданными этой фабрикой, или null если эта фабрика использует наборы шифров, включенные по умолчанию.
String[] getEnabledProtocols()

Возвращает имена версий протоколов, включенных в SSL соединения, принимаемые серверными сокетами, созданными этой фабрикой, или null если эта фабрика использует версии протоколов, включенные по умолчанию.
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, не поддерживаются, или если возникла проблема при проверке поддержки указанных наборов шифров и версий протоколов.
См. также:
SSLSocket.setEnabledCipherSuites(java.lang.String[]), SSLSocket.setEnabledProtocols(java.lang.String[]), SSLSocket.setNeedClientAuth(boolean)

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
См. также:
SSLSocket.setEnabledCipherSuites(java.lang.String[]), SSLSocket.setEnabledProtocols(java.lang.String[]), SSLSocket.setNeedClientAuth(boolean)

Методы

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 в противном случае.
См. также:
Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого SslRMIServerSocketFactory.

Переопределяет:
hashCode в классе Object
Возвращает:
значение хэш-кода для этого SslRMIServerSocketFactory.
См. также:
Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

© 1993, 2020, 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/11/docs/api/java.rmi/javax/rmi/ssl/SslRMIServerSocketFactory.html

Spec-Zone .ru
спецификации, руководства, описания, API