JavaTM 2 Platform
Std. Ed. v1.4.2

Uses of Class
java.rmi.RemoteException

Packages that use RemoteException
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.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. 
 

Uses of RemoteException in java.rmi
 

Subclasses of RemoteException in java.rmi
 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, executing the remote method itself, or marshalling the return value.
 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).
 

Methods in java.rmi that throw RemoteException
static Remote Naming.lookup(String name)
          Returns a reference, a stub, for the remote object associated with the specified name.
static void Naming.bind(String name, Remote obj)
          Binds the specified name to a remote object.
static void Naming.unbind(String name)
          Destroys the binding for the specified name that is associated with a remote object.
static void Naming.rebind(String name, Remote obj)
          Rebinds the specified name to a new remote object.
static String[] Naming.list(String name)
          Returns an array of the names bound in the registry.
 

Uses of RemoteException in java.rmi.activation
 

Subclasses of RemoteException in java.rmi.activation
 class ActivateFailedException
          This exception is thrown by the RMI runtime when activation fails during a remote call to an activatable object.
 

Methods in java.rmi.activation that throw RemoteException
 MarshalledObject ActivationGroup_Stub.newInstance(ActivationID id, ActivationDesc desc)
          Stub method for ActivationGroup.newInstance.
 boolean ActivationGroup.inactiveObject(ActivationID id)
          The group's inactiveObject method is called indirectly via a call to the Activatable.inactive method.
abstract  void ActivationGroup.activeObject(ActivationID id, Remote obj)
          The group's activeObject method is called when an object is exported (either by Activatable object construction or an explicit call to Activatable.exportObject.
protected  void ActivationGroup.activeObject(ActivationID id, MarshalledObject mobj)
          This protected method is necessary for subclasses to make the activeObject callback to the group's monitor.
protected  void ActivationGroup.inactiveGroup()
          This protected method is necessary for subclasses to make the inactiveGroup callback to the group's monitor.
 void ActivationMonitor.inactiveObject(ActivationID id)
          An activation group calls its monitor's inactiveObject method when an object in its group becomes inactive (deactivates).
 void ActivationMonitor.activeObject(ActivationID id, MarshalledObject obj)
          Informs that an object is now active.
 void ActivationMonitor.inactiveGroup(ActivationGroupID id, long incarnation)
          Informs that the group is now inactive.
 MarshalledObject ActivationInstantiator.newInstance(ActivationID id, ActivationDesc desc)
          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.
 ActivationID ActivationSystem.registerObject(ActivationDesc desc)
          The registerObject method is used to register an activation descriptor, desc, and obtain an activation identifier for a activatable remote object.
 void ActivationSystem.unregisterObject(ActivationID id)
          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.
 ActivationGroupID ActivationSystem.registerGroup(ActivationGroupDesc desc)
          Register the activation group.
 ActivationMonitor ActivationSystem.activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)
          Callback to inform activation system that group is now active.
 void ActivationSystem.unregisterGroup(ActivationGroupID id)
          Remove the activation group.
 void ActivationSystem.shutdown()
          Shutdown the activation system.
 ActivationDesc ActivationSystem.setActivationDesc(ActivationID id, ActivationDesc desc)
          Set the activation descriptor, desc for the object with the activation identifier, id.
 ActivationGroupDesc ActivationSystem.setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)
          Set the activation group descriptor, desc for the object with the activation group identifier, id.
 ActivationDesc ActivationSystem.getActivationDesc(ActivationID id)
          Returns the activation descriptor, for the object with the activation identifier, id.
 ActivationGroupDesc ActivationSystem.getActivationGroupDesc(ActivationGroupID id)
          Returns the activation group descriptor, for the group with the activation group identifier, id.
 MarshalledObject Activator.activate(ActivationID id, boolean force)
          Activate the object associated with the activation identifier, id.
 Remote ActivationID.activate(boolean force)
          Activate the object for this id.
static Remote Activatable.register(ActivationDesc desc)
          Register an object descriptor for an activatable remote object so that is can be activated on demand.
