Defines an interface that allows a proxy for a resource to express the identity of that resource. Resources include items like services, leases, service registrations, and lease renewal sets. Any resource that is represented by proxies that implement this interface has a unique identity. That identity is expressed by assigning the resource a universally unique identifier. This universally unique identifier will be represented using the
Uuid class. This
Uuid must be:
- Sufficient to uniquely identify the resource,
- associated with the resource for the resource's entire lifetime,
- never assigned to another resource who's proxies implement
ReferentUuid, and - returned by the
getReferentUuid method of any proxy of the resource, if that proxy implements ReferentUuid.
Given two objects, o1 and o2, that implement ReferentUuid:
- if
o1.equals(o2) is true, then o1.getReferentUuid and o2.getReferentUuid should return equivalent Uuids. - if
o1.getReferentUuid and o2.getReferentUuid return equivalent Uuids, o1.equals(o2) may, but is not required to be true.
@author Sun Microsystems, Inc.
@see Uuid
@since 2.0