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 Interface Description Remote TheRemote
interface serves to identify interfaces whose methods may be invoked from a non-local virtual machine. -
Class Summary Class Description MarshalledObject<T> AMarshalledObject
contains a byte stream with the serialized representation of an object given to its constructor.Naming TheNaming
class provides methods for storing and obtaining references to remote objects in a remote object registry.RMISecurityManager Deprecated. UseSecurityManager
instead. -
Exception Summary Exception Description AccessException AnAccessException
is thrown by certain methods of thejava.rmi.Naming
class (specificallybind
,rebind
, andunbind
) and methods of thejava.rmi.activation.ActivationSystem
interface to indicate that the caller does not have permission to perform the action requested by the method call.AlreadyBoundException AnAlreadyBoundException
is thrown if an attempt is made to bind an object in the registry to a name that already has an associated binding.ConnectException AConnectException
is thrown if a connection is refused to the remote host for a remote method call.ConnectIOException AConnectIOException
is thrown if anIOException
occurs while making a connection to the remote host for a remote method call.MarshalException AMarshalException
is thrown if ajava.io.IOException
occurs while marshalling the remote call header, arguments or return value for a remote method call.NoSuchObjectException ANoSuchObjectException
is thrown if an attempt is made to invoke a method on an object that no longer exists in the remote virtual machine.NotBoundException ANotBoundException
is thrown if an attempt is made to lookup or unbind in the registry a name that has no associated binding.RemoteException ARemoteException
is the common superclass for a number of communication-related exceptions that may occur during the execution of a remote method call.RMISecurityException Deprecated. UseSecurityException
instead.ServerError AServerError
is thrown as a result of a remote method invocation when anError
is thrown while processing the invocation on the server, either while unmarshalling the arguments, executing the remote method itself, or marshalling the return value.ServerException AServerException
is thrown as a result of a remote method invocation when aRemoteException
is thrown while processing the invocation on the server, either while unmarshalling the arguments or executing the remote method itself.ServerRuntimeException Deprecated. no replacementStubNotFoundException AStubNotFoundException
is thrown if a valid stub class could not be found for a remote object when it is exported.UnexpectedException AnUnexpectedException
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 thethrows
clause of the method in the remote interface.UnknownHostException AnUnknownHostException
is thrown if ajava.net.UnknownHostException
occurs while creating a connection to the remote host for a remote method call.UnmarshalException AnUnmarshalException
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 ajava.io.IOException
occurs unmarshalling parameters (on the server side) or the return value (on the client side).