org.ametys.plugins.odfweb.repository

Class ProgramPage

java.lang.Object

org.ametys.plugins.odfweb.repository.ProgramPage

All Implemented Interfaces:

TagAwareAmetysObject, AmetysObject, MetadataAwareAmetysObject, TraversableAmetysObject, MetadataAwarePagesContainer, Page, PagesContainer, SiteAwareAmetysObject

public class ProgramPage
extends Object
implements Page

Page representing a Program or a SubProgram.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	ProgramPage.AbstractTreeIterator<T> Breadth first search iterator for tree structure Each node can provide an iterator that will be put in the end of the queue.
(package private) static class	ProgramPage.ProgramPartTraverser Program part traverser.

Nested classes/interfaces inherited from interface org.ametys.web.repository.page.Page

Page.LinkType, Page.PageType

Field Summary

Fields

Modifier and Type	Field and Description
private OdfPageHandler	_odfPageHandler
private Program	_parent
private Page	_parentPage
private String	_path
private AbstractProgram	_program
private AmetysObjectResolver	_resolver
private Page	_root

Constructor Summary

Constructors

Constructor and Description
ProgramPage(AmetysObjectResolver resolver, OdfPageHandler odfPageHandler, Page root, AbstractProgram program, String path, Program parent, Page parentPage) Constructor for program page holding a Program or SubProgram
ProgramPage(AmetysObjectResolver resolver, OdfPageHandler odfPageHandler, Page root, Program program, Page parentPage) Constructor for program page holding a Program.

Method Summary

Modifier and Type	Method and Description
(package private) String	_computeLevelsPath() Compute the path from the root odf page, representing the first and second level pages.
private boolean	_filterByName(ProgramItem programItem, String name)
private Optional<ProgramItem>	_findChild(TraversableProgramPart parent, String name)
private Optional<Page>	_getChildPage(TraversableProgramPart parent, String name)
private CoursePage	_toChildCoursePage(Course course)
private Page	_toChildPage(ProgramItem child)
private ProgramPage	_toChildProgramPage(SubProgram child)
private Stream<ProgramItem>	_traverseChildren(TraversableProgramPart parent)
<A extends AmetysObject> A	getChild(String path) Retrieves a given child from its relative path.
Page	getChildPageAt(int index) Gets the child Page at the given position
AmetysObjectIterable<? extends Page>	getChildren() Retrieves children of the current object.
AmetysObjectIterable<? extends Page>	getChildrenPages() Retrieves child pages.
AmetysObjectIterable<? extends Page>	getChildrenPages(boolean includeInvisiblePages) Retrieves child pages.
int	getDepth() Get the page depth
String	getId() Retrieves the unique identifier of this AmetysObject. It must be unique in the whole repository and must never be null. It must conform to the URI syntax: <protocol>://<protocol-specific-part>
String	getLongTitle() Retrieves the long title.
CompositeMetadata	getMetadataHolder() Returns the root CompositeMetadata of this AmetysObject.
String	getName() Retrieves the name of the current object.
Page	getParent() Returns the parent object in the Ametys hierarchy.
String	getParentPath() Returns the path of the parent object in the Ametys hierarchy.
(package private) Program	getParentProgram()
String	getPath() Retrieves the path of the current object.
String	getPathInSitemap() Computes the path relative to the current sitemap.
AbstractProgram	getProgram() Returns the associated Program or SubProgram.
Set<String>	getReferers() Retrieves all AmetysObject ids referencing this page.
ResourceCollection	getRootAttachments() Retrieves the attachments root node
Site	getSite() Returns this object's site.
Sitemap	getSitemap() Retrieves the sitemap containing the current sitemap.
String	getSitemapName() Returns this page's sitemap name
String	getSiteName() Returns this object's site name.
Set<String>	getTags() Retrieves current tags.
String	getTemplate() Retrieves the template name.
String	getTitle() Retrieves the title.
Page.PageType	getType() Retrieves the type.
String	getURL() Retrieves the linked URL.
Page.LinkType	getURLType() Retrieves the linked URL type.
Zone	getZone(String name) Retrieves a given zone.
AmetysObjectIterable<? extends Zone>	getZones() Retrieves the zones.
boolean	hasChild(String name) Tests if this Object has at least one child with the given name.
boolean	hasZone(String name) Determine if a zone exists
boolean	isVisible() Determine if the page is visible into navigation elements

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

