RMISocketFactory JDK 1.6)

Description

publicabstract abstract class RMISocketFactory

An RMISocketFactory instance is used by the RMI runtime in order to obtain client and server sockets for RMI calls.

An RMISocketFactory instance is used by the RMI runtime in order to obtain client and server sockets for RMI calls. An application may use the setSocketFactory method to request that the RMI runtime use its socket factory instance instead of the default implementation.

The default socket factory implementation used goes through a three-tiered approach to creating client sockets. First, a direct socket connection to the remote VM is attempted. If that fails (due to a firewall), the runtime uses HTTP with the explicit port number of the server. If the firewall does not allow this type of communication, then HTTP to a cgi-bin script on the server is used to POST the RMI call.

See also:

Methods

Hide/Show inherited methods

publicabstract ServerSocket createServerSocket (int port) throws IOException [Specified in RMIServerSocketFactory]

Create a server socket on the specified port (port 0 indicates an anonymous port).

publicabstract Socket createSocket (String host, int port) throws IOException [Specified in RMIClientSocketFactory]

Creates a client socket connected to the specified host and port.

publicstaticsynchronized RMISocketFactory getDefaultSocketFactory ()

Returns a reference to the default socket factory used by this RMI implementation.

Returns a reference to the default socket factory used
by this RMI implementation. This will be the factory used
by the RMI runtime when getSocketFactory
returns null.
Returns: the default RMI socket factory
Since: JDK1.1

publicstaticsynchronized RMIFailureHandler getFailureHandler ()

Returns the handler for socket creation failure set by the setFailureHandler method.

Returns the handler for socket creation failure set by the
setFailureHandler method.
Returns: the failure handler
Since: JDK1.1
See Also: RMISocketFactory.setFailureHandler(RMIFailureHandler),

publicstaticsynchronized RMISocketFactory getSocketFactory ()

Returns the socket factory set by the setSocketFactory method.

Returns the socket factory set by the setSocketFactory
method. Returns null if no socket factory has been
set.
Returns: the socket factory
Since: JDK1.1
See Also: RMISocketFactory.setSocketFactory(RMISocketFactory),

publicstaticsynchronized void setFailureHandler (RMIFailureHandler fh)

Sets the failure handler to be called by the RMI runtime if server socket creation fails.

publicstaticsynchronized void setSocketFactory (RMISocketFactory fac) throws IOException

Set the global socket factory from which RMI gets sockets (if the remote object is not associated with a specific client and/or server socket factory).

Set the global socket factory from which RMI gets sockets (if the
remote object is not associated with a specific client and/or server
socket factory). The RMI socket factory can only be set once. Note: The
RMISocketFactory may only be set if the current security manager allows
setting a socket factory; if disallowed, a SecurityException will be
thrown.
Parameters:
- fac - the socket factory
Throws:
- IOException - if the RMI socket factory is already set
- SecurityException - if a security manager exists and its checkSetFactory method doesn't allow the operation.
Since: JDK1.1
See Also: RMISocketFactory.getSocketFactory(), SecurityManager.checkSetFactory(),