org.hippoecm.hst.configuration.model

Interface HstNode

public interface HstNode

Method Summary

Modifier and Type	Method and Description
void	addNode(String name, HstNode hstNode) Adds or replaces a child HST node with the given name.
String	getName()
HstNode	getNode(String relPath)
List<HstNode>	getNodes()
List<HstNode>	getNodes(String nodeTypeName)
String	getNodeTypeName()
HstNode	getParent()
ValueProvider	getValueProvider()
boolean	isStale()
void	markStale() Deprecated. since 7.9.0 : use markStaleByPropertyEvent() or markStaleByNodeEvent()
void	markStaleByNodeEvent() marks the HstNode as stale due to node event: The JCRValueProvider might be out-of-date and/or the child nodes.
void	markStaleByPropertyEvent() marks the HstNode as stale due to property event: The JCRValueProvider is out-of-date.
void	removeNode(String name) removes child node with name and does nothing if not present
void	setJCRValueProvider(JCRValueProvider valueProvider) sets the new valueProvider
void	update(javax.jcr.Session session) updates all the HstNode's that need reloading.

Method Detail

getName

String getName()

Returns:

name of the hst node

getValueProvider

ValueProvider getValueProvider()

Returns:

the value provider for this HstNode

getNode

HstNode getNode(String relPath)
         throws IllegalArgumentException

Parameters:

relPath - a path that does not start with a slash, for example 'foo' or 'foo/bar'.

Returns:

the descendant node at relPath or null if it does not exist

Throws:

IllegalArgumentException - if relPath is not a valid relPath

getNodes

List<HstNode> getNodes()

Returns:

List<HstNode> of all the child nodes

getNodes

List<HstNode> getNodes(String nodeTypeName)

Returns:

List<HstNode> of all the child nodes with getNodeTypeName() equals to nodeTypeName

getNodeTypeName

String getNodeTypeName()

Returns:

the node type of the backing provider

getParent

HstNode getParent()

Returns:

the parent of this HstNode or null when there is no parent.

addNode

void addNode(String name,
             HstNode hstNode)

Adds or replaces a child HST node with the given name. If an HstNode with the given name already exits, it is replaced with the given HST node. Since the HstNode's are used for the HST config model that does not support same name siblings this is not a problem.

Parameters:

name - the name for the new HST node.

hstNode - the HST node to add or replace.

removeNode

void removeNode(String name)

removes child node with name and does nothing if not present

Parameters:

name -

setJCRValueProvider

void setJCRValueProvider(JCRValueProvider valueProvider)

sets the new valueProvider

Parameters:

valueProvider -

markStale

void markStale()

Deprecated. since 7.9.0 : use markStaleByPropertyEvent() or markStaleByNodeEvent()

marks the HstNode as stale: The JCRValueProvider is out-of-date

markStaleByPropertyEvent

void markStaleByPropertyEvent()

marks the HstNode as stale due to property event: The JCRValueProvider is out-of-date.

markStaleByNodeEvent

void markStaleByNodeEvent()

marks the HstNode as stale due to node event: The JCRValueProvider might be out-of-date and/or the child nodes.

isStale

boolean isStale()

Returns:

true when this HstNode is stale

update

void update(javax.jcr.Session session)
     throws javax.jcr.RepositoryException

updates all the HstNode's that need reloading.

Parameters:

session -

Throws:

javax.jcr.RepositoryException