|
Generated by JDiff |
||||||||
PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES |
This file contains all the changes in documentation in the packagejava.rmi
as colored differences. Deletions are shownlike 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.
AMarshalledObject
contains a byte stream with the serialized representation of an object given to its constructor. Theget
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:
- classes are annotated with a codebase URL from where the class can be loaded (if available) and
- any remote object in the
MarshalledObject
is represented by a serialized instance of its stub.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
TheClass Naming, void bind(String, Remote)Naming
class provides methods for storing and obtaining references to remote objects inthea remote object registry.TheEach method of theNaming
class's methodstaketakes as one oftheirits arguments a name that is aURL formattedjava.lang.String
in URL format (without the scheme component) of the form://host:port/namewhere
host
is the host (remote or local) where the registry is locatedport
is the port number on which the registry accepts calls and wherename
is a simple string uninterpreted by the registry. Bothhost
andport
are optional. Ifhost
is omitted the host defaults to the local host. Ifport
is omitted then the port defaults to 1099 the "well-known" port that RMI's registryrmiregistry
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'sbind
orrebind
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)
Binds the specifiedClass Naming, String[] list(String)name
to a remote object. @param name a name in URL-formattednameformatfor(without theremoteschemeobjectcomponent) @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
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 aClass Naming, Remote lookup(String)URL-formattedregistry namethatin URL formatspecifies(without theremoteschemeregistrycomponent) @return an array of names (in the appropriateURLformat) 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
Returns a reference a stub for the remote object associated with the specifiedClass Naming, void rebind(String, Remote)name
. @param name a name in URL-formattednameformatfor(without theremoteschemeobjectcomponent) @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
Rebinds the specified name to a new remote object. Any existing binding for the name is replaced. @param name aClass Naming, void unbind(String)URL-formattednameassociated within URL format (without theremoteschemeobjectcomponent) @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
Destroys the binding for the specified name that is associated with a remote object. @param name aURL-formattednameassociated with ain URL formatremote(withoutobjectthe 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
TheRemote
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 extendsjava.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
andjava.rmi.activation.Activatable
.For complete details on RMI see the RMI Specification which describes the RMI API and system. @version 1.
121312/03/0118/02 @since JDK1.1 @author Ann Wollrath @see java.rmi.server.UnicastRemoteObject @see java.rmi.activation.Activatable