OpenJDK 27 · javax.rmi.ssl.SslRMIClientSocketFactory

An SslRMIClientSocketFactory instance is used by the RMI runtime in order to obtain client sockets for RMI calls via SSL.

This class implements RMIClientSocketFactory over the Secure Sockets Layer (SSL) or Transport Layer Security (TLS) protocols.

This class creates SSL sockets using the default SSLSocketFactory (see SSLSocketFactory#getDefault). All instances of this class are functionally equivalent. In particular, they all share the same truststore, and the same keystore when client authentication is required by the server. This behavior can be modified in subclasses by overriding the createSocket(String, int) method; in that case, equals and hashCode may also need to be overridden.

If the system property javax.rmi.ssl.client.enabledCipherSuites is specified, the createSocket(String, int) method will call SSLSocket#setEnabledCipherSuites(String[]) before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS cipher suites to enable.

If the system property javax.rmi.ssl.client.enabledProtocols is specified, the createSocket(String, int) method will call SSLSocket#setEnabledProtocols(String[]) before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS protocol versions to enable.

Field Summary

Modifier and Type	Field and Description
private static SocketFactory	defaultSocketFactory
private static final long	serialVersionUID

Constructor Summary

Access	Constructor and Description
public	SslRMIClientSocketFactory() Creates a new `SslRMIClientSocketFactory`.

Method Summary

Modifier and Type	Method and Description
public Socket	createSocket(String host, int port) Implements java.rmi.server.RMIClientSocketFactory.createSocket. Creates an SSL socket.
public boolean	equals(Object obj) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
private static synchronized SocketFactory	getDefaultClientSocketFactory()
public int	Returns: a hash code value for this `SslRMIClientSocketFactory`. hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this `SslRMIClientSocketFactory`.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll toString wait wait wait

Field Detail

defaultSocketFactory	back to summary
private static SocketFactory defaultSocketFactory

serialVersionUID	back to summary
private static final long serialVersionUID

Constructor Detail

SslRMIClientSocketFactory	back to summary
public SslRMIClientSocketFactory() Creates a new `SslRMIClientSocketFactory`.

Method Detail

createSocket back to summary

createSocket	back to summary
public Socket createSocket(String host, int port) throws IOException Implements java.rmi.server.RMIClientSocketFactory.createSocket. Creates an SSL socket. If the system property `javax.rmi.ssl.client.enabledCipherSuites` is specified, this method will call `SSLSocket#setEnabledCipherSuites(String[])` before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS cipher suites to enable. If the system property `javax.rmi.ssl.client.enabledProtocols` is specified, this method will call `SSLSocket#setEnabledProtocols(String[])` before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS protocol versions to enable. Exceptions IOException: Doc from java.rmi.server.RMIClientSocketFactory.createSocket. if an I/O error occurs during socket creation

public Socket createSocket(String host, int port) throws IOException

Implements java.rmi.server.RMIClientSocketFactory.createSocket.

Creates an SSL socket.

If the system property javax.rmi.ssl.client.enabledCipherSuites is specified, this method will call SSLSocket#setEnabledCipherSuites(String[]) before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS cipher suites to enable.

If the system property javax.rmi.ssl.client.enabledProtocols is specified, this method will call SSLSocket#setEnabledProtocols(String[]) before returning the socket. The value of this system property is a string that is a comma-separated list of SSL/TLS protocol versions to enable.

Exceptions

IOException:

Doc from java.rmi.server.RMIClientSocketFactory.createSocket.

if an I/O error occurs during socket creation

equals back to summary

equals	back to summary
public boolean equals(Object obj) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one. Because all instances of this class are functionally equivalent (they all use the default `SSLSocketFactory`), this method simply returns `this.getClass().equals(obj.getClass())`. A subclass should override this method (as well as `hashCode()`) if its instances are not all functionally equivalent.

public boolean equals(Object obj)

Overrides java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

Because all instances of this class are functionally equivalent (they all use the default SSLSocketFactory), this method simply returns this.getClass().equals(obj.getClass()).

A subclass should override this method (as well as hashCode()) if its instances are not all functionally equivalent.

getDefaultClientSocketFactory	back to summary
private static synchronized SocketFactory getDefaultClientSocketFactory()

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this `SslRMIClientSocketFactory`. Returns:int a hash code value for this `SslRMIClientSocketFactory`.

public int hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code value for this SslRMIClientSocketFactory.