RMIJRMPServerImpl JDK 1.6)

Methods

protected void clientClosed (RMIConnection client) throws IOException [Inherited From RMIServerImpl]

Method called when a client connection created by makeClient is closed.

Method called when a client connection created by makeClient is closed. A subclass that defines makeClient must arrange for this method to be called when the resultant object's close method is called. This enables it to be removed from the RMIServerImpl's list of connections. It is not an error for client not to be in that list.

After removing client from the list of connections, this method calls closeClient(client).

Parameters:
- client - the client connection that has been closed.
Throws:
- IOException - if {@link #closeClient} throws this exception.
- NullPointerException - if client is null.

publicsynchronized void close () throws IOException [Inherited From RMIServerImpl]

Closes this connection server.

Closes this connection server. This method first calls the RMIServerImpl.closeServer() method so that no new client connections will be accepted. Then, for each remaining RMIConnection object returned by makeClient, its close method is called.

The behavior when this method is called more than once is unspecified.

If RMIServerImpl.closeServer() throws an IOException, the individual connections are nevertheless closed, and then the IOException is thrown from this method.

If RMIServerImpl.closeServer() returns normally but one or more of the individual connections throws an IOException, then, after closing all the connections, one of those IOExceptions is thrown from this method. If more than one connection throws an IOException, it is unspecified which one is thrown from this method.

Throws:
- IOException - if {@link #closeServer()} or one of the {@link RMIConnection#close()} calls threw IOException.

protected void closeClient (RMIConnection client) throws IOException [Specified in RMIServerImpl]

protected void closeServer () throws IOException [Specified in RMIServerImpl]

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

pack-private RMIConnection doNewClient (Object credentials) throws IOException [Inherited From RMIServerImpl]

This method could be overridden by subclasses defined in this package to perform additional operations specific to the underlying transport before creating the new client connection.

protected void export () throws IOException [Specified in RMIServerImpl]

publicsynchronized ClassLoader getDefaultClassLoader () [Inherited From RMIServerImpl]

Gets the default ClassLoader used by this connector server.

Returns: the default ClassLoader used by this connector server.

See Also: RMIServerImpl.setDefaultClassLoader(java.lang.ClassLoader),

publicsynchronized MBeanServer getMBeanServer () [Inherited From RMIServerImpl]

The MBeanServer to which this connector server is attached.

The MBeanServer to which this connector server is attached. This is the last value passed to RMIServerImpl.setMBeanServer(javax.management.MBeanServer) on this object, or null if that method has never been called.

Returns: the MBeanServer to which this connector is attached.
See Also: RMIServerImpl.setMBeanServer(javax.management.MBeanServer),

pack-privatesynchronized com.sun.jmx.remote.internal.NotificationBuffer getNotifBuffer () [Inherited From RMIServerImpl]

protected String getProtocol () [Specified in RMIServerImpl]

public String getVersion () [Inherited From RMIServerImpl]

protected RMIConnection makeClient (String connectionId, Subject subject) throws IOException [Specified in RMIServerImpl]

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

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.

Returns: the newly-created RMIConnection.
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.
Throws:
- IOException - if the new {@link RMIConnection} object cannot be created or exported.

public RMIConnection newClient (Object credentials) throws IOException [Inherited From RMIServerImpl]

Creates a new client connection.

Creates a new client connection. This method calls makeClient and adds the returned client connection object to an internal list. When this RMIServerImpl is shut down via its RMIServerImpl.close() method, the close() method of each object remaining in the list is called.

The fact that a client connection object is in this internal list does not prevent it from being garbage collected.

Returns: the newly-created RMIConnection. This is usually the object created by makeClient, though an implementation may choose to wrap that object in another object implementing RMIConnection.
Parameters:
- credentials - this object specifies the user-defined credentials to be passed in to the server in order to authenticate the caller before creating the RMIConnection. Can be null.
Throws:
- IOException - if the new client object cannot be created or exported.
- SecurityException - if the given credentials do not allow the server to authenticate the user successfully.
- IllegalStateException - if {@link #getMBeanServer()} is null.

publicsynchronized void setDefaultClassLoader (ClassLoader cl) [Inherited From RMIServerImpl]

Sets the default ClassLoader for this connector server.

Sets the default ClassLoader for this connector server. New client connections will use this classloader. Existing client connections are unaffected.

Parameters:
- cl - the new ClassLoader to be used by this connector server.
See Also: RMIServerImpl.getDefaultClassLoader(),

publicsynchronized void setMBeanServer (MBeanServer mbs) [Inherited From RMIServerImpl]

Sets the MBeanServer to which this connector server is attached.

Sets the MBeanServer to which this connector server is attached. New client connections will interact with this MBeanServer. Existing client connections are unaffected.

Parameters:
- mbs - the new MBeanServer. Can be null, but new client connections will be refused as long as it is.
See Also: RMIServerImpl.getMBeanServer(),

pack-private void setRMIConnectorServer (RMIConnectorServer connServer) throws IOException [Inherited From RMIServerImpl]

public Remote toStub () throws IOException [Specified in RMIServerImpl]

Returns a serializable stub for this RMIServer object.