org.jboss.cache
Class Fqn<E>

java.lang.Object
  org.jboss.cache.Fqn<E>

All Implemented Interfaces:

Externalizable, Serializable, Comparable<Fqn<?>>

Direct Known Subclasses:

StringFqn

@Immutable
public class Fqn<E>
extends Object
implements Comparable<Fqn<?>>, Externalizable

A Fully Qualified Name (Fqn) is a list of names (typically Strings but can be any Object), which represent a path to a particular Node or sometimes a Region in a Cache.

This name can be absolute (i.e., relative from the root node - ROOT), or relative to any node in the cache. Reading the documentation on each API call that makes use of Fqns will tell you whether the API expects a relative or absolute Fqn.

For instance, using this class to fetch a particular node might look like this. (Here data on "Joe" is kept under the "Smith" surname node, under the "people" tree.)

 Fqn abc = Fqn.fromString("/people/Smith/Joe/");
 Node joesmith = Cache.getRoot().getChild(abc);
 

Alternatively, the same Fqn could be constructed using a List