javax.management.remote.rmi
class RMIJRMPServerImpl

java.lang.Object javax.management.remote.rmi.RMIServerImpl javax.management.remote.rmi.RMIJRMPServerImpl

All Implemented Interfaces:

Closeable, RMIServer

public class RMIJRMPServerImpl
extends RMIServerImpl

An {@link RMIServer} object that is exported through JRMP and that creates client connections as RMI objects exported through JRMP. User code does not usually reference this class directly.

RMIJRMPServerImpl

public RMIJRMPServerImpl(int port,
                         RMIClientSocketFactory csf,
                         RMIServerSocketFactory ssf,
                         Map env)
                  throws IOException

Creates a new {@link RMIServer} object that will be exported on the given port using the given socket factories.

Parameters:

port - the port on which this object and the {@link RMIConnectionImpl} objects it creates will be exported. Can be zero, to indicate any available port.

csf - the client socket factory for the created RMI objects. Can be null.

ssf - the server socket factory for the created RMI objects. Can be null.

env - the environment map. Can be null.

Throws:

IOException - if the {@link RMIServer} object cannot be created.

closeClient

protected void closeClient(RMIConnection client)
                    throws IOException

Overrides:

closeClient in class RMIServerImpl

Parameters:

client

Throws:

IOException

closeServer

protected void closeServer()
                    throws IOException

Called by {@link #close()} to close the connector server by unexporting this object. After returning from this method, the connector server must not accept any new connections.

Overrides:

closeServer in class RMIServerImpl

Throws:

IOException - if the attempt to close the connector server failed.

export

protected void export()
               throws IOException

Overrides:

export in class RMIServerImpl

Throws:

IOException

getProtocol

protected String getProtocol()

Overrides:

getProtocol in class RMIServerImpl

makeClient

protected RMIConnection makeClient(String connectionId,
                                   Subject subject)
                            throws IOException

Creates a new client connection as an RMI object exported through JRMP. The port and socket factories for the new {@link RMIConnection} object are the ones supplied to the RMIJRMPServerImpl constructor.

Overrides:

makeClient in class RMIServerImpl

Parameters:

connectionId - the ID of the new connection. Every connection opened by this connector server will have a different id. The behavior is unspecified if this parameter is null.

subject - the authenticated subject. Can be null.

Returns:

the newly-created RMIConnection.

Throws:

IOException - if the new {@link RMIConnection} object cannot be created or exported.

toStub

public Remote toStub()
              throws IOException

Returns a serializable stub for this {@link RMIServer} object.

Overrides:

toStub in class RMIServerImpl

Returns:

a serializable stub.

Throws:

IOException - if the stub cannot be obtained - e.g the RMIJRMPServerImpl has not been exported yet.