public interface ItemId
ItemId identifies an item using a combination of unique ID
and path. There are three basic forms of an ItemId. The following
table shows each of the allowed combinations where an X in
the column indicates that a value is set and a - indicates
that the value is
|The item can be identified with a unique ID. In most cases such an item is also mix:referenceable but there is no restriction in that respect. An SPI implementation may also use a unique ID to identify non-referenceable nodes. Whether a node is referenceable is purely governed by its node type or the assigned mixin types. Note, that the format of the ID it is left to the implementation.
|The item can not be identified with a unique ID and none of its ancestors can be identified with a unique ID. The item is identified by an absolute path.
|The item can not be identified with a unique ID but one of its ancestors
getUniqueID() returns the unique ID of the nearest ancestor, which
can be identified with a unique ID. The relative path provides a navigation
path from the above mentioned ancestor to the item identified by the
ItemIds should be considered equal if both the unique part
and the path part are equal AND if they denote the same
true if this
ItemId identifies a node;
null if the
identified item nor any of its ancestors can be identified with a
if this item can be identified solely with a uniqueID.
Copyright © 2004–2024 The Apache Software Foundation. All rights reserved.