|
J2ME RMI Optional Package | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--java.rmi.server.RMISocketFactory
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.
Constructor Summary | |
RMISocketFactory()
Constructs an RMISocketFactory . |
Method Summary | |
abstract java.net.ServerSocket |
createServerSocket(int port)
Create a server socket on the specified port (port 0 indicates an anonymous port). |
abstract java.net.Socket |
createSocket(java.lang.String host,
int port)
Creates a client socket connected to the specified host and port. |
static RMISocketFactory |
getDefaultSocketFactory()
Returns a reference to the default socket factory used by this RMI implementation. |
static RMIFailureHandler |
getFailureHandler()
Returns the handler for socket creation failure set by the setFailureHandler method. |
static RMISocketFactory |
getSocketFactory()
Returns the socket factory set by the setSocketFactory
method. |
static void |
setFailureHandler(RMIFailureHandler fh)
Sets the failure handler to be called by the RMI runtime if server socket creation fails. |
static void |
setSocketFactory(RMISocketFactory fac)
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). |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public RMISocketFactory()
RMISocketFactory
.Method Detail |
public abstract java.net.Socket createSocket(java.lang.String host, int port) throws java.io.IOException
createSocket
in interface RMIClientSocketFactory
host
- the host nameport
- the port numberjava.io.IOException
- if an I/O error occurs during socket creationpublic abstract java.net.ServerSocket createServerSocket(int port) throws java.io.IOException
createServerSocket
in interface RMIServerSocketFactory
port
- the port numberjava.io.IOException
- if an I/O error occurs during server socket
creationpublic static void setSocketFactory(RMISocketFactory fac) throws java.io.IOException
fac
- the socket factoryjava.io.IOException
- if the RMI socket factory is already setjava.lang.SecurityException
- if a security manager exists and its
checkSetFactory
method doesn't allow the operation.SecurityManager.checkSetFactory()
public static RMISocketFactory getSocketFactory()
setSocketFactory
method. Returns null
if no socket factory has been
set.setSocketFactory(RMISocketFactory)
public static RMISocketFactory getDefaultSocketFactory()
getSocketFactory
returns null
.public static void setFailureHandler(RMIFailureHandler fh)
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
.
fh
- the failure handlerjava.lang.SecurityException
- if a security manager exists and its
checkSetFactory
method doesn't allow the
operation.RMIFailureHandler.failure(Exception)
public static RMIFailureHandler getFailureHandler()
setFailureHandler
method.setFailureHandler(RMIFailureHandler)
|
J2ME RMI Optional Package | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |