|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjavax.rmi.ssl.SslRMIServerSocketFactory
public class SslRMIServerSocketFactory
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 (see SSLSocketFactory.getDefault()) or the default
SSLServerSocketFactory (see SSLServerSocketFactory.getDefault()). Therefore, all 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 in subclasses by overriding the createServerSocket(int) method; in that case, equals and hashCode may also
need to be overridden.
SSLSocketFactory,
SSLServerSocketFactory,
SslRMIClientSocketFactory| Constructor Summary | |
|---|---|
SslRMIServerSocketFactory()
Creates a new SslRMIServerSocketFactory with
the default SSL socket configuration. |
|
SslRMIServerSocketFactory(String[] enabledCipherSuites,
String[] enabledProtocols,
boolean needClientAuth)
Creates a new SslRMIServerSocketFactory with
the specified SSL socket configuration. |
|
| Method Summary | |
|---|---|
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, or null 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, or null if this factory uses the protocol versions
that are enabled by default. |
boolean |
getNeedClientAuth()
Returns true if client authentication is
required on SSL connections accepted by server sockets created
by this factory. |
int |
hashCode()
Returns a hash code value for this SslRMIServerSocketFactory. |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
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.
public SslRMIServerSocketFactory(String[] enabledCipherSuites,
String[] enabledProtocols,
boolean needClientAuth)
throws IllegalArgumentException
Creates a new SslRMIServerSocketFactory with
the specified SSL socket configuration.
enabledCipherSuites - names of all the cipher suites to
enable on SSL connections accepted by server sockets created by
this factory, or null 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, or null 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
IllegalArgumentException - when one or more of the cipher
suites named by the enabledCipherSuites parameter is
not supported, when one or more of the protocols named by the
enabledProtocols 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.SSLSocket.setEnabledCipherSuites(java.lang.String[]),
SSLSocket.setEnabledProtocols(java.lang.String[]),
SSLSocket.setNeedClientAuth(boolean)| Method Detail |
|---|
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.
nullSSLSocket.setEnabledCipherSuites(java.lang.String[])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.
nullSSLSocket.setEnabledProtocols(java.lang.String[])public final boolean getNeedClientAuth()
Returns true if client authentication is
required on SSL connections accepted by server sockets created
by this factory.
true if client authentication is requiredSSLSocket.setNeedClientAuth(boolean)
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.
createServerSocket in interface RMIServerSocketFactoryport - the port number
IOException - if an I/O error occurs during server socket
creationpublic 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 socket
configuration parameters.
A subclass should override this method (as well as
hashCode()) if it adds instance state that affects
equality.
equals in class Objectobj - the reference object with which to compare.
true if this object is the same as the obj
argument; false otherwise.Object.hashCode(),
Hashtablepublic int hashCode()
Returns a hash code value for this
SslRMIServerSocketFactory.
hashCode in class ObjectSslRMIServerSocketFactory.Object.equals(java.lang.Object),
Hashtable
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright © 1993, 2010, Oracle and/or its affiliates. All rights reserved.