| Package | Description |
|---|---|
| java.rmi |
Provides the RMI package.
|
| java.rmi.activation |
Provides support for RMI Object Activation.
|
| java.rmi.dgc |
Provides classes and interface for RMI distributed garbage-collection (DGC).
|
| java.rmi.registry |
Provides a class and two interfaces for the RMI registry.
|
| java.rmi.server |
Provides classes and interfaces for supporting the server side of RMI.
|
| javax.activity |
Contains Activity service related exceptions thrown by the ORB machinery during unmarshalling.
|
| javax.management.remote.rmi |
The RMI connector is a connector for the JMX Remote API that uses RMI to transmit client requests to a remote MBean server.
|
| javax.rmi |
Contains user APIs for RMI-IIOP.
|
| javax.rmi.CORBA |
Contains portability APIs for RMI-IIOP.
|
| javax.transaction |
Contains three exceptions thrown by the ORB machinery during unmarshalling.
|
| Modifier and Type | Class and Description |
|---|---|
class |
AccessException
An
AccessException is thrown by certain methods of the
java.rmi.Naming class (specifically
bind,
rebind, and
unbind) and methods of the
java.rmi.activation.ActivationSystem interface to indicate that the caller does not have permission to perform the action requested by the method call.
|
class |
ConnectException
A
ConnectException is thrown if a connection is refused to the remote host for a remote method call.
|
class |
ConnectIOException
A
ConnectIOException is thrown if an
IOException occurs while making a connection to the remote host for a remote method call.
|
class |
MarshalException
A
MarshalException is thrown if a
java.io.IOException occurs while marshalling the remote call header, arguments or return value for a remote method call.
|
class |
NoSuchObjectException
A
NoSuchObjectException is thrown if an attempt is made to invoke a method on an object that no longer exists in the remote virtual machine.
|
class |
ServerError
A
ServerError is thrown as a result of a remote method invocation when an
Error is thrown while processing the invocation on the server, either while unmarshalling the arguments, executing the remote method itself, or marshalling the return value.
|
class |
ServerException
A
ServerException is thrown as a result of a remote method invocation when a
RemoteException is thrown while processing the invocation on the server, either while unmarshalling the arguments or executing the remote method itself.
|
class |
ServerRuntimeException
Deprecated.
no replacement
|
class |
StubNotFoundException
A
StubNotFoundException is thrown if a valid stub class could not be found for a remote object when it is exported.
|
class |
UnexpectedException
An
UnexpectedException is thrown if the client of a remote method call receives, as a result of the call, a checked exception that is not among the checked exception types declared in the
throws clause of the method in the remote interface.
|
class |
UnknownHostException
An
UnknownHostException is thrown if a
java.net.UnknownHostException occurs while creating a connection to the remote host for a remote method call.
|
class |
UnmarshalException
An
UnmarshalException can be thrown while unmarshalling the parameters or results of a remote method call if any of the following conditions occur: if an exception occurs while unmarshalling the call header if the protocol for the return value is invalid if a
java.io.IOException occurs unmarshalling parameters (on the server side) or the return value (on the client side).
|
| Modifier and Type | Method and Description |
|---|---|
static void |
Naming.bind(String
Binds the specified
name to a remote object.
|
static String |
Naming.list(String
Returns an array of the names bound in the registry.
|
static Remote |
Naming.lookup(String
Returns a reference, a stub, for the remote object associated with the specified
name.
|
static void |
Naming.rebind(String
Rebinds the specified name to a new remote object.
|
static void |
Naming.unbind(String
Destroys the binding for the specified name that is associated with a remote object.
|
| Modifier and Type | Class and Description |
|---|---|
class |
ActivateFailedException
This exception is thrown by the RMI runtime when activation fails during a remote call to an activatable object.
|
| Modifier and Type | Method and Description |
|---|---|
MarshalledObject |
Activator.activate(ActivationID
Activate the object associated with the activation identifier,
id.
|
Remote |
ActivationID.activate(boolean force)
Activate the object for this id.
|
ActivationMonitor |
ActivationSystem.activeGroup(ActivationGroupID
Callback to inform activation system that group is now active.
|
void |
ActivationMonitor.activeObject(ActivationID
Informs that an object is now active.
|
protected void |
ActivationGroup.activeObject(ActivationID
This protected method is necessary for subclasses to make the
activeObject callback to the group's monitor.
|
abstract void |
ActivationGroup.activeObject(ActivationID
The group's
activeObject method is called when an object is exported (either by
Activatable object construction or an explicit call to
Activatable.exportObject.
|
static Remote |
Activatable.exportObject(Remote
Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.
|
static Remote |
Activatable.exportObject(Remote
Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.
|
static ActivationID |
Activatable.exportObject(Remote
Registers an activation descriptor (with the specified location, data, and restart mode) for the specified object, and exports that object with the specified port.
|
static ActivationID |
Activatable.exportObject(Remote
Registers an activation descriptor (with the specified location, data, and restart mode) for the specified object, and exports that object with the specified port, and the specified client and server socket factories.
|
ActivationDesc |
ActivationSystem.getActivationDesc(ActivationID
Returns the activation descriptor, for the object with the activation identifier,
id.
|
ActivationGroupDesc |
ActivationSystem.getActivationGroupDesc(ActivationGroupID
Returns the activation group descriptor, for the group with the activation group identifier,
id.
|
static boolean |
Activatable.inactive(ActivationID
Informs the system that the object with the corresponding activation
id is currently inactive.
|
protected void |
ActivationGroup.inactiveGroup()
This protected method is necessary for subclasses to make the
inactiveGroup callback to the group's monitor.
|
void |
ActivationMonitor.inactiveGroup(ActivationGroupID
Informs that the group is now inactive.
|
void |
ActivationMonitor.inactiveObject(ActivationID
An activation group calls its monitor's
inactiveObject method when an object in its group becomes inactive (deactivates).
|
boolean |
ActivationGroup.inactiveObject(ActivationID
The group's
inactiveObject method is called indirectly via a call to the
Activatable.inactive method.
|
MarshalledObject |
ActivationInstantiator.newInstance(ActivationID
The activator calls an instantiator's
newInstance method in order to recreate in that group an object with the activation identifier,
id, and descriptor,
desc.
|
static Remote |
Activatable.register(ActivationDesc
Register an object descriptor for an activatable remote object so that is can be activated on demand.
|
ActivationGroupID |
ActivationSystem.registerGroup(ActivationGroupDesc
Register the activation group.
|
ActivationID |
ActivationSystem.registerObject(ActivationDesc
The
registerObject method is used to register an activation descriptor,
desc, and obtain an activation identifier for a activatable remote object.
|
ActivationDesc |
ActivationSystem.setActivationDesc(ActivationID
Set the activation descriptor,
desc for the object with the activation identifier,
id.
|
ActivationGroupDesc |
ActivationSystem.setActivationGroupDesc(ActivationGroupID
Set the activation group descriptor,
desc for the object with the activation group identifier,
id.
|
void |
ActivationSystem.shutdown()
Shutdown the activation system.
|
static void |
Activatable.unregister(ActivationID
Revokes previous registration for the activation descriptor associated with
id.
|
void |
ActivationSystem.unregisterGroup(ActivationGroupID
Remove the activation group.
|
void |
ActivationSystem.unregisterObject(ActivationID
Remove the activation id and associated descriptor previously registered with the
ActivationSystem; the object can no longer be activated via the object's activation id.
|
| Constructor and Description | |
|---|---|
Activatable(ActivationID
Constructor used to activate/export the object on a specified port.
|
|
Activatable(ActivationID
Constructor used to activate/export the object on a specified port.
|
|
Activatable(String
Constructs an activatable remote object by registering an activation descriptor (with the specified location, data, and restart mode) for this object, and exporting the object with the specified port.
|
|
Activatable(String
Constructs an activatable remote object by registering an activation descriptor (with the specified location, data, and restart mode) for this object, and exporting the object with the specified port, and specified client and server socket factories.
|
|
ActivationGroup(ActivationGroupID
Constructs an activation group with the given activation group identifier.
|
| Modifier and Type | Method and Description |
|---|---|
void |
DGC.clean(ObjID
The clean call removes the 'vmid' from the reference list of each remote object indicated in 'id's.
|
Lease |
DGC.dirty(ObjID
The dirty call requests leases for the remote object references associated with the object identifiers contained in the array 'ids'.
|
| Modifier and Type | Method and Description |
|---|---|
void |
Registry.bind(String
Binds a remote reference to the specified
name in this registry.
|
static Registry |
LocateRegistry.createRegistry(int port)
Creates and exports a
Registry instance on the local host that accepts requests on the specified
port.
|
static Registry |
LocateRegistry.createRegistry(int port, RMIClientSocketFactory
Creates and exports a
Registry instance on the local host that uses custom socket factories for communication with that instance.
|
static Registry |
LocateRegistry.getRegistry()
Returns a reference to the the remote object
Registry for the local host on the default registry port of 1099.
|
static Registry |
LocateRegistry.getRegistry(int port)
Returns a reference to the the remote object
Registry for the local host on the specified
port.
|
static Registry |
LocateRegistry.getRegistry(String
Returns a reference to the remote object
Registry on the specified
host on the default registry port of 1099.
|
static Registry |
LocateRegistry.getRegistry(String
Returns a reference to the remote object
Registry on the specified
host and
port.
|
static Registry |
LocateRegistry.getRegistry(String
Returns a locally created remote reference to the remote object
Registry on the specified
host and
port.
|
String |
Registry.list()
Returns an array of the names bound in this registry.
|
Remote |
Registry.lookup(String
Returns the remote reference bound to the specified
name in this registry.
|
void |
Registry.rebind(String
Replaces the binding for the specified
name in this registry with the supplied remote reference.
|
Registry |
RegistryHandler.registryImpl(int port)
Deprecated.
no replacement. As of the Java 2 platform v1.2, RMI no longer uses the
RegistryHandler to obtain the registry's implementation.
|
Registry |
RegistryHandler.registryStub(String
Deprecated.
no replacement. As of the Java 2 platform v1.2, RMI no longer uses the
RegistryHandler to obtain the registry's stub.
|
void |
Registry.unbind(String
Removes the binding for the specified
name in this registry.
|
| Modifier and Type | Class and Description |
|---|---|
class |
ExportException
An
ExportException is a
RemoteException thrown if an attempt to export a remote object fails.
|
class |
SkeletonMismatchException
Deprecated.
no replacement. Skeletons are no longer required for remote method calls in the Java 2 platform v1.2 and greater.
|
class |
SkeletonNotFoundException
Deprecated.
no replacement. Skeletons are no longer required for remote method calls in the Java 2 platform v1.2 and greater.
|
class |
SocketSecurityException
Deprecated.
This class is obsolete. Use
ExportException instead.
|
| Modifier and Type | Method and Description |
|---|---|
void |
RemoteRef.done(RemoteCall
Deprecated.
1.2 style stubs no longer use this method. Instead of using a sequence of method calls to the remote reference (
newCall, invoke, and done), a stub uses a single method, invoke(Remote, Method, Object[], int), on the remote reference to carry out parameter marshalling, remote method executing and unmarshalling of the return value.
|
static RemoteStub |
UnicastRemoteObject.exportObject(Remote
Deprecated.
This method is deprecated because it supports only static stubs. Use
exportObject(Remote, port) or exportObject(Remote, port, csf, ssf) instead.
|
static Remote |
UnicastRemoteObject.exportObject(Remote
Exports the remote object to make it available to receive incoming calls, using the particular supplied port.
|
static Remote |
UnicastRemoteObject.exportObject(Remote
Exports the remote object to make it available to receive incoming calls, using a transport specified by the given socket factory.
|
RemoteStub |
ServerRef.exportObject(Remote
Deprecated.
Creates a client stub object for the supplied Remote object.
|
RemoteCall |
RemoteRef.newCall(RemoteObject
Deprecated.
1.2 style stubs no longer use this method. Instead of using a sequence of method calls on the stub's the remote reference (
newCall, invoke, and done), a stub uses a single method, invoke(Remote, Method, Object[], int), on the remote reference to carry out parameter marshalling, remote method executing and unmarshalling of the return value.
|
| Constructor and Description | |
|---|---|
UnicastRemoteObject()
Creates and exports a new UnicastRemoteObject object using an anonymous port.
|
|
UnicastRemoteObject(int port)
Creates and exports a new UnicastRemoteObject object using the particular supplied port.
|
|
UnicastRemoteObject(int port, RMIClientSocketFactory
Creates and exports a new UnicastRemoteObject object using the particular supplied port and socket factories.
|
| Modifier and Type | Class and Description |
|---|---|
class |
ActivityCompletedException
This exception may be thrown on any method for which Activity context is accessed and indicates that ongoing work within the Activity is not possible.
|
class |
ActivityRequiredException
This exception is thrown by a container if Activity context is not received on a method for which Activity context is mandatory.
|
class |
InvalidActivityException
This exception may be thrown on any method for which Activity context is accessed and indicates that the attempted invocation or the Activity context associated with the attempted invocation is incompatible with the Activity's current state.
|
| Modifier and Type | Method and Description |
|---|---|
String |
RMIServer.getVersion()
The version of the RMI Connector Protocol understood by this connector server.
|
| Modifier and Type | Method and Description |
|---|---|
static void |
PortableRemoteObject.connect(Remote
Makes a Remote object ready for remote communication.
|
static void |
PortableRemoteObject.exportObject(Remote
Makes a server object ready to receive remote calls.
|
| Constructor and Description | |
|---|---|
PortableRemoteObject()
Initializes the object by calling
exportObject(this).
|
| Modifier and Type | Method and Description |
|---|---|
static RemoteException |
Util.mapSystemException(SystemException
Maps a SystemException to a RemoteException.
|
RemoteException |
UtilDelegate.mapSystemException(SystemException
Delegation call for
Util.
|
static RemoteException |
Util.wrapException(Throwable
Wraps an exception thrown by an implementation method.
|
RemoteException |
UtilDelegate.wrapException(Throwable
Delegation call for
Util.
|
| Modifier and Type | Method and Description |
|---|---|
void |
Stub.connect(ORB
Connects this stub to an ORB.
|
void |
PortableRemoteObjectDelegate.connect(Remote
Delegation call for
PortableRemoteObject.
|
void |
StubDelegate.connect(Stub
Delegation call for
Stub.
|
static Object |
Util.copyObject(Object
Copies or connects an object.
|
Object |
UtilDelegate.copyObject(Object
Delegation call for
Util.
|
static Object |
Util.copyObjects(Object
Copies or connects an array of objects.
|
Object |
UtilDelegate.copyObjects(Object
Delegation call for
Util.
|
void |
PortableRemoteObjectDelegate.exportObject(Remote
Delegation call for
PortableRemoteObject.
|
static boolean |
Util.isLocal(Stub
The
isLocal method has the same semantics as the
ObjectImpl._is_local method, except that it can throw a
RemoteException.
|
boolean |
UtilDelegate.isLocal(Stub
Delegation call for
Util.
|
| Modifier and Type | Class and Description |
|---|---|
class |
InvalidTransactionException
This exception indicates that the request carried an invalid transaction context.
|
class |
TransactionRequiredException
This exception indicates that a request carried a null transaction context, but the target object requires an activate transaction.
|
class |
TransactionRolledbackException
This exception indicates that the transaction associated with processing of the request has been rolled back, or marked to roll back.
|