- java.lang.Object
-
- javax.rmi.ssl.SslRMIServerSocketFactory
-
- All Implemented Interfaces:
- RMIServerSocketFactory
public class SslRMIServerSocketFactory extends Object implements RMIServerSocketFactory
An
SslRMIServerSocketFactory
instance is used by the RMI runtime in order to obtain server sockets for RMI calls via SSL.This class implements
RMIServerSocketFactory
over the Secure Sockets Layer (SSL) or Transport Layer Security (TLS) protocols.This class creates SSL sockets using the default
SSLSocketFactory
(seeSSLSocketFactory.getDefault()
) or the defaultSSLServerSocketFactory
(seeSSLServerSocketFactory.getDefault()
) unless the constructor taking anSSLContext
is used in which case the SSL sockets are created using theSSLSocketFactory
returned bySSLContext.getSocketFactory()
or theSSLServerSocketFactory
returned bySSLContext.getServerSocketFactory()
. When anSSLContext
is not supplied all the instances of this class share the same keystore, and the same truststore (when client authentication is required by the server). This behavior can be modified by supplying an already initializedSSLContext
instance.- Since:
- 1.5
- See Also:
SSLSocketFactory
,SSLServerSocketFactory
,SslRMIClientSocketFactory
-
-
Constructor Summary
Constructors Constructor and Description SslRMIServerSocketFactory()
Creates a newSslRMIServerSocketFactory
with the default SSL socket configuration.SslRMIServerSocketFactory(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)
Creates a newSslRMIServerSocketFactory
with the specifiedSSLContext
and SSL socket configuration.SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)
Creates a newSslRMIServerSocketFactory
with the specified SSL socket configuration.
-
Method Summary
Methods Modifier and Type Method and Description ServerSocket
createServerSocket(int port)
Creates a server socket that accepts SSL connections configured according to this factory's SSL socket configuration parameters.boolean
equals(Object obj)
Indicates whether some other object is "equal to" this one.String[]
getEnabledCipherSuites()
Returns the names of the cipher suites enabled on SSL connections accepted by server sockets created by this factory, ornull
if this factory uses the cipher suites that are enabled by default.String[]
getEnabledProtocols()
Returns the names of the protocol versions enabled on SSL connections accepted by server sockets created by this factory, ornull
if this factory uses the protocol versions that are enabled by default.boolean
getNeedClientAuth()
Returnstrue
if client authentication is required on SSL connections accepted by server sockets created by this factory.int
hashCode()
Returns a hash code value for thisSslRMIServerSocketFactory
.
-
-
-
Constructor Detail
-
SslRMIServerSocketFactory
public SslRMIServerSocketFactory()
Creates a new
SslRMIServerSocketFactory
with the default SSL socket configuration.SSL connections accepted by server sockets created by this factory have the default cipher suites and protocol versions enabled and do not require client authentication.
-
SslRMIServerSocketFactory
public SslRMIServerSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) throws IllegalArgumentException
Creates a new
SslRMIServerSocketFactory
with the specified SSL socket configuration.- Parameters:
enabledCipherSuites
- names of all the cipher suites to enable on SSL connections accepted by server sockets created by this factory, ornull
to use the cipher suites that are enabled by defaultenabledProtocols
- names of all the protocol versions to enable on SSL connections accepted by server sockets created by this factory, ornull
to use the protocol versions that are enabled by defaultneedClientAuth
-true
to require client authentication on SSL connections accepted by server sockets created by this factory;false
to not require client authentication- Throws:
IllegalArgumentException
- when one or more of the cipher suites named by theenabledCipherSuites
parameter is not supported, when one or more of the protocols named by theenabledProtocols
parameter is not supported or when a problem is encountered while trying to check if the supplied cipher suites and protocols to be enabled are supported.- See Also:
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
Creates a new
SslRMIServerSocketFactory
with the specifiedSSLContext
and SSL socket configuration.- Parameters:
context
- the SSL context to be used for creating SSL sockets. Ifcontext
is null the defaultSSLSocketFactory
or the defaultSSLServerSocketFactory
will be used to create SSL sockets. Otherwise, the socket factory returned bySSLContext.getSocketFactory()
orSSLContext.getServerSocketFactory()
will be used instead.enabledCipherSuites
- names of all the cipher suites to enable on SSL connections accepted by server sockets created by this factory, ornull
to use the cipher suites that are enabled by defaultenabledProtocols
- names of all the protocol versions to enable on SSL connections accepted by server sockets created by this factory, ornull
to use the protocol versions that are enabled by defaultneedClientAuth
-true
to require client authentication on SSL connections accepted by server sockets created by this factory;false
to not require client authentication- Throws:
IllegalArgumentException
- when one or more of the cipher suites named by theenabledCipherSuites
parameter is not supported, when one or more of the protocols named by theenabledProtocols
parameter is not supported or when a problem is encountered while trying to check if the supplied cipher suites and protocols to be enabled are supported.- Since:
- 1.7
- See Also:
SSLSocket.setEnabledCipherSuites(java.lang.String[])
,SSLSocket.setEnabledProtocols(java.lang.String[])
,SSLSocket.setNeedClientAuth(boolean)
-
-
Method Detail
-
getEnabledCipherSuites
public final String[] getEnabledCipherSuites()
Returns the names of the cipher suites enabled on SSL connections accepted by server sockets created by this factory, or
null
if this factory uses the cipher suites that are enabled by default.- Returns:
- an array of cipher suites enabled, or
null
- See Also:
SSLSocket.setEnabledCipherSuites(java.lang.String[])
-
getEnabledProtocols
public final String[] getEnabledProtocols()
Returns the names of the protocol versions enabled on SSL connections accepted by server sockets created by this factory, or
null
if this factory uses the protocol versions that are enabled by default.- Returns:
- an array of protocol versions enabled, or
null
- See Also:
SSLSocket.setEnabledProtocols(java.lang.String[])
-
getNeedClientAuth
public final boolean getNeedClientAuth()
Returns
true
if client authentication is required on SSL connections accepted by server sockets created by this factory.- Returns:
true
if client authentication is required- See Also:
SSLSocket.setNeedClientAuth(boolean)
-
createServerSocket
public ServerSocket createServerSocket(int port) throws IOException
Creates a server socket that accepts SSL connections configured according to this factory's SSL socket configuration parameters.
- Specified by:
createServerSocket
in interfaceRMIServerSocketFactory
- Parameters:
port
- the port number- Returns:
- the server socket on the specified port
- Throws:
IOException
- if an I/O error occurs during server socket creation
-
equals
public boolean equals(Object obj)
Indicates whether some other object is "equal to" this one.
Two
SslRMIServerSocketFactory
objects are equal if they have been constructed with the same SSL context and SSL socket configuration parameters.A subclass should override this method (as well as
hashCode()
) if it adds instance state that affects equality.- Overrides:
equals
in classObject
- Parameters:
obj
- the reference object with which to compare.- Returns:
true
if this object is the same as the obj argument;false
otherwise.- See Also:
Object.hashCode()
,HashMap
-
hashCode
public int hashCode()
Returns a hash code value for this
SslRMIServerSocketFactory
.- Overrides:
hashCode
in classObject
- Returns:
- a hash code value for this
SslRMIServerSocketFactory
. - See Also:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-javax/rmi/ssl/SslRMIServerSocketFactory.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.