Package com.helger.tree.withid.unique

Class BasicTreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

java.lang.Object

com.helger.tree.withid.BasicTreeWithID<KEYTYPE,DATATYPE,ITEMTYPE>

com.helger.tree.withid.unique.BasicTreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE>

Type Parameters:

KEYTYPE - The type of the key elements for the tree.

DATATYPE - The type of the elements contained in the tree

ITEMTYPE - tree item type

All Implemented Interfaces:

com.helger.commons.hierarchy.IChildrenProvider<ITEMTYPE>, com.helger.commons.hierarchy.IChildrenProviderWithID<KEYTYPE,ITEMTYPE>, com.helger.commons.hierarchy.IHasChildren<ITEMTYPE>, IBasicTree<DATATYPE,ITEMTYPE>, ITreeWithID<KEYTYPE,DATATYPE,ITEMTYPE>, ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE>

Direct Known Subclasses:

BasicFolderTree, DefaultTreeWithGlobalUniqueID

@NotThreadSafe
public class BasicTreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>
extends BasicTreeWithID<KEYTYPE,DATATYPE,ITEMTYPE>
implements ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE>

A managed tree is a specialized version of the tree, where each item is required to have a unique ID so that item searching can be performed quite easily.

Author:

Philip Helger

Constructor Summary

Constructors

Constructor	Description
BasicTreeWithGlobalUniqueID(ITreeItemWithUniqueIDFactory<KEYTYPE,DATATYPE,ITEMTYPE> aFactory)

Method Summary

Modifier and Type	Method	Description
boolean	containsItemWithID(KEYTYPE aDataID)	Check if a tree item corresponding to the given ID is present.
boolean	equals(Object o)
com.helger.commons.collection.impl.ICommonsList<? extends ITEMTYPE>	getAllChildren(ITEMTYPE aItem)
com.helger.commons.collection.impl.ICommonsCollection<DATATYPE>	getAllItemDatas()
com.helger.commons.collection.impl.ICommonsCollection<ITEMTYPE>	getAllItems()
int	getChildCount(ITEMTYPE aItem)
ITEMTYPE	getChildWithID(ITEMTYPE aCurrentItem, KEYTYPE aDataID)
protected ITreeItemWithUniqueIDFactory<KEYTYPE,DATATYPE,ITEMTYPE>	getFactory()
int	getItemCount()
DATATYPE	getItemDataWithID(KEYTYPE aDataID)	Get the data of the tree item that corresponds to the given ID.
ITEMTYPE	getItemWithID(KEYTYPE aDataID)	Get the ITreeItemWithID that corresponds to the given ID.
boolean	hasChildren(ITEMTYPE aItem)
int	hashCode()
boolean	isItemSameOrDescendant(KEYTYPE aParentItemID, KEYTYPE aChildItemID)	Check if one item is equal or a child of the other item.
com.helger.commons.state.EChange	removeItemWithID(KEYTYPE aDataID)	Remove the item with the specified ID
String	toString()

Methods inherited from class com.helger.tree.withid.BasicTreeWithID

forAllChildren, forAllChildren, forAllChildrenBreakable, forAllChildrenMapped, getAllChildren, getChildCount, getChildren, getRootItem, hasChildren

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.helger.tree.IBasicTree

getRootItem

Methods inherited from interface com.helger.commons.hierarchy.IChildrenProvider

hasNoChildren

Methods inherited from interface com.helger.commons.hierarchy.IHasChildren

forAllChildren, forAllChildren, forAllChildrenBreakable, forAllChildrenMapped, getAllChildren, getChildCount, getChildren, hasChildren, hasNoChildren

Constructor Detail

BasicTreeWithGlobalUniqueID

public BasicTreeWithGlobalUniqueID(@Nonnull
                                   ITreeItemWithUniqueIDFactory<KEYTYPE,DATATYPE,ITEMTYPE> aFactory)

Method Detail

getFactory

@Nonnull
protected final ITreeItemWithUniqueIDFactory<KEYTYPE,DATATYPE,ITEMTYPE> getFactory()

Returns:

The factory used for creation. For internal use only.

containsItemWithID

public final boolean containsItemWithID(@Nullable
                                        KEYTYPE aDataID)

Description copied from interface: ITreeWithGlobalUniqueID

