org.apache.river.jeri.internal.runtime

Class DgcClient

java.lang.Object

org.apache.river.jeri.internal.runtime.DgcClient

public final class DgcClient
extends Object

Jeri ERI client-side DGC implementation. This class specializes AbstractDgcClient to use net.jini.jeri.Endpoint for transport endpoints, net.jini.id.Uuid for object identifiers, and net.jini.jeri.BasicObjectEndpoint for live remote references. This class's DgcProxy implementation maps dirty and clean calls to remote invocations on the DgcServer remote interface, through a BasicInvocationHandler and a BasicObjectEndpoint with the DgcProxy's Endpoint and the well-known Uuid for the Jini ERI server-side DGC implementation remote object.

Author:

Sun Microsystems, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractDgcClient.DgcProxy A DgcProxy is a proxy for invoking DGC operations on a server-side DGC implementation at a particular endpoint.

Constructor Summary

Constructors

Constructor and Description
DgcClient()

Method Summary

Modifier and Type	Method and Description
protected void	freeEndpoint(Endpoint endpoint) Indicates that resources for the given endpoint may be freed.
protected AbstractDgcClient.DgcProxy	getDgcProxy(Endpoint endpoint) Returns a proxy for making DGC calls to the given endpoint.
protected org.apache.river.jeri.internal.runtime.AbstractDgcClient.EndpointEntry	getEndpointEntry(Endpoint endpoint) Looks up the EndpointEntry for the given endpoint.
protected Endpoint	getRefEndpoint(ObjectEndpoint ref) Returns the endpoint in the given live reference.
protected Uuid	getRefObjectID(ObjectEndpoint ref) Returns the object ID in the given live reference.
void	registerRefs(Endpoint endpoint, Collection<ObjectEndpoint> refs) Registers the live reference instances in the supplied collection to participate in distributed garbage collection.
void	setDGCContext(Endpoint endpoint, MethodConstraints clientConstraints, AccessControlContext context)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DgcClient

public DgcClient()

Method Detail

registerRefs

public void registerRefs(Endpoint endpoint,
                         Collection<ObjectEndpoint> refs)

Registers the live reference instances in the supplied collection to participate in distributed garbage collection. All of the live references in the list must be for remote objects at the given endpoint.

getDgcProxy

protected AbstractDgcClient.DgcProxy getDgcProxy(Endpoint endpoint)

Returns a proxy for making DGC calls to the given endpoint.

freeEndpoint

protected void freeEndpoint(Endpoint endpoint)

Indicates that resources for the given endpoint may be freed.

getRefEndpoint

protected Endpoint getRefEndpoint(ObjectEndpoint ref)

Returns the endpoint in the given live reference.

getRefObjectID

protected Uuid getRefObjectID(ObjectEndpoint ref)

Returns the object ID in the given live reference.

setDGCContext

public void setDGCContext(Endpoint endpoint,
                          MethodConstraints clientConstraints,
                          AccessControlContext context)

getEndpointEntry

protected org.apache.river.jeri.internal.runtime.AbstractDgcClient.EndpointEntry getEndpointEntry(Endpoint endpoint)

Looks up the EndpointEntry for the given endpoint. An entry is created if one does not already exist.