Generated by
JDiff

java.rmi Documentation Differences

This file contains all the changes in documentation in the package java.rmi as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Class MarshalledObject

A MarshalledObject contains a byte stream with the serialized representation of an object given to its constructor. The get method returns a new copy of the original object as deserialized from the contained byte stream. The contained object is serialized and deserialized with the same serialization semantics used for marshaling and unmarshaling parameters and return values of RMI calls: When the serialized form is created:

When copy of the object is retrieved (via the get method) if the class is not available locally it will be loaded from the appropriate location (specified the URL annotated with the class descriptor when the class was serialized.

MarshalledObject facilitates passing objects in RMI calls that are not automatically deserialized immediately by the remote peer. @version 1.30 1231 02/0320/0102 @author Ann Wollrath @author Peter Jones @since 1.2


Class Naming

The Naming class provides methods for storing and obtaining references to remote objects in thea remote object registry. TheEach method of the Naming class's methods taketakes as one of theirits arguments a name that is a URL formatted java.lang.String in URL format (without the scheme component) of the form:
 //host:port/name 

where host is the host (remote or local) where the registry is located port is the port number on which the registry accepts calls and where name is a simple string uninterpreted by the registry. Both host and port are optional. If host is omitted the host defaults to the local host. If port is omitted then the port defaults to 1099 the "well-known" port that RMI's registry rmiregistry uses.

Binding a name for a remote object is associating or registering a name for a remote object that can be used at a later time to look up that remote object. A remote object can be associated with a name using the Naming class's bind or rebind methods.

Once a remote object is registered (bound) with the RMI registry on the local host callers on a remote (or local) host can lookup the remote object by name obtain its reference and then invoke remote methods on the object. A registry may be shared by all servers running on a host or an individual server process may create and use its own registry if desired (see java.rmi.registry.LocateRegistry.createRegistry method for details). @version 1.13 09/05/99 @author Ann Wollrath @author Roger Riggs @since JDK1.1 @see java.rmi.registry.Registry @see java.rmi.registry.LocateRegistry @see java.rmi.registry.LocateRegistry#createRegistry(int)

Class Naming, void bind(String, Remote)

Binds the specified name to a remote object. @param name a name in URL-formatted nameformat for(without the remotescheme objectcomponent) @param obj a reference for the remote object (usually a stub) @exception AlreadyBoundException if name is already bound @exception MalformedURLException if the name is not an appropriately formatted URL @exception RemoteException if registry could not be contacted @exception AccessException if this operation is not permitted (if originating from a non-local host for example) @since JDK1.1
Class Naming, String[] list(String)

Returns an array of the names bound in the registry. The names are URL-formatted (without the scheme component) strings. The array contains a snapshot of the names present in the registry at the time of the call. @param name a URL-formattedregistry name thatin URL format specifies(without the remotescheme registrycomponent) @return an array of names (in the appropriate URL format) bound in the registry @exception MalformedURLException if the name is not an appropriately formatted URL @exception RemoteException if registry could not be contacted. @since JDK1.1
Class Naming, Remote lookup(String)

Returns a reference a stub for the remote object associated with the specified name. @param name a name in URL-formatted nameformat for(without the remotescheme objectcomponent) @return a reference for a remote object @exception NotBoundException if name is not currently bound @exception RemoteException if registry could not be contacted @exception AccessException if this operation is not permitted @exception MalformedURLException if the name is not an appropriately formatted URL @since JDK1.1
Class Naming, void rebind(String, Remote)

Rebinds the specified name to a new remote object. Any existing binding for the name is replaced. @param name a URL-formatted name associated within URL format (without the remotescheme objectcomponent) @param obj new remote object to associate with the name @exception MalformedURLException if the name is not an appropriately formatted URL @exception RemoteException if registry could not be contacted @exception AccessException if this operation is not permitted (if originating from a non-local host for example) @since JDK1.1
Class Naming, void unbind(String)

Destroys the binding for the specified name that is associated with a remote object. @param name a URL-formatted name associated with ain URL format remote(without objectthe scheme component) @exception NotBoundException if name is not currently bound @exception MalformedURLException if the name is not an appropriately formatted URL @exception RemoteException if registry could not be contacted @exception AccessException if this operation is not permitted (if originating from a non-local host for example) @since JDK1.1

Class Remote

The Remote interface serves to identify interfaces whose methods may be invoked from a non-local virtual machine. Any object that is a remote object must directly or indirectly implement this interface. Only those methods specified in a "remote interface" an interface that extends java.rmi.Remote are available remotely.

Implementation classes can implement any number of remote interfaces and can extend other remote implementation classes. RMI provides some convenience classes that remote object implementations can extend which facilitate remote object creation. These classes are java.rmi.server.UnicastRemoteObject and java.rmi.activation.Activatable.

For complete details on RMI see the RMI Specification which describes the RMI API and system. @version 1.1213 12/03/0118/02 @since JDK1.1 @author Ann Wollrath @see java.rmi.server.UnicastRemoteObject @see java.rmi.activation.Activatable