|Home >> All >> java >> [ rmi Javadoc ]|
|||java.rmi.activation.* (15)||||java.rmi.dgc.* (3)||||java.rmi.registry.* (3)||||java.rmi.server.* (27)|
java.rmi: Javadoc index of package java.rmi.
ActivationGroupDesc: Contains information, necessary to create of recreate the activation objects. The group descriptor contains: The name of the group's class. This class is derived from the ActivationGroup . The group class code location. The marshalled object that contains the group specific initialization information The groups are created by the ActivationGroup.createGroup(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc, long) 55 method that expectes the group class to have the two parameter constructor, the first parameter being the ActivationGroupID and the second the java.rmi.MarshalledObject ...
Naming: The Naming class handles interactions with RMI registries. Each method takes a URL in String form, which points to the RMI registry. The scheme of the URL is irrelevant. The relevant part is: //host:port/name which tells the method how to locate and access the registry. The host and port are both optional, and default to `localhost' and the standard RMI registry port (1099) respectively. The name is simply a string used to refer to a particular service hosted by the registry. The registry does not attempt to interpret this further. RMI services are registered using one of these names, and the same ...
UnmarshalException: Thrown if an exception occurs while unmarshalling parameters or results of a remote method call. This includes: 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 ...
Activatable: A common ancestor for the implementations of the activatable objects. Such objects require persistent access over time and can be activated by the system. The derived classes also implements the needed interface of some remote object and usually have the two parameter constructor, the first parameter being the ActivationID and the second the java.rmi.MarshalledObject . Activatable is the main class that developers need to use to implement and manage activatable objects. It also contains methods for making activatable remote objects that are not derived from the Activatable class.
Remote: Marker interface for interfaces which methods are invokable from outside of this virtual machine through remote method calls. Remote invokable methods of remote object implementations are specified as the methods defined in the implemented remote interfaces. Typically remote object implementations are subclasses of the convenience classes java.rmi.server.UnicastRemoteObject or java.rmi.activation.Activatable implementing one or more remote interfaces indicating their remotely accessible methods. The convenience classes provide implementations for correct remote object creation, hash, equals and ...
VMID: An identifier that is unique accross the all virtual machines. This class is used by distributed garbage collector to identify the virtual machine of the client, but may also be used in various other cases, when such identifier is required. This class separately stores and transfers the host IP address, but will try to do its best also for the case if it failed to determine it. The alternative algorithms are used in java.rmi.server.UID that is part of this class. The VMID's, created on the same host, but in the two separately (parallely) running virtual machines are different.
ActivationSystem: The ActivationSystem registers groups and activatable objects to be activated within those groups. The ActivationSystem cooperates with both the Activator, which activates objects registered via the ActivationSystem, and the ActivationMonitor, which obtains information about active and inactive objects and inactive groups. The activation system if frequently a remote object. As a security mean, all methods in this interface throw java.rmi.AccessException if called from the client that is not reside on the same host as the activation system.
RemoteObjectInvocationHandler: Together with dynamic proxy instance, this class replaces the generated RMI stub (*_Stub) classes that (following 1.5 specification) should be no longer required. It is unusual to use the instances of this class directly in the user program. Such instances are automatically created and returned by java.rmi.registry.Registry or UnicastRemoteObject methods if the remote reference is known but the corresponding stub class is not accessible.
DGC: The DGC implementation is used for the server side during the distributed garbage collection. This interface contains the two methods: dirty and clean. A dirty call is made when a remote reference is unmarshaled in a client. A corresponding clean call is made by client it no longer uses that remote reference. A reference to a remote object is also automatically released after so called lease period that starts after the dirty call is received. It is the client's responsibility to renew the leases, by making additional dirty calls before such leases expire.
ActivationID: Denotes the object that can be activated over time. The instance of the ActivationID for the given object can be obtained in the following ways: via Activatable.register(ActivationDesc) 55 via Activatable constructor via Activatable.exportObject An instance of the ActivationID has the java.rmi.server.UID as its component and hence is globally unique.
ActivationInstantiator: The implementation of this interface creates (instantiates) the new remote objects in response to the activation request. The instantiator is returned by the ActivationGroup that calls ActivationSystem.activeGroup(ActivationGroupID, ActivationInstantiator, long) 55 .
ActivationMonitor: The activation and inactivation event listener. The group obtains this listener via ActivationSystem.activeGroup(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationInstantiator, long) 55 and must notify it when the group objects are activated or inactivated and also when the whole group becomes inactive.
MarshalledObject: A MarshalledObject consists of a serialized object which is marshalled according to the RMI specification. An object passed to the constructor is serialized and tagged with the needed URL to retrieve its class definition for remote usage. If the object is a remote reference its stub is serialized instead. The instance of this marshalled object can be later retrieved by its get() method.
RemoteRef: Represents a handler to the remote object. Each instance of the RemoteStub contains such handler and uses it to invoke remote methods via invoke(Remote, Method, Object, long) 55 .
ObjID: Represents the object identifier, unique for the host that generated it. The ObjID contains inside the integer object identifier that, if needed, may indicated that this is a reference to one of the well known objects on that host (registry, activator or dgc) and the UID that ensures uniqueness.
ActivationDesc: Contains the information, necessary to activate the object. This information includes: the object class name the object group identifier the code location (codebase URL) that can be used to load the class remotely the object restart mode the object specific intialization information
UID: Represents the unique identifier over time for the host which has generated it. It contains time (when created), counter (the number of the UID creation order) and virtual machine id components. The UID can also be constructed specifying a "well known" identifier in the for of short: this identifier defines the UID uniqueness alone.
RMIClassLoader: This class provides a set of public static utility methods for supporting network-based class loading in RMI. These methods are called by RMI's internal marshal streams to implement the dynamic class loading of types for RMI parameters and return values.
NoSuchObjectException: Thrown on an attempt to invoke a call on an object that no longer exists in the remote Virtual Machine. The call may be retransmitted and still obey the semantics of "at most once".
RemoteException: The superclass of exceptions related to RMI (remote method invocation). Classes that implement java.rmi.Remote should list this exception in their throws clause.
ActivationGroupID: This identifier identifies the activation group inside the scope of its activation system. It also contains (and can provide) the reference to the groups activation system.
MarshalException: Thrown if an exception occurs while marshalling data to send in a remote call. The call may not be retransmitted, if the "at most once" semantics are to be preserved.
RMISecurityException: Never thrown, but originally intended to wrap a java.lang.SecurityException in the case of RMI.
ActivationGroup_Stub: A stub class for ActivationGroup implementations.