getChildAt, getChildPosition

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

equals, hashCode

Field Detail

_resolver

private AmetysObjectResolver _resolver

_odfPageHandler

private OdfPageHandler _odfPageHandler

_root

private Page _root

_program

private AbstractProgram _program

_path

private String _path

_parent

private Program _parent

_parentPage

private Page _parentPage

Constructor Detail

ProgramPage

public ProgramPage(AmetysObjectResolver resolver,
                   OdfPageHandler odfPageHandler,
                   Page root,
                   Program program,
                   Page parentPage)

Constructor for program page holding a Program.

Parameters:

resolver - the AmetysObjectResolver.

odfPageHandler - the OdfPageHandler to handle ODF pages.

root - the ODF root page.

program - the program.

parentPage - the parent Page or null if not yet computed.

ProgramPage

public ProgramPage(AmetysObjectResolver resolver,
                   OdfPageHandler odfPageHandler,
                   Page root,
                   AbstractProgram program,
                   String path,
                   Program parent,
                   Page parentPage)

Constructor for program page holding a Program or SubProgram

Parameters:

resolver - the AmetysObjectResolver.

odfPageHandler - the OdfPageHandler to handle ODF pages.

root - the ODF root page.

program - the program or subprogram.

path - The path from the virtual second level page. Can be null if abstract program is a Program

parent - the parent program in case of a subprogram, null otherwise

parentPage - the parent Page or null if not yet computed.

Method Detail

getProgram

public AbstractProgram getProgram()

Returns the associated Program or SubProgram.

Returns:

the associated Program or SubProgram.

getDepth

public int getDepth()
             throws AmetysRepositoryException

Description copied from interface: Page

Get the page depth

Specified by:

getDepth in interface Page

Returns:

the page depth

Throws:

AmetysRepositoryException - if an error occurs.

getReferers

public Set<String> getReferers()
                        throws AmetysRepositoryException

Description copied from interface: Page

Retrieves all AmetysObject ids referencing this page.

Specified by:

getReferers in interface Page

Returns:

the AmetysObject ids referencing this page.

Throws:

AmetysRepositoryException - if an error occurs.

getRootAttachments

public ResourceCollection getRootAttachments()
                                      throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the attachments root node

Specified by:

getRootAttachments in interface Page

Returns:

The the attachments root node

Throws:

AmetysRepositoryException - if an error occurs.

getTemplate

public String getTemplate()
                   throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the template name.

Specified by:

getTemplate in interface Page

Returns:

the template name or null if none has been set.

Throws:

AmetysRepositoryException - if an error occurs.

getTitle

public String getTitle()
                throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the title.

Specified by:

getTitle in interface Page

Returns:

the title.

Throws:

AmetysRepositoryException - if an error occurs.

getLongTitle

public String getLongTitle()
                    throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the long title.

Specified by:

getLongTitle in interface Page

Returns:

the title.

Throws:

AmetysRepositoryException - if an error occurs.

getType

public Page.PageType getType()
                      throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the type.

Specified by:

getType in interface Page

Returns:

the type.

Throws:

AmetysRepositoryException - if an error occurs.

See Also:

Page.PageType

getURL

public String getURL()
              throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the linked URL.

Specified by:

getURL in interface Page

Returns:

the linked URL.

Throws:

AmetysRepositoryException - if an error occurs.

getURLType

public Page.LinkType getURLType()
                         throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the linked URL type.

Specified by:

getURLType in interface Page

