Класс 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.
- С момента:
- 1.5
- См. также:
-
SSLSocketFactory,SSLServerSocketFactory,SslRMIClientSocketFactory
Конструкторы
| Конструктор и описание |
|---|
SslRMIServerSocketFactory() Создаёт новый |
SslRMIServerSocketFactory(SSLContext context,
String[] enabledCipherSuites,
String[] enabledProtocols,
boolean needClientAuth) Создаёт новый |
SslRMIServerSocketFactory(String[] enabledCipherSuites,
String[] enabledProtocols,
boolean needClientAuth) Создаёт новый |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
ServerSocket |
createServerSocket(int port) Создаёт сокет сервера, принимающий SSL-соединения, сконфигурированные в соответствии с параметрами конфигурации сокета SSL этого фабричного объекта. |
boolean |
equals(Object obj) Указывает, является ли другой объект "равным" данному. |
String[] |
getEnabledCipherSuites() Возвращает имена наборов шифрования, включенных в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или |
String[] |
getEnabledProtocols() Возвращает имена версий протоколов, включённых в SSL-соединения, принимаемые сокетами сервера, созданными этой фабрикой, или |
boolean |
getNeedClientAuth() Возвращает |
int |
hashCode() Возвращает значение хэш-кода для этого |
Методы, унаследованные от класса 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, будет использован контекст SSL по умолчанию или стандартный контекст SSL по умолчанию для создания SSL-сокетов. В противном случае будет использован фабричный объект сокетов, возвращаемый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.