info.magnolia.cms.core
Class AbstractContent

java.lang.Object
  info.magnolia.cms.core.ContentHandler
      info.magnolia.cms.core.AbstractContent

All Implemented Interfaces:

Content, Cloneable

Direct Known Subclasses:

ContentWrapper, DefaultContent

public abstract class AbstractContent
extends ContentHandler
implements Content

A base class by implementing some default behavior. A subclass must carefully implement newNodeDataInstance(String, int, boolean), getChildren(info.magnolia.cms.core.Content.ContentFilter, String, java.util.Comparator) and Content.getNodeDataCollection(String).

Version:

$Id$

Author:

pbaerfuss

Nested Class Summary

Nested classes/interfaces inherited from interface info.magnolia.cms.core.Content

Content.ContentFilter

Field Summary

Fields inherited from class info.magnolia.cms.core.ContentHandler

hierarchyManager

Constructor Summary

AbstractContent()

Method Summary

Content	createContent(String name) Creates a Content node under the current node with the specified name.
Content	createContent(String name, ItemType contentType) Creates a Content node under the current node with the specified name.
NodeData	createNodeData(String name) Creates a node data of type STRING with an empty String as default value.
NodeData	createNodeData(String name, int type) Deprecated.
NodeData	createNodeData(String name, Object valueObj) Deprecated.
NodeData	createNodeData(String name, javax.jcr.Value value) Creates a node data setting the value.
NodeData	createNodeData(String name, javax.jcr.Value[] value) Deprecated.
void	delete(String path) Remove specified path.
void	deleteNodeData(String name) Delete NodeData with the specified name.
protected Collection<NodeData>	getBinaryNodeDatas(String namePattern)
Content	getChildByName(String namePattern) Deprecated.
Collection<Content>	getChildren() Gets a Collection containing all child nodes of the same NodeType as "this" object.
Collection<Content>	getChildren(Content.ContentFilter filter) Get a collection containing child nodes which satisfies the given filter.
Collection<Content>	getChildren(Content.ContentFilter filter, Comparator<Content> orderCriteria) Get a collection containing child nodes which satisfies the given filter.
abstract Collection<Content>	getChildren(Content.ContentFilter filter, String namePattern, Comparator<Content> orderCriteria)
Collection<Content>	getChildren(ItemType itemType) Get collection of specified content type.
Collection<Content>	getChildren(String contentType) Get collection of specified content type and its subtypes.
Collection<Content>	getChildren(String contentType, String namePattern) Get collection of specified content type.
NodeData	getNodeData(String name) Returns a NodeData object.
Collection<NodeData>	getNodeDataCollection() Gets all properties bind in NodeData object excluding JCR system properties.
String	getTemplate() Returns the template name which is assigned to this content.
String	getTitle()
javax.jcr.Workspace	getWorkspace() get workspace to which this node attached to.
boolean	hasChildren()
boolean	hasChildren(String contentType)
boolean	hasNodeData(String name) Delegates to NodeData.isExist().
boolean	isGranted(long permissions) checks for the allowed access rights.
boolean	isNodeData(String path) checks if the requested resource is an NodeData (Property).
abstract NodeData	newNodeDataInstance(String name, int type, boolean createIfNotExisting) As defined in Content.getNodeData(String) this method always returns a node data object.
NodeData	setNodeData(String name, boolean value) Sets the node data.
NodeData	setNodeData(String name, Calendar value) Sets the node data.
NodeData	setNodeData(String name, Content value) Sets the node data.
NodeData	setNodeData(String name, double value) Sets the node data.
NodeData	setNodeData(String name, InputStream value) Sets the node data.
NodeData	setNodeData(String name, long value) Sets the node data.
NodeData	setNodeData(String name, Object value) Uses the NodeDataUtil to create and set the node data based on the object type.
NodeData	setNodeData(String name, String value) Sets the node data.
NodeData	setNodeData(String name, javax.jcr.Value value) Sets the node data.
NodeData	setNodeData(String name, javax.jcr.Value[] value) Sets the node data.
String	toString()
void	updateMetaData() You could call this method anytime to update working page properties - Modification date & Author ID.