static boolean Activatable.inactive(ActivationID id)
          Informs the system that the object with the corresponding activation id is currently inactive.
static void Activatable.unregister(ActivationID id)
          Revokes previous registration for the activation descriptor associated with id.
static ActivationID Activatable.exportObject(Remote obj, String location, MarshalledObject data, boolean restart, int port)
          This exportObject method may be invoked explicitly by an "activatable" object, that does not extend the Activatable class, in order to both a) register the object's activation descriptor, constructed from the supplied location, and data, with the activation system (so the object can be activated), and b) export the remote object, obj, on a specific port (if port=0, then an anonymous port is chosen).
static ActivationID Activatable.exportObject(Remote obj, String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          This exportObject method may be invoked explicitly by an "activatable" object, that does not extend the Activatable class, in order to both a) register the object's activation descriptor, constructed from the supplied location, and data, with the activation system (so the object can be activated), and b) export the remote object, obj, on a specific port (if port=0, then an anonymous port is chosen).
static Remote Activatable.exportObject(Remote obj, ActivationID id, int port)
          Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.
static Remote Activatable.exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          Export the activatable remote object to the RMI runtime to make the object available to receive incoming calls.
 

Constructors in java.rmi.activation that throw RemoteException
ActivationGroup(ActivationGroupID groupID)
          Constructs an activation group with the given activation group identifier.
Activatable(String location, MarshalledObject data, boolean restart, int port)
          Constructor used to register and export the object on a specified port (an anonymous port is chosen if port=0) .
Activatable(String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          Constructor used to register and export the object on a specified port (an anonymous port is chosen if port=0) .
Activatable(ActivationID id, int port)
          Constructor used to activate/export the object on a specified port.
Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          Constructor used to activate/export the object on a specified port.
 

Uses of RemoteException in java.rmi.dgc
 

Methods in java.rmi.dgc that throw RemoteException
 Lease DGC.dirty(ObjID[] ids, long sequenceNum, Lease lease)
          The dirty call requests leases for the remote object references associated with the object identifiers contained in the array 'ids'.
 void DGC.clean(ObjID[] ids, long sequenceNum, VMID vmid, boolean strong)
          The clean call removes the 'vmid' from the reference list of each remote object indicated in 'id's.
 

Uses of RemoteException in java.rmi.registry
 

Methods in java.rmi.registry that throw RemoteException
 Registry RegistryHandler.registryStub(String host, int port)
          Deprecated. no replacement. As of the Java 2 platform v1.2, RMI no longer uses the RegistryHandler to obtain the registry's stub.
 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.
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 host)
          Returns a reference to the remote object Registry on the specified host on the default registry port of 1099.
static Registry LocateRegistry.getRegistry(String host, int port)
          Returns a reference to the remote object Registry on the specified host and port.
static Registry LocateRegistry.getRegistry(String host, int port, RMIClientSocketFactory csf)
          Returns a locally created remote reference to the remote object Registry on the specified host and port.
static Registry LocateRegistry.createRegistry(int port)
          Creates and exports a Registry on the local host that accepts requests on the specified port.
static Registry LocateRegistry.createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          Creates and exports a Registry on the local host that uses custom socket factories for communication with that registry.
 Remote Registry.lookup(String name)
          Returns the remote reference bound to the specified name in this registry.
 void Registry.bind(String name, Remote obj)
          Binds a remote reference to the specified name in this registry.
 void Registry.unbind(String name)
          Removes the binding for the specified name in this registry.
 void Registry.rebind(String name, Remote obj)
          Replaces the binding for the specified name in this registry with the supplied remote reference.
 String[] Registry.list()
          Returns an array of the names bound in this registry.
 

Uses of RemoteException in java.rmi.server
 

Subclasses of RemoteException in java.rmi.server
 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
          A SocketSecurityException is thrown during remote object export if the code exporting the remote object (either by construction or by explicit call to the exportObject method of UnicastRemoteObject or java.rmi.activation.Activatable) does not have permission to create a java.net.ServerSocket on the port number specified during remote object export.
 

