com.ibm.workplace.wcm.api
Interface Taxonomy

All Superinterfaces:

Document, Editable

public interface Taxonomy

extends Editable

Represents a Taxonomy in the repository.

The Taxonomy interface provides methods that aid in traversing the Category Tree and allows the grouping of Category objects.

To retrieve the immediate children of this Taxonomy object use getChildren(). To retrieve all the children (descendants) of this Taxonomy object use getAllChildren().

Method Summary

com.ibm.workplace.wcm.api.DocumentIdIterator	getAllChildren() Returns a depth first iterator over all child categories of this Taxonomy.
com.ibm.workplace.wcm.api.DocumentIdIterator	getChildren() Returns an iterator of DocumentId objects of the immediate child categories of this Taxonomy.

Methods inherited from interface com.ibm.workplace.wcm.api.Editable

addAuthors, addDeleteAccessMembers, addEditAccessMembers, addHistoryLogEntry, addLiveAccessMembers, addOwners, addReadAccessMembers, isChanged, removeAuthors, removeDeleteAccessMembers, removeEditAccessMembers, removeLiveAccessMembers, removeOwners, removeReadAccessMembers, setDescription, setName, setTitle

Methods inherited from interface com.ibm.workplace.wcm.api.Document

getAuthors, getDeleteAccessMembers, getDescription, getEditAccessMembers, getHistoryLog, getId, getLiveAccessMembers, getModifiedDate, getName, getOwnerLibrary, getOwners, getReadAccessMembers, getTitle, hasDeleteAccess, hasDeleteAccess, hasEditAccess, hasEditAccess, hasLiveAccess, hasLiveAccess, hasReadAccess, hasReadAccess

Method Detail

getChildren

public com.ibm.workplace.wcm.api.DocumentIdIterator getChildren()

Returns an iterator of DocumentId objects of the immediate child categories of this Taxonomy.

Returns:

an iterator of DocumentId objects of the immediate children of this Taxonomy; or an empty iterator if no immediate children are found.

getAllChildren

public com.ibm.workplace.wcm.api.DocumentIdIterator getAllChildren()

Returns a depth first iterator over all child categories of this Taxonomy.

For example, a Category Tree that looks like:

 MyTaxonomy
    CategoryA
       CategoryA1
          CategoryA1-1
          CategoryA1-2
       CategoryA2
    CategoryB
       CategoryB1
 

a call to getAllChildren() will return DocumentId objects for the child categories of MyTaxonomy in this order:

CategoryA, CategoryA1, CategoryA1-1, CategoryA1-2, CategoryA2, CategoryB, CategoryB1.

The user must have Read access to the Category for it to be included in the returned iterator.

Returns:

an iterator of DocumentId objects of all the children of this Taxonomy; or an empty iterator if no children are found