Top Description Interfaces Classes

module java.rmi

Package java.rmi

Provides the RMI package. RMI is Remote Method Invocation. It is a mechanism that enables an object on one Java virtual machine to invoke methods on an object in another Java virtual machine. Any object that can be invoked this way must implement the Remote interface. When such an object is invoked, its arguments are ``marshalled'' and sent from the local virtual machine to the remote one, where the arguments are ``unmarshalled.'' When the method terminates, the results are marshalled from the remote machine and sent to the caller's virtual machine. If the method invocation results in an exception being thrown, the exception is indicated to caller.

Since: 1.1

Interface Summary

Modifier and Type	Interface and Description
public interface	Remote The `Remote` interface serves to identify interfaces whose methods may be invoked from a non-local virtual machine.

Class Summary

Modifier and Type	Class and Description
public class	AccessException An `AccessException` is thrown by certain methods of the `java.rmi.Naming` class (specifically `bind`, `rebind`, and `unbind`) to indicate that the caller does not have permission to perform the action requested by the method call.
public class	AlreadyBoundException An `AlreadyBoundException` is thrown if an attempt is made to bind an object to a name that already has an associated binding in the registry.
public class	ConnectException A `ConnectException` is thrown if a connection is refused to the remote host for a remote method call.
public class	ConnectIOException A `ConnectIOException` is thrown if an `IOException` occurs while making a connection to the remote host for a remote method call.
public 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.
public class	MarshalledObject< the type of the object contained in this `MarshalledObject` T> A `MarshalledObject` contains a byte stream with the serialized representation of an object given to its constructor.
public class	Naming The `Naming` class provides methods for storing and obtaining references to remote objects in a remote object registry.
public 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.
public class	NotBoundException A `NotBoundException` is thrown if an attempt is made to lookup or unbind in the registry a name that has no associated binding.
public class	RemoteException A `RemoteException` is the common superclass for a number of communication-related exceptions that may occur during the execution of a remote method call.
public class	RMISecurityException Deprecated Use `java.lang.SecurityException` instead. An `RMISecurityException` signals that a security exception has occurred during the execution of one of `java.rmi.RMISecurityManager`'s methods.
public class	RMISecurityManager Deprecated for removal since 1.8. This class is only useful in conjunction with the Security Manager, which is deprecated and subject to removal in a future release. `RMISecurityManager` implements a policy identical to the policy implemented by `SecurityManager`.
public 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.
public 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.
public class	ServerRuntimeException Deprecated no replacement From a server executing on JDK 1.1, a `ServerRuntimeException` is thrown as a result of a remote method invocation when a `RuntimeException` is thrown while processing the invocation on the server, either while unmarshalling the arguments, executing the remote method itself, or marshalling the return value.
public class	StubNotFoundException A `StubNotFoundException` is thrown if a valid stub class could not be found for a remote object when it is exported.
public 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.
public 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.
public 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). if a `java.lang.ClassNotFoundException` occurs during unmarshalling parameters or return values if no skeleton can be loaded on the server-side; note that skeletons are required in the 1.1 stub protocol, but not in the 1.2 stub protocol. if the method hash is invalid (i.e., missing method). if there is a failure to create a remote reference object for a remote object's stub when it is unmarshalled.