com.itmill.toolkit.data.util
Class HierarchicalContainer

java.lang.Object
  com.itmill.toolkit.data.util.IndexedContainer
      com.itmill.toolkit.data.util.HierarchicalContainer

All Implemented Interfaces:

Container, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeNotifier, Container.Sortable, Property.ValueChangeNotifier, Cloneable, Comparator

public class HierarchicalContainer
extends IndexedContainer
implements Container.Hierarchical

A specialized Container whose contents can be accessed like it was a tree-like structure.

Since:

3.0

Version:

4.1.4

Author:

IT Mill Ltd.

Nested Class Summary

Nested classes/interfaces inherited from interface com.itmill.toolkit.data.Container

Container.Editor, Container.Hierarchical, Container.Indexed, Container.ItemSetChangeEvent, Container.ItemSetChangeListener, Container.ItemSetChangeNotifier, Container.Ordered, Container.PropertySetChangeEvent, Container.PropertySetChangeListener, Container.PropertySetChangeNotifier, Container.Sortable, Container.Viewer

Field Summary

Fields inherited from interface com.itmill.toolkit.data.Container

NULL_ITEM_ID

Constructor Summary

HierarchicalContainer()

Method Summary

Object	addItem() Creates a new Item into the list, and assign it an automatic ID.
Item	addItem(Object itemId) Creates a new Item with the given ID into the list.
boolean	areChildrenAllowed(Object itemId) Tests if the Item with given ID can have any children.
Collection	getChildren(Object itemId) Gets the IDs of all Items that are children of the specified Item.
Object	getParent(Object itemId) Gets the ID of the parent Item of the specified Item.
boolean	hasChildren(Object itemId) Tests if the Item specified with itemId has any child Items, that is, is it a leaf Item.
boolean	isRoot(Object itemId) Tests if the Item specified with itemId is a root Item.
boolean	removeAllItems() Removes all Items from the list.
boolean	removeItem(Object itemId) Removes the Item corresponding to the given Item ID from the list.
Collection	rootItemIds() Gets the IDs of all Items in the container that don't have a parent.
boolean	setChildrenAllowed(Object itemId, boolean childrenAllowed) Sets the given Item's capability to have children.
boolean	setParent(Object itemId, Object newParentId) Sets the parent of an Item.

Methods inherited from class com.itmill.toolkit.data.util.IndexedContainer

addContainerProperty, addItemAfter, addItemAfter, addItemAt, addItemAt, addListener, addListener, addListener, clone, compare, containsId, equals, firstItemId, getContainerProperty, getContainerPropertyIds, getIdByIndex, getItem, getItemIds, getSortableContainerPropertyIds, getType, hashCode, indexOfId, isFirstId, isLastId, lastItemId, nextItemId, prevItemId, removeContainerProperty, removeListener, removeListener, removeListener, size, sort

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.itmill.toolkit.data.Container

addContainerProperty, containsId, getContainerProperty, getContainerPropertyIds, getItem, getItemIds, getType, removeContainerProperty, size

Constructor Detail

HierarchicalContainer

public HierarchicalContainer()

Method Detail

areChildrenAllowed

public boolean areChildrenAllowed(Object itemId)

Description copied from interface: Container.Hierarchical

Tests if the Item with given ID can have any children. If the Container also implements the Managed interface, the items created with newItem can have children by default.

Specified by:

areChildrenAllowed in interface Container.Hierarchical

Parameters:

itemId - ID of the Item in the container whose child capability is to be tested

Returns:

true if the specified Item exists in the Container and it can have children, false if it's not found from the container or it can't have children.

getChildren

public Collection getChildren(Object itemId)

Description copied from interface: Container.Hierarchical

Gets the IDs of all Items that are children of the specified Item. The returned collection is unmodifiable.

Specified by:

getChildren in interface Container.Hierarchical

Parameters:

itemId - ID of the Item whose children the caller is interested in

Returns:

An unmodifiable collection containing the IDs of all other Items that are children in the container hierarchy

getParent

public Object getParent(Object itemId)

Description copied from interface: Container.Hierarchical

Gets the ID of the parent Item of the specified Item.

Specified by:

getParent in interface Container.Hierarchical

Parameters:

