CONTENTS | PREV | NEXT | Java Remote Method Invocation |
DGC
Interface
The DGC abstraction is used for the server side of the distributed garbage collection algorithm. This interface contains the two methods:dirty
andclean
. Adirty
call is made when a remote reference is unmarshaled in a client (the client is indicated by its VMID). A corresponding clean call is made when no more references to the remote reference exist in the client. A failed dirty call must schedule a strong clean call so that the call's sequence number can be retained in order to detect future calls received out of order by the distributed garbage collector.A reference to a remote object is leased for a period of time by the client holding the reference. The lease period starts when the
dirty
call is received. It is the client's responsibility to renew the leases, by making additionaldirty
calls, on the remote references it holds before such leases expire. If the client does not renew the lease before it expires, the distributed garbage collector assumes that the remote object is no longer referenced by that client.
package java.rmi.dgc;import java.rmi.server.ObjID; public interface DGC extends java.rmi.Remote { Lease dirty(ObjID[] ids, long sequenceNum, Lease lease) throws java.rmi.RemoteException; void clean(ObjID[] ids, long seqNum, VMID vmid, boolean strong) throws java.rmi.RemoteException; }
Thedirty
method requests leases for the remote object references associated with the object identifiers contained in the array argument ids. The lease contains a client's unique virtual machine identifier (VMID) and a requested lease period. For each remote object exported in the local virtual machine, 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 unique VMID. This is because a VMID is a universally unique identifier only if it contains a true host address, an 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 aLease
object that contains the VMID used and the lease period granted for the remote references. (A server can 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 correspondingclean
calls when the client drops remote object references.A client virtual machine need only make one initial
dirty
call for each remote reference referenced in the virtual machine (even if it has multiple references to the same remote object). The client must also make adirty
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 aclean
call for the object ID associated with the reference.The
clean
call removes theVMID
from the reference list of each remote object indicated in ids. The sequence number is used to detect lateclean
calls. If the strong argument istrue
, then theclean
call is a result of a faileddirty
call, and the sequence number for the clientVMID
therefore needs to be remembered.
CONTENTS | PREV | NEXT
Copyright © 1997-1999 Sun Microsystems, Inc. All Rights Reserved.