Returns:

the linked URL type.

Throws:

AmetysRepositoryException - if an error occurs.

getZone

public Zone getZone(String name)
             throws UnknownZoneException,
                    AmetysRepositoryException

Description copied from interface: Page

Retrieves a given zone.

Specified by:

getZone in interface Page

Parameters:

name - the name of the zone.

Returns:

the given zone.

Throws:

UnknownZoneException - if there is no zone for the given name.

AmetysRepositoryException - if an error occurs.

getZones

public AmetysObjectIterable<? extends Zone> getZones()
                                              throws AmetysRepositoryException

Description copied from interface: Page

Retrieves the zones.

Specified by:

getZones in interface Page

Returns:

the zones.

Throws:

AmetysRepositoryException - if an error occurs.

hasZone

public boolean hasZone(String name)
                throws AmetysRepositoryException

Description copied from interface: Page

Determine if a zone exists

Specified by:

hasZone in interface Page

Parameters:

name - The name of the zone

Returns:

true if the zone exists

Throws:

AmetysRepositoryException - If an error occured

getChildrenPages

public AmetysObjectIterable<? extends Page> getChildrenPages()
                                                      throws AmetysRepositoryException

Description copied from interface: PagesContainer

Retrieves child pages.

Specified by:

getChildrenPages in interface PagesContainer

Returns:

the child pages.

Throws:

AmetysRepositoryException - if an error occurs.

getPathInSitemap

public String getPathInSitemap()
                        throws AmetysRepositoryException

Description copied from interface: PagesContainer

Computes the path relative to the current sitemap.

Specified by:

getPathInSitemap in interface PagesContainer

Returns:

the path relative to the current sitemap.

Throws:

AmetysRepositoryException - if an error occurs.

getParentProgram

Program getParentProgram()

_computeLevelsPath

String _computeLevelsPath()

Compute the path from the root odf page, representing the first and second level pages.

Returns:

the path

getSite

public Site getSite()
             throws AmetysRepositoryException

Description copied from interface: SiteAwareAmetysObject

Returns this object's site.

Specified by:

getSite in interface SiteAwareAmetysObject

Returns:

this object's site

Throws:

AmetysRepositoryException - if an error occurs.

getSiteName

public String getSiteName()
                   throws AmetysRepositoryException

Description copied from interface: SiteAwareAmetysObject

Returns this object's site name.

Specified by:

getSiteName in interface SiteAwareAmetysObject

Returns:

this object's site name.

Throws:

AmetysRepositoryException - if an error occurs.

getSitemap

public Sitemap getSitemap()
                   throws AmetysRepositoryException

Description copied from interface: PagesContainer

Retrieves the sitemap containing the current sitemap.

Specified by:

getSitemap in interface PagesContainer

Returns:

the sitemap containing the current sitemap.

Throws:

AmetysRepositoryException - if an error occurs.

getSitemapName

public String getSitemapName()
                      throws AmetysRepositoryException

Description copied from interface: PagesContainer

Returns this page's sitemap name

Specified by:

getSitemapName in interface PagesContainer

Returns:

this page's sitemap name

Throws:

AmetysRepositoryException - if an error occurs.

getChild

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

Description copied from interface: TraversableAmetysObject

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

Specified by:

getChild in interface TraversableAmetysObject

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.

_getChildPage

private Optional<Page> _getChildPage(TraversableProgramPart parent,
                                     String name)

_findChild

private Optional<ProgramItem> _findChild(TraversableProgramPart parent,
                                         String name)

_filterByName

private boolean _filterByName(ProgramItem programItem,
                              String name)

_toChildPage

private Page _toChildPage(ProgramItem child)

_toChildProgramPage

private ProgramPage _toChildProgramPage(SubProgram child)

_toChildCoursePage

private CoursePage _toChildCoursePage(Course course)

getChildren

public AmetysObjectIterable<? extends Page> getChildren()
                                                 throws AmetysRepositoryException