Check if a tree item corresponding to the given ID is present.

Specified by:

containsItemWithID in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Parameters:

aDataID - The ID of the tree item to search.

Returns:

true if such an item is present

getItemWithID

@Nullable
public final ITEMTYPE getItemWithID(@Nullable
                                    KEYTYPE aDataID)

Description copied from interface: ITreeWithGlobalUniqueID

Get the ITreeItemWithID that corresponds to the given ID.

Specified by:

getItemWithID in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Parameters:

aDataID - The ID of the tree item to search.

Returns:

null if no such tree item exists.

getItemDataWithID

@Nullable
public final DATATYPE getItemDataWithID(@Nullable
                                        KEYTYPE aDataID)

Description copied from interface: ITreeWithGlobalUniqueID

Get the data of the tree item that corresponds to the given ID.

Specified by:

getItemDataWithID in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Parameters:

aDataID - The ID of the tree item to search.

Returns:

null if no such tree item exists.

getChildWithID

@Nullable
public final ITEMTYPE getChildWithID(@Nullable
                                     ITEMTYPE aCurrentItem,
                                     @Nullable
                                     KEYTYPE aDataID)

Specified by:

getChildWithID in interface com.helger.commons.hierarchy.IChildrenProviderWithID<KEYTYPE,DATATYPE>

getItemCount

@Nonnegative
public final int getItemCount()

Specified by:

getItemCount in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Returns:

The number of all contained items. Always ≥ 0.

getAllItems

@Nonnull
@ReturnsMutableCopy
public final com.helger.commons.collection.impl.ICommonsCollection<ITEMTYPE> getAllItems()

Specified by:

getAllItems in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Returns:

A non-null collection of all items.

getAllItemDatas

@Nonnull
@ReturnsMutableCopy
public final com.helger.commons.collection.impl.ICommonsCollection<DATATYPE> getAllItemDatas()

Specified by:

getAllItemDatas in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Returns:

A non-null collection of all item datas.

removeItemWithID

@Nonnull
public final com.helger.commons.state.EChange removeItemWithID(@Nullable
                                                               KEYTYPE aDataID)

Description copied from interface: ITreeWithGlobalUniqueID

Remove the item with the specified ID

Specified by:

removeItemWithID in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Parameters:

aDataID - The ID of the item to be removed

Returns:

EChange.CHANGED if the item was removed, EChange.UNCHANGED otherwise. Never null.

isItemSameOrDescendant

public final boolean isItemSameOrDescendant(@Nullable
                                            KEYTYPE aParentItemID,
                                            @Nullable
                                            KEYTYPE aChildItemID)

Description copied from interface: ITreeWithGlobalUniqueID

Check if one item is equal or a child of the other item. This relationship is checked not only for direct children but for all levels.

Specified by:

isItemSameOrDescendant in interface ITreeWithGlobalUniqueID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

Parameters:

aParentItemID - The parent item ID to a validate.

aChildItemID - The item ID to check whether it is a child of the passed parent folder.

Returns:

true if the child item is the same or a child of the parent item, false if one of the IDs could not be resolved or they are not in a parent-child-relationship.

hasChildren

public boolean hasChildren(@Nullable
                           ITEMTYPE aItem)

Specified by:

hasChildren in interface com.helger.commons.hierarchy.IChildrenProvider<KEYTYPE>

getChildCount

@Nonnegative
public int getChildCount(@Nullable
                         ITEMTYPE aItem)

Specified by:

getChildCount in interface com.helger.commons.hierarchy.IChildrenProvider<KEYTYPE>

getAllChildren

@Nullable
public com.helger.commons.collection.impl.ICommonsList<? extends ITEMTYPE> getAllChildren(@Nullable
                                                                                          ITEMTYPE aItem)

Specified by:

getAllChildren in interface com.helger.commons.hierarchy.IChildrenProvider<KEYTYPE>

equals

public boolean equals(Object o)

Overrides:

equals in class BasicTreeWithID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

hashCode

public int hashCode()

Overrides:

hashCode in class BasicTreeWithID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>

toString

public String toString()

Overrides:

toString in class BasicTreeWithID<KEYTYPE,DATATYPE,ITEMTYPE extends ITreeItemWithID<KEYTYPE,DATATYPE,ITEMTYPE>>