itemId - ID of the Item whose parent the caller wishes to find out.

Returns:

the ID of the parent Item. Will be null if the specified Item is a root element.

hasChildren

public boolean hasChildren(Object itemId)

Description copied from interface: Container.Hierarchical

Tests if the Item specified with itemId has any child Items, that is, is it a leaf Item. The Container.Hierarchical.getChildren(Object itemId)method always returns null for leaf Items.

Note that being a leaf does not imply whether or not an Item is allowed to have children.

.

Specified by:

hasChildren in interface Container.Hierarchical

Parameters:

itemId - ID of the Item whose leaf status is to be tested

Returns:

true if the specified Item is a leaf, false if not

isRoot

public boolean isRoot(Object itemId)

Description copied from interface: Container.Hierarchical

Tests if the Item specified with itemId is a root Item. The hierarchical container can have more than one root and must have at least one unless it is empty. The Container.Hierarchical.getParent(Object itemId)method always returns null for root Items.

Specified by:

isRoot in interface Container.Hierarchical

Parameters:

itemId - ID of the Item whose root status is to be tested

Returns:

true if the specified Item is a root, false if not

rootItemIds

public Collection rootItemIds()

Description copied from interface: Container.Hierarchical

Gets the IDs of all Items in the container that don't have a parent. Such items are called root Items. The returned collection is unmodifiable.

Specified by:

rootItemIds in interface Container.Hierarchical

Returns:

An unmodifiable collection containing IDs of all root elements of the container

setChildrenAllowed

public boolean setChildrenAllowed(Object itemId,
                                  boolean childrenAllowed)

Sets the given Item's capability to have children. If the Item identified with the itemId already has children and the areChildrenAllowed is false this method fails and false is returned; the children must be first explicitly removed with setParent(Object itemId, Object newParentId) or Container.removeItem(Object itemId).

Specified by:

setChildrenAllowed in interface Container.Hierarchical

Parameters:

itemId - the ID of the Item in the container whose child capability is to be set.

childrenAllowed - the boolean value specifying if the Item can have children or not.

Returns:

true if the operation succeeded, false if not

setParent

public boolean setParent(Object itemId,
                         Object newParentId)

Sets the parent of an Item. The new parent item must exist and be able to have children. (canHaveChildren(newParentId) == true). It is also possible to detach a node from the hierarchy (and thus make it root) by setting the parent null.

Specified by:

setParent in interface Container.Hierarchical

Parameters:

itemId - the ID of the item to be set as the child of the Item identified with newParentId.

newParentId - the ID of the Item that's to be the new parent of the Item identified with itemId.

Returns:

true if the operation succeeded, false if not

addItem

public Object addItem()

Description copied from class: IndexedContainer

Creates a new Item into the list, and assign it an automatic ID. The new ID is returned, or null if the operation fails. After a successful call you can use the getItemmethod to fetch the Item.

Specified by:

addItem in interface Container

Overrides:

addItem in class IndexedContainer

Returns:

ID of the newly created Item, or null in case of a failure

See Also:

Container.addItem()

addItem

public Item addItem(Object itemId)

Description copied from class: IndexedContainer

Creates a new Item with the given ID into the list. The new Item is returned, and it is ready to have its Properties modified. Returns null if the operation fails or the Container already contains a Item with the given ID.

Specified by:

addItem in interface Container

Overrides:

addItem in class IndexedContainer

Parameters:

itemId - the ID of the Item to be created.

Returns:

Created new Item, or null in case of a failure

See Also:

Container.addItem(Object)

removeAllItems

public boolean removeAllItems()

Description copied from class: IndexedContainer

Removes all Items from the list.

Note : The Property ID and type information is preserved.

Specified by:

removeAllItems in interface Container

Overrides:

removeAllItems in class IndexedContainer

Returns:

true if the operation succeeded, false if not

See Also:

Container.removeAllItems()

removeItem

public boolean removeItem(Object itemId)

Description copied from class: IndexedContainer

Removes the Item corresponding to the given Item ID from the list.

Specified by:

removeItem in interface Container

Overrides:

removeItem in class IndexedContainer

Parameters:

itemId - the ID of the Item to remove.

Returns:

true if the operation succeeded, false if not

See Also:

Container.removeItem(Object)