Description copied from interface: TraversableAmetysObject

Retrieves children of the current object.

Specified by:

getChildren in interface TraversableAmetysObject

Returns:

the children or an empty AmetysObjectIterable.

Throws:

AmetysRepositoryException - if an error occurs.

hasChild

public boolean hasChild(String name)
                 throws AmetysRepositoryException

Description copied from interface: TraversableAmetysObject

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

Specified by:

hasChild in interface TraversableAmetysObject

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.

getId

public String getId()
             throws AmetysRepositoryException

Description copied from interface: AmetysObject

Retrieves the unique identifier of this AmetysObject.
It must be unique in the whole repository and must never be null.
It must conform to the URI syntax:
<protocol>://<protocol-specific-part>

Specified by:

getId in interface AmetysObject

Returns:

the unique identifier of this AmetysObject

Throws:

AmetysRepositoryException - if an error occurs.

getName

public String getName()
               throws AmetysRepositoryException

Description copied from interface: AmetysObject

Retrieves the name of the current object.

Specified by:

getName in interface AmetysObject

Returns:

the name.

Throws:

AmetysRepositoryException - if an error occurs.

getParent

public Page getParent()
               throws AmetysRepositoryException

Description copied from interface: AmetysObject

Returns the parent object in the Ametys hierarchy.

Specified by:

getParent in interface AmetysObject

Returns:

the parent object or null if current object is the root.

Throws:

AmetysRepositoryException - if an error occurs.

getParentPath

public String getParentPath()
                     throws AmetysRepositoryException

Description copied from interface: AmetysObject

Returns the path of the parent object in the Ametys hierarchy.

Specified by:

getParentPath in interface AmetysObject

Returns:

the path of the parent object.

Throws:

AmetysRepositoryException - if an error occurs.

getPath

public String getPath()
               throws AmetysRepositoryException

Description copied from interface: AmetysObject

Retrieves the path of the current object.

Specified by:

getPath in interface AmetysObject

Returns:

the path.

Throws:

AmetysRepositoryException - if an error occurs.

getMetadataHolder

public CompositeMetadata getMetadataHolder()

Description copied from interface: MetadataAwareAmetysObject

Returns the root CompositeMetadata of this AmetysObject.

Specified by:

getMetadataHolder in interface MetadataAwareAmetysObject

Returns:

the root CompositeMetadata of this AmetysObject

getTags

public Set<String> getTags()
                    throws AmetysRepositoryException

Description copied from interface: TagAwareAmetysObject

Retrieves current tags.

Specified by:

getTags in interface TagAwareAmetysObject

Returns:

the current tags.

Throws:

AmetysRepositoryException - if an error occurs.

isVisible

public boolean isVisible()
                  throws AmetysRepositoryException

Description copied from interface: Page

Determine if the page is visible into navigation elements

Specified by:

isVisible in interface Page

Returns:

true if the page is visible.

Throws:

AmetysRepositoryException - if an error occurs.

getChildrenPages

public AmetysObjectIterable<? extends Page> getChildrenPages(boolean includeInvisiblePages)
                                                      throws AmetysRepositoryException

Description copied from interface: PagesContainer

Retrieves child pages.

Specified by:

getChildrenPages in interface PagesContainer

Parameters:

includeInvisiblePages - true to include invisible pages

Returns:

the child pages.

Throws:

AmetysRepositoryException - if an error occurs.

getChildPageAt

public Page getChildPageAt(int index)
                    throws UnknownAmetysObjectException,
                           AmetysRepositoryException

Description copied from interface: PagesContainer

Gets the child Page at the given position

Specified by:

getChildPageAt in interface PagesContainer

Parameters:

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

Returns:

the Page if found

Throws:

UnknownAmetysObjectException - if no child page was found at this position

AmetysRepositoryException - if an error occurs

_traverseChildren

private Stream<ProgramItem> _traverseChildren(TraversableProgramPart parent)