Methods inherited from class info.magnolia.cms.core.ContentHandler

clone, getAccessManager, getHierarchyManager, setAccessManager, setHierarchyManager

Methods inherited from class java.lang.Object

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

Methods inherited from interface info.magnolia.cms.core.Content

addMixin, addVersion, addVersion, createContent, delete, getAccessManager, getAllVersions, getAncestor, getAncestors, getBaseVersion, getContent, getHandle, getHierarchyManager, getIndex, getItemType, getJCRNode, getLevel, getLock, getMetaData, getMixinNodeTypes, getName, getNodeDataCollection, getNodeType, getNodeTypeName, getParent, getUUID, getVersionedContent, getVersionedContent, getVersionHistory, hasContent, hasMetaData, hasMixin, holdsLock, isLocked, isModified, isNodeType, lock, lock, orderBefore, refresh, removeMixin, removeVersionHistory, restore, restore, restore, restoreByLabel, save, unlock

Constructor Detail

AbstractContent

public AbstractContent()

Method Detail

createContent

public Content createContent(String name)
                      throws javax.jcr.PathNotFoundException,
                             javax.jcr.RepositoryException,
                             AccessDeniedException

Description copied from interface: Content

Creates a Content node under the current node with the specified name. The default node type ItemType.CONTENT will be use as the contents primary type.

Specified by:

createContent in interface Content

Parameters:

name - of the node to be created as Content

Returns:

newly created Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException - if an error occurs

AccessDeniedException - if the current session does not have sufficient access rights to complete the operation

createContent

public Content createContent(String name,
                             ItemType contentType)
                      throws javax.jcr.PathNotFoundException,
                             javax.jcr.RepositoryException,
                             AccessDeniedException

Description copied from interface: Content

Creates a Content node under the current node with the specified name.

Specified by:

createContent in interface Content

Parameters:

name - of the node to be created as Content

contentType - ItemType

Returns:

newly created Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException - if an error occurs

AccessDeniedException - if the current session does not have sufficient access rights to complete the operation

createNodeData

public NodeData createNodeData(String name)
                        throws javax.jcr.PathNotFoundException,
                               javax.jcr.RepositoryException,
                               AccessDeniedException

Description copied from interface: Content

Creates a node data of type STRING with an empty String as default value.

Specified by:

createNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

createNodeData

public NodeData createNodeData(String name,
                               javax.jcr.Value value)
                        throws javax.jcr.PathNotFoundException,
                               javax.jcr.RepositoryException,
                               AccessDeniedException

Description copied from interface: Content

Creates a node data setting the value.

Specified by:

createNodeData in interface Content

Throws:

AccessDeniedException - if the current session does not have sufficient access rights to complete the operation

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

createNodeData

public NodeData createNodeData(String name,
                               javax.jcr.Value[] value)
                        throws javax.jcr.PathNotFoundException,
                               javax.jcr.RepositoryException,
                               AccessDeniedException

Deprecated.

Description copied from interface: Content

Create a multi value node data.

Specified by:

createNodeData in interface Content

Throws:

AccessDeniedException - if the current session does not have sufficient access rights to complete the operation

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

createNodeData

public NodeData createNodeData(String name,
                               int type)
                        throws javax.jcr.PathNotFoundException,
                               javax.jcr.RepositoryException,
                               AccessDeniedException

Deprecated.

Description copied from interface: Content

Creates a node data of type with an default value set. If the no default value can be set (for BINARY, REFERENCE type) the returned node data will be empty and per definition not yet exist.

• STRING: empty string
• BOOLEAN: false
• DATE: now
• LONG/DOUBLE: 0

Specified by:

createNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

createNodeData

public NodeData createNodeData(String name,
                               Object valueObj)
                        throws javax.jcr.RepositoryException

