getItemState

If this HierarchyEntry has already been resolved before
(see HierarchyEntry.isAvailable()), that ItemState is returned.
Note however, that the validity of the State is not asserted.
If the entry has not been resolved yet an attempt is made to resolve this
entry, which may fail if there exists no accessible ItemState
or if the corresponding state has been removed in the mean time.

setItemState

invalidate

public void invalidate(boolean recursive)

Invalidates the underlying ItemState if available and if it
is not transiently modified. If the recursive flag is true,
also invalidates the child entries recursively.
Note, that in contrast to HierarchyEntry.reload(boolean)
this method only sets the status of this item state to Status.INVALIDATED and does not actually update it with the persistent
state in the repository.

revert

Traverses the hierarchy and reverts all transient modifications such as
adding, modifying or removing item states. 'Existing' item states
are reverted to their initial state and their status is reset to Status.EXISTING.

transientRemove

Traverses the hierarchy and marks all available item states as transiently
removed. They will change their status to either Status.EXISTING_REMOVED if
the item is existing in the persistent storage or Status.REMOVED
if the item has been transiently added before. In the latter case, the
corresponding HierarchyEntries can be removed as well from their parent.

remove

Removes this HierarchyEntry from its parent and sets the
status of the underlying ItemState to Status.REMOVED or to
Status.STALE_DESTROYED, respectively. If this entry is a
NodeEntry all descending ItemStates must get their status changed as well.

getGeneration

The required generation of this HierarchyEntry . This is used by the
ItemInfoCache to determine whether an item info in the cache is up to date or not.
That is whether the generation of the item info in the cache is the same or more recent
as the required generation of this entry.