com.semanticcms.core.model

Class Element

java.lang.Object

com.semanticcms.core.model.Node

com.semanticcms.core.model.Element

All Implemented Interfaces:

Freezable<Node>

public abstract class Element
extends Node

A page may contain any number of elements (along with arbitrary textual data and other content). Each element may also contain other elements.

Field Summary

Fields inherited from class com.semanticcms.core.model.Node

frozen, lock

Constructor Summary

Constructors

Constructor and Description
Element()

Method Summary

Modifier and Type	Method and Description
Long	addChildElement(Element childElement, ElementWriter elementWriter) Adds a child element to this element.
boolean	equals(Object obj) Two elements are equal when they are the same object or when they are on the same page and have the same ID.
static StringBuilder	generateIdPrefix(String template, String prefix) Generates a valid ID from an arbitrary string.
protected abstract String	getDefaultIdPrefix() Gets the default element ID prefix for this type of element.
protected String	getElementIdTemplate() Gets the element ID template for generating IDs.
ElementRef	getElementRef() Gets an ElementRef for this element.
String	getId() When inside a page, every element must have a per-page unique ID, when one is not provided, it will be generated.
Page	getPage() Every element may (and usually will) exist within a page.
Element	getParentElement() Elements may be nested, gets the parent Element above this element.
int	hashCode()
boolean	isHidden() When hidden, an element is not added to common elements like navigation trees.
static boolean	isValidId(String id) Makes sure an ID is valid.
void	setId(String id)

Methods inherited from class com.semanticcms.core.model.Node

addPageLink, appendLabel, checkNotFrozen, findTopLevelElements, freeze, getBody, getChildElements, getLabel, getPageLinks, getProperty, setBody, setProperty, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Element

public Element()

Method Detail

isValidId

public static boolean isValidId(String id)

Makes sure an ID is valid. Must match [A-Za-z][A-Za-z0-9:_.-]*

See Also:

http://www.w3.org/TR/2002/REC-xhtml1-20020801/#C_8

generateIdPrefix

public static StringBuilder generateIdPrefix(String template,
                                             String prefix)

Generates a valid ID from an arbitrary string. Strip all character not matching [A-Za-z][A-Za-z0-9:_.-]* Also converts characters to lower case.

Parameters:

template - The preferred text to base the id on

prefix - The base used when template is unusable (must be a valid id or invalid ID's may be generated)

See Also:

http://www.w3.org/TR/2002/REC-xhtml1-20020801/#C_8

equals

public boolean equals(Object obj)

Two elements are equal when they are the same object or when they are on the same page and have the same ID. If either one does not have a page or does not (yet) have an ID, they will not be equal.

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getElementIdTemplate

protected String getElementIdTemplate()

Gets the element ID template for generating IDs.

See Also:

Defaults to getLabel()

getDefaultIdPrefix

protected abstract String getDefaultIdPrefix()

Gets the default element ID prefix for this type of element.

getPage

public Page getPage()

Every element may (and usually will) exist within a page.

getId

public String getId()

When inside a page, every element must have a per-page unique ID, when one is not provided, it will be generated. When not inside a page, no missing ID is generated and it will remain null.

setId

public void setId(String id)

getElementRef

public ElementRef getElementRef()
                         throws IllegalStateException

Gets an ElementRef for this element. Must have a page set. If id has not yet been set, one will be generated.

Throws:

IllegalStateException - if page not set

getParentElement

public Element getParentElement()

Elements may be nested, gets the parent Element above this element. Top-level parents within a page, or standalone elements, will not have any parent.

addChildElement

public Long addChildElement(Element childElement,
                            ElementWriter elementWriter)

Adds a child element to this element.

Overrides:

addChildElement in class Node

isHidden

public boolean isHidden()

When hidden, an element is not added to common elements like navigation trees. By default, elements are not hidden.