Deprecated.

Description copied from interface: Content

Creates a property and set its value immediately, according to the type of the passed instance, hiding the complexity of using JCR's ValueFactory and providing a sensible default behavior.

Specified by:

createNodeData in interface Content

Throws:

javax.jcr.RepositoryException

getNodeData

public NodeData getNodeData(String name)

Returns a NodeData object. If the node data does not exist (respectively if it has no value) an empty representation is returned whose NodeData.isExist() will return false. Delegates to newNodeDataInstance(String, int, boolean) by setting the type to PropertyType.UNDEFINED. A subclass has to handle this by trying to determine the type if the node data exists. The reason for this is that implementations want to instantiate different node data classes per type

Specified by:

getNodeData in interface Content

Returns:

NodeData requested NodeData object

newNodeDataInstance

public abstract NodeData newNodeDataInstance(String name,
                                             int type,
                                             boolean createIfNotExisting)
                                      throws AccessDeniedException,
                                             javax.jcr.RepositoryException

As defined in Content.getNodeData(String) this method always returns a node data object. If the type is PropertyType.UNDEFINED the implementation should check if the node data exists and determine the type to use.

Parameters:

createIfNotExisting - if false an empty non-mutable node data will be returned if the node data doesn't exist otherwise a mutable nodedata object is returned (depending on the type)

Throws:

AccessDeniedException

javax.jcr.RepositoryException

hasNodeData

public boolean hasNodeData(String name)
                    throws javax.jcr.RepositoryException

Delegates to NodeData.isExist().

Specified by:

hasNodeData in interface Content

Throws:

javax.jcr.RepositoryException - if an error occurs

setNodeData

