org.apache.jackrabbit.commons
Class AbstractProperty

java.lang.Object
  org.apache.jackrabbit.commons.AbstractItem
      org.apache.jackrabbit.commons.AbstractProperty

All Implemented Interfaces:

javax.jcr.Item, javax.jcr.Property

public abstract class AbstractProperty
extends AbstractItem
implements javax.jcr.Item, javax.jcr.Property

Abstract base class for implementing the JCR Property interface.

Item methods without a default implementation:

• Item.getName()
• Item.getParent()
• Item.getSession()
• Item.isModified()
• Item.isNew()
• Item.isSame(Item)
• Item.refresh(boolean)
• Item.save()

Property methods without a default implementation:

• Property.getDefinition()
• Property.getValue()
• Property.getValues()

NOTE: Many of the default method implementations in this base class rely on the parent node being accessible through the Item.getParent() call. It is possible (though unlikely) that access controls deny access to a containing node even though a property is accessible. In such cases the default method implementations in this class will not work.

Constructor Summary

AbstractProperty()

Method Summary

void	accept(javax.jcr.ItemVisitor visitor) Accepts the given item visitor.
boolean	getBoolean() Returns the boolean value of this property.
java.util.Calendar	getDate() Returns the date value of this property.
double	getDouble() Returns the double value of this property.
long	getLength() Returns the length of the value of this property.
long[]	getLengths() Returns the lengths of the values of this property.
long	getLong() Returns the long value of this property.
javax.jcr.Node	getNode() Returns the node referenced by this property.
java.lang.String	getPath() Returns the path of this property.
java.io.InputStream	getStream() Returns the binary value of this property.
java.lang.String	getString() Returns the string value of this property.
int	getType() Returns the type of this property.
boolean	isNode() Returns false.
void	remove() Removes this property.
void	setValue(boolean value) Sets the value of this property.
void	setValue(java.util.Calendar value) Sets the value of this property.
void	setValue(double value) Sets the value of this property.
void	setValue(java.io.InputStream value) Sets the value of this property.
void	setValue(long value) Sets the value of this property.
void	setValue(javax.jcr.Node value) Sets the value of this property.
void	setValue(java.lang.String value) Sets the value of this property.
void	setValue(java.lang.String[] values) Sets the values of this property.
void	setValue(javax.jcr.Value value) Sets the value of this property.
void	setValue(javax.jcr.Value[] values) Sets the values of this property.

Methods inherited from class org.apache.jackrabbit.commons.AbstractItem

getAncestor, getDepth, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.jcr.Property

getDefinition, getValue, getValues

Methods inherited from interface javax.jcr.Item

getAncestor, getDepth, getName, getParent, getSession, isModified, isNew, isSame, refresh, save

Constructor Detail

AbstractProperty

public AbstractProperty()

Method Detail

accept

public void accept(javax.jcr.ItemVisitor visitor)
            throws javax.jcr.RepositoryException

Accepts the given item visitor.

The default implementation calls ItemVisitor.visit(Property) on the given visitor with this property as the argument.

Specified by:

accept in interface javax.jcr.Item

Parameters:

visitor - item visitor

Throws:

javax.jcr.RepositoryException - if an error occurs

getPath

public java.lang.String getPath()
                         throws javax.jcr.RepositoryException

Returns the path of this property.

The default implementation constructs the path from the path of the parent node and the name of this property.

Specified by:

getPath in interface javax.jcr.Item

Returns:

property path

Throws:

javax.jcr.RepositoryException - if an error occurs

isNode

public boolean isNode()

Returns false.

Specified by:

isNode in interface javax.jcr.Item

Returns:

false

remove

public void remove()
            throws javax.jcr.RepositoryException

Removes this property.

The default implementation calls Node.setProperty(String, Value) with a null value on the parent node.

Specified by:

remove in interface javax.jcr.Item

Throws:

javax.jcr.RepositoryException - if an error occurs

getBoolean

public boolean getBoolean()
                   throws javax.jcr.RepositoryException

Returns the boolean value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getBoolean in interface javax.jcr.Property

Returns:

boolean value

Throws:

javax.jcr.RepositoryException - if an error occurs

getDate

public java.util.Calendar getDate()
                           throws javax.jcr.RepositoryException

Returns the date value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getDate in interface javax.jcr.Property

Returns:

date value

Throws:

javax.jcr.RepositoryException - if an error occurs

getDouble

public double getDouble()
                 throws javax.jcr.RepositoryException

Returns the double value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getDouble in interface javax.jcr.Property

Returns:

double value

Throws:

javax.jcr.RepositoryException - if an error occurs

getLength

public long getLength()
               throws javax.jcr.RepositoryException

Returns the length of the value of this property.

The default implementation measures the length of the Value instance returned by the generic Property.getValue() method.

Specified by:

getLength in interface javax.jcr.Property

Returns:

length of the property value

Throws:

javax.jcr.RepositoryException - if an error occurs

getLengths

public long[] getLengths()
                  throws javax.jcr.RepositoryException

Returns the lengths of the values of this property.

The default implementation measures the lengths of the Value instances returned by the generic Property.getValues() method.

Specified by:

getLengths in interface javax.jcr.Property

Returns:

lengths of the property values

Throws:

javax.jcr.RepositoryException - if an error occurs

getLong

public long getLong()
             throws javax.jcr.RepositoryException

Returns the long value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getLong in interface javax.jcr.Property

Returns:

long value

Throws:

javax.jcr.RepositoryException - if an error occurs

getNode

public javax.jcr.Node getNode()
                       throws javax.jcr.RepositoryException

Returns the node referenced by this property.

The default implementation checks that this property is a reference property (or tries to convert the property value to a reference) and uses Session.getNodeByUUID(String) to retrieve the referenced node.

Specified by:

getNode in interface javax.jcr.Property

Returns:

node referenced by this property

Throws:

javax.jcr.RepositoryException - if an error occurs

getStream

public java.io.InputStream getStream()
                              throws javax.jcr.RepositoryException

Returns the binary value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getStream in interface javax.jcr.Property

Returns:

binary value

Throws:

javax.jcr.RepositoryException - if an error occurs

getString

public java.lang.String getString()
                           throws javax.jcr.RepositoryException

Returns the string value of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getString in interface javax.jcr.Property

Returns:

string value

Throws:

javax.jcr.RepositoryException - if an error occurs

getType

public int getType()
            throws javax.jcr.RepositoryException

Returns the type of this property.

The default implementation forwards the method call to the Value instance returned by the generic Property.getValue() method.

Specified by:

getType in interface javax.jcr.Property

Returns:

property type

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(javax.jcr.Value value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, Value) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(javax.jcr.Value[] values)
              throws javax.jcr.RepositoryException

Sets the values of this property.

The default implementation forwards the call to the Node.setProperty(String, Value[]) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

values - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(java.lang.String value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, String) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(java.lang.String[] values)
              throws javax.jcr.RepositoryException

Sets the values of this property.

The default implementation forwards the call to the Node.setProperty(String, String[]) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

values - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(java.io.InputStream value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, InputStream) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(long value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, long) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(double value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, double) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(java.util.Calendar value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, Calendar) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(boolean value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, boolean) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs

setValue

public void setValue(javax.jcr.Node value)
              throws javax.jcr.RepositoryException

Sets the value of this property.

The default implementation forwards the call to the Node.setProperty(String, Node) method of the parent node using the name of this property.

Specified by:

setValue in interface javax.jcr.Property

Parameters:

value - passed through

Throws:

javax.jcr.RepositoryException - if an error occurs