RMIServerSocketFactory (Java 2 Platform SE 5.0) (original) (raw)

java.rmi.server

Interface RMIServerSocketFactory

All Known Implementing Classes:

RMISocketFactory, SslRMIServerSocketFactory

public interface RMIServerSocketFactory

An RMIServerSocketFactory instance is used by the RMI runtime in order to obtain server sockets for RMI calls. A remote object can be associated with an RMIServerSocketFactory when it is created/exported via the constructors or exportObject methods of java.rmi.server.UnicastRemoteObject andjava.rmi.activation.Activatable .

An RMIServerSocketFactory instance associated with a remote object is used to obtain the ServerSocket used to accept incoming calls from clients.

An RMIServerSocketFactory instance can also be associated with a remote object registry so that clients can use custom socket communication with a remote object registry.

An implementation of this interface should implement Object.equals(java.lang.Object) to return true when passed an instance that represents the same (functionally equivalent) server socket factory, and false otherwise (and it should also implement Object.hashCode() consistently with itsObject.equals implementation).

Since:

1.2

Method Summary
ServerSocket	createServerSocket(int port) Create a server socket on the specified port (port 0 indicates an anonymous port).

Method Detail

createServerSocket

ServerSocket createServerSocket(int port) throws IOException

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

Parameters:

port - the port number

Returns:

the server socket on the specified port

Throws:

[IOException](../../../java/io/IOException.html "class in java.io") - if an I/O error occurs during server socket creation

Since:

1.2

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.