public class

RMIJRMPServerImpl

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

Class Overview

An 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.

See Also

Summary

Public Constructors
RMIJRMPServerImpl(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, Map<String, ?> env)

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

Public Methods
Remote toStub()

Returns a serializable stub for this RMIServer object.

Protected Methods
void closeClient(RMIConnection client)

Closes a client connection made by makeClient.

void closeServer()

Called by close() to close the connector server by unexporting this object.

void export()

Exports this RMI object.

String getProtocol()

Returns the protocol string for this object.

RMIConnection makeClient(String connectionId, Subject subject)

Creates a new client connection as an RMI object exported through JRMP.

[Expand]
Inherited Methods
From class javax.management.remote.rmi.RMIServerImpl
From class java.lang.Object
From interface java.io.Closeable
From interface javax.management.remote.rmi.RMIServer

Public Constructors

public RMIJRMPServerImpl (int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, Map<String, ?> env)

Creates a new 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 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 RMIServer object cannot be created.
IllegalArgumentException if port is negative.

Public Methods

public Remote toStub ()

Returns a serializable stub for this RMIServer object.

Returns
  • a serializable stub.
Throws
IOException if the stub cannot be obtained - e.g the RMIJRMPServerImpl has not been exported yet.

Protected Methods

protected void closeClient (RMIConnection client)

Closes a client connection made by makeClient.

Parameters
client a connection previously returned by makeClient on which the closeClient method has not previously been called. The behavior is unspecified if these conditions are violated, including the case where client is null.
Throws
IOException

protected void closeServer ()

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

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

protected void export ()

Exports this RMI object.

Throws
IOException

protected String getProtocol ()

Returns the protocol string for this object. The string is rmi for RMI/JRMP and iiop for RMI/IIOP.

Returns
  • the protocol string for this object.

protected RMIConnection makeClient (String connectionId, Subject subject)

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

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 RMIConnection object cannot be created or exported.