org.ametys.plugins.repository

Interface TraversableAmetysObject

All Superinterfaces:

AmetysObject

All Known Subinterfaces:

Calendar, JCRTraversableAmetysObject, MetadataAwarePagesContainer, ModifiableCalendar, ModifiablePage, ModifiableResourceCollection, ModifiableThread, ModifiableTraversableAmetysObject, ModifiableWebContent, Page, PagesContainer, ResourceCollection, SharedContent, Thread, WebContent

All Known Implementing Classes:

AbstractBlogPage, AbstractSurveyElement, AmetysObjectCollection, CMISResourcesCollection, CMISRootResourcesCollection, DefaultContent, DefaultLink, DefaultPage, DefaultSharedContent, DefaultTraversableAmetysObject, DefaultWebContent, DefaultWorkflowAwareContent, DefaultZone, JCRCalendar, JCRCategory, JCRResourcesCollection, JCRSubscribersList, JCRTag, JCRTasksList, JCRThread, ModifiableDefaultContent, ModifiableDefaultWebContent, RootAmetysObject, Site, Sitemap, Survey, SurveyPage, SurveyQuestion, TransitionalPage, UserPage, VirtualMonthPage, VirtualPostPage, VirtualPostsPage, VirtualTagPage, VirtualTagsPage, VirtualYearPage, VirtualYearsPage

public interface TraversableAmetysObject
extends AmetysObject

AmetysObject which is traversable and allow to create children.

Method Summary

Modifier and Type	Method and Description
<A extends AmetysObject> A	getChild(String path) Retrieves a given child from its relative path.
default <A extends AmetysObject> A	getChildAt(int index) Gets the child AmetysObject at the given position
default int	getChildPosition(AmetysObject ao) Returns the position of this AmetysObject within the ordered set of its sibling objects.
<A extends AmetysObject> AmetysObjectIterable<A>	getChildren() Retrieves children of the current object.
boolean	hasChild(String name) Tests if this Object has at least one child with the given name.

Methods inherited from interface org.ametys.plugins.repository.AmetysObject

equals, getId, getName, getParent, getParentPath, getPath, hashCode

Method Detail

getChildren

<A extends AmetysObject> AmetysObjectIterable<A> getChildren()
                                                      throws AmetysRepositoryException

Retrieves children of the current object.

Type Parameters:

A - the actual type of AmetysObjects.

Returns:

the children or an empty AmetysObjectIterable.

Throws:

AmetysRepositoryException - if an error occurs.

hasChild

boolean hasChild(String name)
          throws AmetysRepositoryException

Tests if this Object has at least one child with the given name.

Parameters:

name - the name to test. Cannot be null nor empty nor begin with a '/' and it cannot contain '/'.

Returns:

true if the named child exists, false otherwise.

Throws:

AmetysRepositoryException - if an error occurs.

getChild

<A extends AmetysObject> A getChild(String path)
                             throws AmetysRepositoryException,
                                    UnknownAmetysObjectException

Retrieves a given child from its relative path. The path cannot be null, empty nor begin with a '/'.

Type Parameters:

A - the actual type of AmetysObject.

Parameters:

path - the path of the child which can contains a position with. [n] if same name sibling is allowed.

Returns:

the child found.

Throws:

AmetysRepositoryException - if an error occurs.

UnknownAmetysObjectException - if the object does not exist.

getChildAt

default <A extends AmetysObject> A getChildAt(int index)
                                       throws AmetysRepositoryException,
                                              UnknownAmetysObjectException

Gets the child AmetysObject at the given position

Type Parameters:

A - The type of children objects

Parameters:

index - the position of the AmetysObject within the ordered set of its sibling objects.

Returns:

the AmetysObject if found

Throws:

AmetysRepositoryException - if an error occurs

UnknownAmetysObjectException - if no object was found at this position

getChildPosition

default int getChildPosition(AmetysObject ao)
                      throws AmetysRepositoryException

Returns the position of this AmetysObject within the ordered set of its sibling objects.

Parameters:

ao - The Ametys object

Returns:

the position of this AmetysObject within the ordered set of its sibling objects.

Throws:

AmetysRepositoryException - if an error occurs.