Class AbstractNode
- java.lang.Object
-
- org.apache.jackrabbit.commons.AbstractItem
-
- org.apache.jackrabbit.commons.AbstractNode
-
public abstract class AbstractNode extends AbstractItem implements Node
Abstract base class for implementing the JCRNode
interface.Item
methods without a default implementation:Item.accept(javax.jcr.ItemVisitor)
Item.getName()
Item.getParent()
Item.getSession()
Item.isModified()
Item.isNew()
Item.isSame(Item)
Item.refresh(boolean)
Item.remove()
Item.save()
Node
methods without a default implementation:Node.addMixin(String)
Node.addNode(String)
Node.addNode(String, String)
Node.canAddMixin(String)
Node.cancelMerge(Version)
Node.checkin()
Node.checkout()
Node.doneMerge(Version)
Node.getBaseVersion()
Node.getCorrespondingNodePath(String)
Node.getDefinition()
Node.getIndex()
Node.getLock()
Node.getNode(String)
Node.getNodes()
Node.getNodes(String)
Node.getPrimaryItem()
Node.getProperties()
Node.getProperties(String)
Node.getReferences()
Node.lock(boolean, boolean)
Node.merge(String, boolean)
Node.orderBefore(String, String)
Node.removeMixin(String)
Node.restore(Version, String, boolean)
Node.setProperty(String, Value)
Node.setProperty(String, Value[])
Node.unlock()
Node.update(String)
-
-
Field Summary
-
Fields inherited from interface javax.jcr.Node
JCR_CHILD_NODE_DEFINITION, JCR_CONTENT, JCR_FROZEN_NODE, JCR_PROPERTY_DEFINITION, JCR_ROOT_VERSION, JCR_VERSION_LABELS
-
-
Constructor Summary
Constructors Constructor Description AbstractNode()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
accept(ItemVisitor visitor)
Accepts the given item visitor.NodeType[]
getMixinNodeTypes()
Returns the declared mixin node types of this node.java.lang.String
getPath()
Returns the path of this node.NodeType
getPrimaryNodeType()
Returns the primary node type of this node.Property
getProperty(java.lang.String relPath)
Returns the property at the given relative path from this node.java.lang.String
getUUID()
Returns the UUID of this node.VersionHistory
getVersionHistory()
Returns the version history of this node.boolean
hasNode(java.lang.String relPath)
Checks whether a node at the given relative path exists.boolean
hasNodes()
Checks if this node has one or more properties.boolean
hasProperties()
Checks if this node has one or more properties.boolean
hasProperty(java.lang.String relPath)
Checks whether a property at the given relative path exists.boolean
holdsLock()
Checks if this node holds a lock.boolean
isCheckedOut()
Checks whether this node is checked out.boolean
isLocked()
Checks if this node is locked.boolean
isNode()
Returnstrue
.boolean
isNodeType(java.lang.String name)
Checks whether this node is of the given type.void
restore(java.lang.String versionName, boolean removeExisting)
Restores this node to the version with the given name.void
restore(Version version, boolean removeExisting)
Restores this node to the given version.void
restoreByLabel(java.lang.String versionLabel, boolean removeExisting)
Restores this node to the version with the given label.Property
setProperty(java.lang.String name, boolean value)
Sets the value of the named property.Property
setProperty(java.lang.String name, double value)
Sets the value of the named property.Property
setProperty(java.lang.String name, long value)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.io.InputStream value)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.lang.String value)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.lang.String[] strings)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.lang.String[] strings, int type)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.lang.String value, int type)
Sets the value of the named property.Property
setProperty(java.lang.String name, java.util.Calendar value)
Sets the value of the named property.Property
setProperty(java.lang.String name, Node value)
Sets the value of the named property.Property
setProperty(java.lang.String name, Value[] values, int type)
Sets the value of the named property.Property
setProperty(java.lang.String name, Value value, int type)
Sets the value of the named property.-
Methods inherited from class org.apache.jackrabbit.commons.AbstractItem
getAncestor, getDepth, toString
-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface javax.jcr.Item
getAncestor, getDepth, getName, getParent, getSession, isModified, isNew, isSame, refresh, remove, save
-
Methods inherited from interface javax.jcr.Node
addMixin, addNode, addNode, canAddMixin, cancelMerge, checkin, checkout, doneMerge, followLifecycleTransition, getAllowedLifecycleTransistions, getBaseVersion, getCorrespondingNodePath, getDefinition, getIdentifier, getIndex, getLock, getNode, getNodes, getNodes, getNodes, getPrimaryItem, getProperties, getProperties, getProperties, getReferences, getReferences, getSharedSet, getWeakReferences, getWeakReferences, lock, merge, orderBefore, removeMixin, removeShare, removeSharedSet, restore, setPrimaryType, setProperty, setProperty, setProperty, setProperty, unlock, update
-
-
-
-
Method Detail
-
accept
public void accept(ItemVisitor visitor) throws RepositoryException
Accepts the given item visitor.The default implementation calls
ItemVisitor.visit(Node)
on the given visitor with this node as the argument.- Specified by:
accept
in interfaceItem
- Parameters:
visitor
- item visitor- Throws:
RepositoryException
- if an error occurs
-
getPath
public java.lang.String getPath() throws RepositoryException
Returns the path of this node.The default implementation recursively calls this method on the parent node and appends the name and optionally the index of this node to construct the full path. Returns "/" if the parent node is not available (i.e. this is the root node).
- Specified by:
getPath
in interfaceItem
- Returns:
- node path
- Throws:
RepositoryException
- if an error occurs
-
getMixinNodeTypes
public NodeType[] getMixinNodeTypes() throws RepositoryException
Returns the declared mixin node types of this node.The default implementation uses the values of the
jcr:mixinTypes
property to look up the mixin node types from theNodeTypeManager
of the current workspace.- Specified by:
getMixinNodeTypes
in interfaceNode
- Returns:
- mixin node types
- Throws:
RepositoryException
- if an error occurs
-
getPrimaryNodeType
public NodeType getPrimaryNodeType() throws RepositoryException
Returns the primary node type of this node.The default implementation uses the value of the
jcr:primaryType
property to look up the primary node type from theNodeTypeManager
of the current workspace.- Specified by:
getPrimaryNodeType
in interfaceNode
- Returns:
- primary node type
- Throws:
RepositoryException
- if an error occurs
-
getProperty
public Property getProperty(java.lang.String relPath) throws PathNotFoundException, RepositoryException
Returns the property at the given relative path from this node.The default implementation looks up the parent node of the given relative path and iterates through the properties of that node to find and return the identified property.
- Specified by:
getProperty
in interfaceNode
- Parameters:
relPath
- relative path of the property- Returns:
- property
- Throws:
PathNotFoundException
- if the property is not foundRepositoryException
- if an error occurs
-
getUUID
public java.lang.String getUUID() throws UnsupportedRepositoryOperationException, RepositoryException
Returns the UUID of this node.The default implementation checks if this node is referenceable (i.e. of type
mix:referenceable
) and returns the contents of thejcr:uuid
property if it is.- Specified by:
getUUID
in interfaceNode
- Returns:
- node UUID
- Throws:
UnsupportedRepositoryOperationException
- if this node is not referenceableRepositoryException
- if an error occurs
-
getVersionHistory
public VersionHistory getVersionHistory() throws RepositoryException
Returns the version history of this node.The default implementation returns the containing version history of the base version of this node.
- Specified by:
getVersionHistory
in interfaceNode
- Returns:
- version history
- Throws:
RepositoryException
- if an error occurs
-
hasNode
public boolean hasNode(java.lang.String relPath) throws RepositoryException
Checks whether a node at the given relative path exists.The default implementation looks up the node using
Node.getNode(String)
and returnstrue
if aPathNotFoundException
is not thrown.- Specified by:
hasNode
in interfaceNode
- Parameters:
relPath
- relative path- Returns:
true
if a node exists at the given path,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
hasNodes
public boolean hasNodes() throws RepositoryException
Checks if this node has one or more properties.The default implementation calls
Node.getNodes()
and returnstrue
iff returned iterator has at least one element.- Specified by:
hasNodes
in interfaceNode
- Returns:
true
if this node has child nodes,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
hasProperties
public boolean hasProperties() throws RepositoryException
Checks if this node has one or more properties.The default implementation calls
Node.getProperties()
and returnstrue
iff returned iterator has at least one element.Note that in normal circumstances (i.e. no weird access controls) this method will always return
true
since all nodes always have at least thejcr:primaryType
property.- Specified by:
hasProperties
in interfaceNode
- Returns:
true
if this node has properties,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
hasProperty
public boolean hasProperty(java.lang.String relPath) throws RepositoryException
Checks whether a property at the given relative path exists.The default implementation looks up the property using
Node.getProperty(String)
and returnstrue
if aPathNotFoundException
is not thrown.- Specified by:
hasProperty
in interfaceNode
- Parameters:
relPath
- relative path- Returns:
true
if a property exists at the given path,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
holdsLock
public boolean holdsLock() throws RepositoryException
Checks if this node holds a lock.The default implementation calls
Node.getLock()
and returnstrue
iff the holding node of the lock is the same as this node.- Specified by:
holdsLock
in interfaceNode
- Returns:
true
if this node holds a lock,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
isCheckedOut
public boolean isCheckedOut() throws RepositoryException
Checks whether this node is checked out.The default implementation checks the
jcr:isCheckedOut
property if this node is versionable, and recursively calls this method on the parent node if this node is not versionable. A non-versionable root node always returnstrue
from this method.- Specified by:
isCheckedOut
in interfaceNode
- Returns:
true
if this node is checked out,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
isLocked
public boolean isLocked() throws RepositoryException
Checks if this node is locked.The default implementation calls
Node.getLock()
and returnstrue
iff aLockException
is not thrown.- Specified by:
isLocked
in interfaceNode
- Returns:
true
if this node is locked,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
isNodeType
public boolean isNodeType(java.lang.String name) throws RepositoryException
Checks whether this node is of the given type.The default implementation iterates through the primary and mixin types and all the supertypes of this node, returning
true
if a type with the given name is encountered. Returnsfalse
if none of the types matches.- Specified by:
isNodeType
in interfaceNode
- Parameters:
name
- type name- Returns:
true
if this node is of the given type,false
otherwise- Throws:
RepositoryException
- if an error occurs
-
restore
public void restore(java.lang.String versionName, boolean removeExisting) throws RepositoryException
Restores this node to the version with the given name.The default implement retrieves the named
Version
from the associatedVersionHistory
and forwards the call to theNode.restore(Version, boolean)
method.- Specified by:
restore
in interfaceNode
- Parameters:
versionName
- version nameremoveExisting
- passed through- Throws:
RepositoryException
- if an error occurs
-
restore
public void restore(Version version, boolean removeExisting) throws RepositoryException
Restores this node to the given version.The default implementation forwards the call to the
Node.restore(Version, String, boolean)
method using the relative path ".".- Specified by:
restore
in interfaceNode
- Parameters:
version
- passed throughremoveExisting
- passed through- Throws:
RepositoryException
- if an error occurs
-
restoreByLabel
public void restoreByLabel(java.lang.String versionLabel, boolean removeExisting) throws RepositoryException
Restores this node to the version with the given label.The default implement retrieves the labeled
Version
from the associatedVersionHistory
and forwards the call to theNode.restore(Version, boolean)
method.- Specified by:
restoreByLabel
in interfaceNode
- Parameters:
versionLabel
- version labelremoveExisting
- passed through- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.lang.String[] strings) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instances from the given string values and forwards the call to theNode.setProperty(String, Value[])
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namestrings
- string values- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.lang.String value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given string value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- string value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.io.InputStream value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given binary value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- binary value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, boolean value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given boolean value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- boolean value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, double value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given double value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- double value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, long value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given long value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- long value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.util.Calendar value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given date value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- date value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, Node value) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance from the given reference value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- reference value- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, Value value, int type) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to convert the given value to the given type and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- property valuetype
- property type- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, Value[] values, int type) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to convert the given values to the given type and forwards the call to theNode.setProperty(String, Value[])
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalues
- property valuestype
- property type- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.lang.String[] strings, int type) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to createValue
instances of the given type from the given string values and forwards the call to theNode.setProperty(String, Value[])
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namestrings
- string valuestype
- property type- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
setProperty
public Property setProperty(java.lang.String name, java.lang.String value, int type) throws RepositoryException
Sets the value of the named property.The default implementation uses the
ValueFactory
of the currentSession
to create aValue
instance of the given type from the given string value and forwards the call to theNode.setProperty(String, Value)
method.- Specified by:
setProperty
in interfaceNode
- Parameters:
name
- property namevalue
- string valuetype
- property type- Returns:
- modified property
- Throws:
RepositoryException
- if an error occurs
-
-