public NodeData setNodeData(String name,
                            javax.jcr.Value value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null is not allowed

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            javax.jcr.Value[] value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null is not allowed.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            boolean value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null will remove the node data.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            long value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null is not allowed.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            double value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null will remove the node data.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            String value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null is not allowed.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            InputStream value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null is not allowed.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            Calendar value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null will remove the node data.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            Content value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Description copied from interface: Content

Sets the node data. If the node data does not yet exist the node data is created. Setting null will remove the node data.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

setNodeData

public NodeData setNodeData(String name,
                            Object value)
                     throws javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException,
                            AccessDeniedException

Uses the NodeDataUtil to create and set the node data based on the object type.

Specified by:

setNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

AccessDeniedException

deleteNodeData

public void deleteNodeData(String name)
                    throws javax.jcr.PathNotFoundException,
                           javax.jcr.RepositoryException

Description copied from interface: Content

Delete NodeData with the specified name.

Specified by:

deleteNodeData in interface Content

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException - if an error occurs

getChildren

public Collection<Content> getChildren()

Gets a Collection containing all child nodes of the same NodeType as "this" object. Delegates to getChildren(ItemType) passing the current node's type.

Specified by:

getChildren in interface Content

Returns:

Collection of content objects

getChildren

public Collection<Content> getChildren(Content.ContentFilter filter)

Get a collection containing child nodes which satisfies the given filter. Delegates to {@link #getChildren(info.magnolia.cms.core.Content.ContentFilter, java.util.Comparator).

Specified by:

getChildren in interface Content

Returns:

Collection of content objects or empty collection when no children are found.

getChildren

public Collection<Content> getChildren(ItemType itemType)

Get collection of specified content type. Delegates to {@link #getChildren(info.magnolia.cms.core.Content.ContentFilter, java.util.Comparator).

Specified by:

getChildren in interface Content

Parameters:

itemType - ItemType

Returns:

Collection of content nodes

getChildren

public Collection<Content> getChildren(String contentType)

Get collection of specified content type and its subtypes. Delegates to {@link #getChildren(info.magnolia.cms.core.Content.ContentFilter, java.util.Comparator).

Specified by:

getChildren in interface Content

Parameters:

contentType - JCR node type as configured

Returns:

Collection of content nodes

getChildren

public Collection<Content> getChildren(String contentType,
                                       String namePattern)

Get collection of specified content type. Delegates to getChildren(info.magnolia.cms.core.Content.ContentFilter, String, java.util.Comparator).

Specified by:

getChildren in interface Content

Parameters:

contentType - JCR node type as configured

Returns:

Collection of content nodes

getChildren

public Collection<Content> getChildren(Content.ContentFilter filter,
                                       Comparator<Content> orderCriteria)

Get a collection containing child nodes which satisfies the given filter. The returned collection is ordered according to the passed in criteria. Delegates to getChildren(info.magnolia.cms.core.Content.ContentFilter, String, java.util.Comparator).

Specified by:

getChildren in interface Content

Parameters:

filter - filter for the child nodes

orderCriteria - ordering for the selected child nodes; if null than no particular order of the child nodes

Returns:

Collection of content objects or empty collection when no children are found.

getChildren

public abstract Collection<Content> getChildren(Content.ContentFilter filter,
                                                String namePattern,
                                                Comparator<Content> orderCriteria)

Parameters:

namePattern - ignored if null.

getChildByName

public Content getChildByName(String namePattern)

Deprecated.

Description copied from interface: Content

Returns the first child with the given name, any node type.

Specified by:

getChildByName in interface Content

Parameters:

namePattern - child node name

Returns:

first found node with the given name or null if not found

getNodeDataCollection

public Collection<NodeData> getNodeDataCollection()

Description copied from interface: Content

Gets all properties bind in NodeData object excluding JCR system properties.

Specified by:

getNodeDataCollection in interface Content

getBinaryNodeDatas

protected Collection<NodeData> getBinaryNodeDatas(String namePattern)
                                           throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

hasChildren

public boolean hasChildren()

Specified by:

hasChildren in interface Content

Returns:

Boolean, if sub node(s) exists

hasChildren

public boolean hasChildren(String contentType)

Specified by:

hasChildren in interface Content

Parameters:

contentType - JCR node type as configured

Returns:

Boolean, if sub collectionType exists

delete

public void delete(String path)
            throws javax.jcr.RepositoryException

Description copied from interface: Content

Remove specified path.

Specified by:

delete in interface Content

Throws:

javax.jcr.RepositoryException - if an error occurs

isNodeData

public boolean isNodeData(String path)
                   throws AccessDeniedException,
                          javax.jcr.RepositoryException

Description copied from interface: Content

checks if the requested resource is an NodeData (Property).

Specified by:

isNodeData in interface Content

Parameters:

path - of the requested NodeData

Returns:

boolean true is the requested content is an NodeData

Throws:

AccessDeniedException

javax.jcr.RepositoryException - if an error occurs

getTemplate

public String getTemplate()

Description copied from interface: Content

Returns the template name which is assigned to this content.

Specified by:

getTemplate in interface Content

getTitle

public String getTitle()

Specified by:

getTitle in interface Content

Returns:

String, title

updateMetaData

public void updateMetaData()
                    throws javax.jcr.RepositoryException,
                           AccessDeniedException

Description copied from interface: Content

You could call this method anytime to update working page properties - Modification date & Author ID.

Specified by:

updateMetaData in interface Content

Throws:

AccessDeniedException - if the current session does not have sufficient access rights to complete the operation

javax.jcr.RepositoryException - if an error occurs

isGranted

public boolean isGranted(long permissions)

Description copied from interface: Content

checks for the allowed access rights.

Specified by:

isGranted in interface Content

Parameters:

permissions - as defined in javax.jcr.Permission

Returns:

true is the current user has specified access on this node.

getWorkspace

public javax.jcr.Workspace getWorkspace()
                                 throws javax.jcr.RepositoryException

Description copied from interface: Content

get workspace to which this node attached to.

Specified by:

getWorkspace in interface Content

Throws:

javax.jcr.RepositoryException - if unable to get this node session

toString

public String toString()

Overrides:

toString in class Object