| |
|
| java.lang.Object
 java.rmi.server.RMISocketFactory
| RMISocketFactory | | abstract public class RMISocketFactory implements RMIClientSocketFactory,RMIServerSocketFactory(Code) | | 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.
version:
1.28, 05/05/07
author:
Ann Wollrath
author:
Peter Jones
since:
JDK1.1 |
| RMISocketFactory | | public RMISocketFactory()(Code) | | Constructs an RMISocketFactory.
since:
JDK1.1 |
| createServerSocket | | abstract public ServerSocket createServerSocket(int port) throws IOException(Code) | | Create a server socket on the specified port (port 0 indicates
an anonymous port).
Parameters:
port - the port number the server socket on the specified port
exception:
IOException - if an I/O error occurs during server socketcreation
since:
JDK1.1 |
| createSocket | | abstract public Socket createSocket(String host, int port) throws IOException(Code) | | Creates a client socket connected to the specified host and port.
Parameters:
host - the host name
Parameters:
port - the port number a socket connected to the specified host and port.
exception:
IOException - if an I/O error occurs during socket creation
since:
JDK1.1 |
| getDefaultSocketFactory | | public static synchronized RMISocketFactory getDefaultSocketFactory()(Code) | | 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.
the default RMI socket factory
since:
JDK1.1 |
| setFailureHandler | | public static synchronized void setFailureHandler(RMIFailureHandler fh)(Code) | | Sets the failure handler to be called by the RMI runtime if server
socket creation fails. By default, if no failure handler is installed
and server socket creation fails, the RMI runtime does attempt to
recreate the server socket.
If there is a security manager, this method first calls
the security manager's checkSetFactory method
to ensure the operation is allowed.
This could result in a SecurityException.
Parameters:
fh - the failure handler
throws:
SecurityException - if a security manager exists and its checkSetFactory method doesn't allow theoperation.
See Also: RMISocketFactory.getFailureHandler
See Also: java.rmi.server.RMIFailureHandler.failure(Exception)
since:
JDK1.1 |
| setSocketFactory | | public static synchronized void setSocketFactory(RMISocketFactory fac) throws IOException(Code) | | 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
exception:
IOException - if the RMI socket factory is already set
exception:
SecurityException - if a security manager exists and its checkSetFactory method doesn't allow the operation.
See Also: RMISocketFactory.getSocketFactory
See Also: java.lang.SecurityManager.checkSetFactory
since:
JDK1.1 |
|
|
|