Generated by
JDiff

java.rmi.dgc Documentation Differences

This file contains all the changes in documentation in the package java.rmi.dgc 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 DGC, void clean(ObjID[], long, VMID, boolean)

The clean call removes the 'vmid' from the reference list of each remote object indicated in 'id's. The sequence number is used to detect late clean calls. If the argument 'strong' is true then the clean call is a result of a failed dirty call thus the sequence number for the client 'vmid' needs to be remembered. @param ids IDs of objects to mark as unreferenced by calling client @param sequenceNum sequence number @param vmid client VMID @param strong make 'strong' clean call @throws RemoteException if clean call fails
Class DGC, Lease dirty(ObjID[], long, Lease)

The dirty call requests leases for the remote object references associated with the object identifiers contained in the array 'ids'. The 'lease' contains a client's unique VM identifier (VMID) and a requested lease period. For each remote object exported in the local VM the garbage collector maintains a reference list-a list of clients that hold references to it. If the lease is granted the garbage collector adds the client's VMID to the reference list for each remote object indicated in 'ids'. The 'sequenceNum' parameter is a sequence number that is used to detect and discard late calls to the garbage collector. The sequence number should always increase for each subsequent call to the garbage collector. Some clients are unable to generate a VMID since a VMID is a universally unique identifier that contains a host address which some clients are unable to obtain due to security restrictions. In this case a client can use a VMID of null and the distributed garbage collector will assign a VMID for the client. The dirty call returns a Lease object that contains the VMID used and the lease period granted for the remote references (a server may decide to grant a smaller lease period than the client requests). A client must use the VMID the garbage collector uses in order to make corresponding clean calls when the client drops remote object references. A client VM need only make one initial dirty call for each remote reference referenced in the VM (even if it has multiple references to the same remote object). The client must also make a dirty call to renew leases on remote references before such leases expire. When the client no longer has any references to a specific remote object it must schedule a clean call for the object ID associated with the reference. @param ids IDs of objects to mark as referenced by calling client @param sequenceNum sequence number @param lease requested lease @return granted lease @throws RemoteException if dirty call fails

Class Lease, constructor Lease(VMID, long)

Constructs a lease with a specific VMID and lease duration. The vmid may be null. @param id VMID associated with this lease @param duration lease duration
Class Lease, VMID getVMID()

Returns the client VMID associated with the lease. @return client VMID
Class Lease, long getValue()

Returns the lease duration. @return lease duration

Class VMID

A VMID is a identifier that is unique across all Java virtual machines. VMIDs are used by the distributed garbage collector to identify client VMs. @version 1.15 0416 02/3002/9900 @author Ann Wollrath @author Peter Jones
Class VMID, boolean isUnique()

Return true if an accurate address can be determined for this host. If false reliable VMID cannot be generated from this host @return true if host address can be determined false otherwise @deprecated