Class RMIJRMPServerImpl
- java.lang.Object
-
- javax.management.remote.rmi.RMIServerImpl
-
- javax.management.remote.rmi.RMIJRMPServerImpl
-
- All Implemented Interfaces:
- Closeable, AutoCloseable, Remote, RMIServer
public class RMIJRMPServerImpl extends RMIServerImpl
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.- Since:
- 1.5
- See Also:
-
RMIServerImpl
-
-
Constructor Summary
Constructors Constructor and Description RMIJRMPServerImpl(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, Map<String,?> env)
Creates a newRMIServer
object that will be exported on the given port using the given socket factories.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description protected void
closeClient(RMIConnection client)
Closes a client connection made bymakeClient
.protected void
closeServer()
Called byRMIServerImpl.close()
to close the connector server by unexporting this object.protected void
export()
Exports this RMI object.protected String
getProtocol()
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.Remote
toStub()
Returns a serializable stub for thisRMIServer
object.-
Methods inherited from class javax.management.remote.rmi.RMIServerImpl
clientClosed, close, getDefaultClassLoader, getMBeanServer, getVersion, newClient, setDefaultClassLoader, setMBeanServer
-
-
-
-
Constructor Detail
RMIJRMPServerImpl
public RMIJRMPServerImpl(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, Map<String,?> env) throws IOException
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 theRMIConnectionImpl
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 theRMIServer
object cannot be created. -
IllegalArgumentException
- ifport
is negative.
-
Method Detail
export
protected void export() throws IOException
Description copied from class:RMIServerImpl
Exports this RMI object.
- Specified by:
-
export
in classRMIServerImpl
- Throws:
-
IOException
- if this RMI object cannot be exported.
getProtocol
protected String getProtocol()
Description copied from class:RMIServerImpl
Returns the protocol string for this object. The string is
rmi
for RMI/JRMP andiiop
for RMI/IIOP.- Specified by:
-
getProtocol
in classRMIServerImpl
- Returns:
- the protocol string for this object.
toStub
public Remote toStub() throws IOException
Returns a serializable stub for this
RMIServer
object.- Specified by:
-
toStub
in classRMIServerImpl
- Returns:
- a serializable stub.
- Throws:
-
IOException
- if the stub cannot be obtained - e.g the RMIJRMPServerImpl has not been exported yet.
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
RMIConnection
object are the ones supplied to theRMIJRMPServerImpl
constructor.- Specified by:
-
makeClient
in classRMIServerImpl
- 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 newRMIConnection
object cannot be created or exported.
closeClient
protected void closeClient(RMIConnection client) throws IOException
Description copied from class:RMIServerImpl
Closes a client connection made by
makeClient
.- Specified by:
-
closeClient
in classRMIServerImpl
- Parameters:
-
client
- a connection previously returned bymakeClient
on which thecloseClient
method has not previously been called. The behavior is unspecified if these conditions are violated, including the case whereclient
is null. - Throws:
-
IOException
- if the client connection cannot be closed.
closeServer
protected void closeServer() throws IOException
Called by
RMIServerImpl.close()
to close the connector server by unexporting this object. After returning from this method, the connector server must not accept any new connections.- Specified by:
-
closeServer
in classRMIServerImpl
- Throws:
-
IOException
- if the attempt to close the connector server failed.
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.