Methods in java.rmi.server that throw RemoteException
static RemoteStub UnicastRemoteObject.exportObject(Remote obj)
          Exports the remote object to make it available to receive incoming calls using an anonymous port.
static Remote UnicastRemoteObject.exportObject(Remote obj, int port)
          Exports the remote object to make it available to receive incoming calls, using the particular supplied port.
static Remote UnicastRemoteObject.exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          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 obj, Object data)
          Creates a client stub object for the supplied Remote object.
 RemoteCall RemoteRef.newCall(RemoteObject obj, Operation[] op, int opnum, long hash)
          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.

1.2 stubs are generated using rmic -v1.2. By default, rmic generates stubs compatible with JDK1.1 and the Java 2 SDK. The compatible stubs can also be generated using rmic -vcompat.

 void RemoteRef.done(RemoteCall call)
          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.

1.2 stubs are generated using rmic -v1.2. By default, rmic generates stubs compatible with JDK1.1 and the Java 2 SDK. The compatible stubs can also be generated using rmic -vcompat.

 

Constructors in java.rmi.server that throw RemoteException
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 csf, RMIServerSocketFactory ssf)
          Creates and exports a new UnicastRemoteObject object using the particular supplied port and socket factories.
 

Uses of RemoteException in javax.rmi
 

Methods in javax.rmi that throw RemoteException
static void PortableRemoteObject.exportObject(Remote obj)
          Makes a server object ready to receive remote calls.
static void PortableRemoteObject.connect(Remote target, Remote source)
          Makes a Remote object ready for remote communication.
 

Constructors in javax.rmi that throw RemoteException
PortableRemoteObject()
          Initializes the object by calling exportObject(this).
 

Uses of RemoteException in javax.rmi.CORBA
 

Methods in javax.rmi.CORBA that return RemoteException
 RemoteException UtilDelegate.mapSystemException(SystemException ex)
          Delegation call for Util.mapSystemException(org.omg.CORBA.SystemException).
 RemoteException UtilDelegate.wrapException(Throwable obj)
          Delegation call for Util.wrapException(java.lang.Throwable).
static RemoteException Util.mapSystemException(SystemException ex)
          Maps a SystemException to a RemoteException.
static RemoteException Util.wrapException(Throwable orig)
          Wraps an exception thrown by an implementation method.
 

Methods in javax.rmi.CORBA that throw RemoteException
 boolean UtilDelegate.isLocal(Stub stub)
          Delegation call for Util.isLocal(javax.rmi.CORBA.Stub).
 Object UtilDelegate.copyObject(Object obj, ORB orb)
          Delegation call for Util.copyObject(java.lang.Object, org.omg.CORBA.ORB).
 Object[] UtilDelegate.copyObjects(Object[] obj, ORB orb)
          Delegation call for Util.copyObjects(java.lang.Object[], org.omg.CORBA.ORB).
static boolean Util.isLocal(Stub stub)
          The isLocal method has the same semantics as the ObjectImpl._is_local method, except that it can throw a RemoteException.
static Object[] Util.copyObjects(Object[] obj, ORB orb)
          Copies or connects an array of objects.
static Object Util.copyObject(Object obj, ORB orb)
          Copies or connects an object.
 void StubDelegate.connect(Stub self, ORB orb)
          Delegation call for Stub.connect(org.omg.CORBA.ORB).
 void Stub.connect(ORB orb)
          Connects this stub to an ORB.
 void PortableRemoteObjectDelegate.exportObject(Remote obj)
          Delegation call for PortableRemoteObject.exportObject(java.rmi.Remote).
 void PortableRemoteObjectDelegate.connect(Remote target, Remote source)
          Delegation call for PortableRemoteObject.connect(java.rmi.Remote, java.rmi.Remote).
 

Uses of RemoteException in javax.transaction
 

Subclasses of RemoteException in javax.transaction
 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.
 


JavaTM 2 Platform
Std. Ed. v1.4.2

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.