Interface Property
-
- All Superinterfaces:
Item
- All Known Implementing Classes:
AbstractProperty
public interface Property extends Item
AProperty
object represents the smallest granularity of content storage. It has a single parent node and no children. A property consists of a name and a value, or in the case of multi-value properties, a set of values all of the same type. See
.Value
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
JCR_ACTIVITY
A constant for the property namejcr:activity
(in expanded form), declared in node typesmix:versionable
andnt:version
.static java.lang.String
JCR_AUTOCREATED
A constant for the property namejcr:autoCreated
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.static java.lang.String
JCR_BASE_VERSION
A constant for the property namejcr:baseVersion
(in expanded form), declared in node typemix:versionable
.static java.lang.String
JCR_CHILD_VERSION_HISTORY
A constant for the property namejcr:childVersionHistory
(in expanded form), declared in node typent:versionedChild
.static java.lang.String
JCR_CONFIGURATION
A constant for the property namejcr:configuration
(in expanded form), declared in node typemix:versionable
.static java.lang.String
JCR_CONTENT
A constant for the property namejcr:content
(in expanded form), declared in node typent:linkedFile
.static java.lang.String
JCR_COPIED_FROM
A constant for the property namejcr:copiedFrom
(in expanded form), declared in node typent:version
.static java.lang.String
JCR_CREATED
A constant for the property namejcr:created
(in expanded form), declared in node typesmix:created
andnt:version
.static java.lang.String
JCR_CREATED_BY
A constant for the property namejcr:createdBy
(in expanded form), declared in node typemix:created
.static java.lang.String
JCR_CURRENT_LIFECYCLE_STATE
A constant for the property namejcr:currentLifecycleState
(in expanded form), declared in node typemix:lifecycle
.static java.lang.String
JCR_DATA
A constant for the property namejcr:data
(in expanded form), declared in node typent:resource
.static java.lang.String
JCR_DEFAULT_PRIMARY_TYPE
A constant for the property namejcr:defaultPrimaryType
(in expanded form), declared in node typent:childNodeDefinition
.static java.lang.String
JCR_DEFAULT_VALUES
A constant for the property namejcr:defaultValues
(in expanded form), declared in node typent:propertyDefinition
.static java.lang.String
JCR_DESCRIPTION
A constant for the property namejcr:description
(in expanded form), declared in node typemix:title
.static java.lang.String
JCR_ENCODING
A constant for the property namejcr:encoding
(in expanded form), declared in node typemix:mimeType
.static java.lang.String
JCR_FROZEN_MIXIN_TYPES
A constant for the property namejcr:frozenMixinTypes
(in expanded form), declared in node typent:frozenNode
.static java.lang.String
JCR_FROZEN_PRIMARY_TYPE
A constant for the property namejcr:frozenPrimaryType
(in expanded form), declared in node typent:frozenNode
.static java.lang.String
JCR_FROZEN_UUID
A constant for the property namejcr:frozenUuid
(in expanded form), declared in node typent:frozenNode
.static java.lang.String
JCR_HAS_ORDERABLE_CHILD_NODES
A constant for the property namejcr:hasOrderableChildNodes
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_HOST
A constant for the property namejcr:host
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_ID
A constant for the property namejcr:id
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_IS_ABSTRACT
A constant for the property namejcr:isAbstract
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_IS_CHECKED_OUT
A constant for the property namejcr:isCheckedOut
(in expanded form), declared in node typemix:simpleVersionable
.static java.lang.String
JCR_IS_MIXIN
A constant for the property namejcr:isMixin
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_LANGUAGE
A constant for the property namejcr:language
(in expanded form), declared in node typesmix:language
andnt:query
.static java.lang.String
JCR_LAST_MODIFIED
A constant for the property namejcr:lastModified
(in expanded form), declared in node typemix:lastModified
.static java.lang.String
JCR_LAST_MODIFIED_BY
A constant for the property namejcr:lastModifiedBy
(in expanded form), declared in node typemix:lastModified
.static java.lang.String
JCR_LIFECYCLE_POLICY
A constant for the property namejcr:lifecyclePolicy
(in expanded form), declared in node typemix:lifecycle
.static java.lang.String
JCR_LOCK_IS_DEEP
A constant for the property namejcr:lockIsDeep
(in expanded form), declared in node typemix:lockable
.static java.lang.String
JCR_LOCK_OWNER
A constant for the property namejcr:lockOwner
(in expanded form), declared in node typemix:lockable
.static java.lang.String
JCR_MANDATORY
A constant for the property namejcr:mandatory
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.static java.lang.String
JCR_MERGE_FAILED
A constant for the property namejcr:mergeFailed
(in expanded form), declared in node typemix:versionable
.static java.lang.String
JCR_MIMETYPE
A constant for the property namejcr:mimeType
(in expanded form), declared in node typemix:mimeType
.static java.lang.String
JCR_MIXIN_TYPES
A constant for the property namejcr:mixinTypes
(in expanded form), declared in node typent:base
.static java.lang.String
JCR_MULTIPLE
A constant for the property namejcr:multiple
(in expanded form), declared in node typent:propertyDefinition
.static java.lang.String
JCR_NAME
A constant for the property namejcr:name
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.static java.lang.String
JCR_NODE_TYPE_NAME
A constant for the property namejcr:nodeTypeName
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_ON_PARENT_VERSION
A constant for the property namejcr:onParentVersion
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.static java.lang.String
JCR_PATH
A constant for the property namejcr:path
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_PORT
A constant for the property namejcr:port
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_PREDECESSORS
A constant for the property namejcr:predecessors
(in expanded form), declared in node typesmix:versionable
andnt:version
.static java.lang.String
JCR_PRIMARY_ITEM_NAME
A constant for the property namejcr:primaryItemName
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_PRIMARY_TYPE
A constant for the property namejcr:primaryType
(in expanded form), declared in node typent:base
.static java.lang.String
JCR_PROTECTED
A constant for the property namejcr:protected
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.static java.lang.String
JCR_PROTOCOL
A constant for the property namejcr:protocol
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_REPOSITORY
A constant for the property namejcr:repository
(in expanded form), declared in node typent:address
.static java.lang.String
JCR_REQUIRED_PRIMARY_TYPES
A constant for the property namejcr:requiredPrimaryTypes
(in expanded form), declared in node typent:childNodeDefinition
.static java.lang.String
JCR_REQUIRED_TYPE
A constant for the property namejcr:requiredType
(in expanded form), declared in node typent:propertyDefinition
.static java.lang.String
JCR_ROOT
A constant for the property namejcr:root
(in expanded form), declared in node typent:configuration
.static java.lang.String
JCR_SAME_NAME_SIBLINGS
A constant for the property namejcr:sameNameSiblings
(in expanded form), declared in node typent:childNodeDefinition
.static java.lang.String
JCR_STATEMENT
A constant for the property namejcr:statement
(in expanded form), declared in node typent:query
.static java.lang.String
JCR_SUCCESSORS
A constant for the property namejcr:successors
(in expanded form), declared in node typent:versione
.static java.lang.String
JCR_SUPERTYPES
A constant for the property namejcr:supertypes
(in expanded form), declared in node typent:nodeType
.static java.lang.String
JCR_TITLE
A constant for the property namejcr:title
(in expanded form), declared in node typesmix:title
andnt:activity
.static java.lang.String
JCR_UUID
A constant for the property namejcr:uuid
(in expanded form), declared in node typemix:referenceable
.static java.lang.String
JCR_VALUE_CONSTRAINTS
A constant for the property namejcr:valueConstraints
(in expanded form), declared in node typent:propertyDefinition
.static java.lang.String
JCR_VERSION_HISTORY
A constant for the property namejcr:versionHistory
(in expanded form), declared in node typemix:versionable
.static java.lang.String
JCR_VERSIONABLE_UUID
A constant for the property namejcr:versionableUuid
(in expanded form), declared in node typent:version
.static java.lang.String
JCR_WORKSPACE
A constant for the property namejcr:workspace
(in expanded form), declared in node typent:address
.
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description Binary
getBinary()
Returns aBinary
representation of the value of this property.boolean
getBoolean()
Returns aboolean
representation of the value of this property.java.util.Calendar
getDate()
Returns aCalendar
representation of the value of this property.java.math.BigDecimal
getDecimal()
Returns aBigDecimal
representation of the value of this property.PropertyDefinition
getDefinition()
Returns the property definition that applies to this property.double
getDouble()
Returns adouble
representation of the value of this property.long
getLength()
Returns the length of the value of this property.long[]
getLengths()
Returns an array holding the lengths of the values of this (multi-value) property in bytes where each is individually calculated as described ingetLength()
.long
getLong()
Returns along
representation of the value of this property.Node
getNode()
If this property is of typeREFERENCE
,WEAKREFERENCE
orPATH
(or convertible to one of these types) this method returns theNode
to which this property refers.Property
getProperty()
If this property is of typePATH
(or convertible to this type) this method returns theProperty
to which this property refers.java.io.InputStream
getStream()
Deprecated.As of JCR 2.0,getBinary()
should be used instead.java.lang.String
getString()
Returns aString
representation of the value of this property.int
getType()
Returns the type of thisProperty
.Value
getValue()
Returns the value of this property as aValue
object.Value[]
getValues()
Returns an array of all the values of this property.boolean
isMultiple()
Returnstrue
if this property is multi-valued andfalse
if this property is single-valued.void
setValue(boolean value)
Sets the value of this property tovalue
.void
setValue(double value)
Sets the value of this property tovalue
.void
setValue(long value)
Sets the value of this property tovalue
.void
setValue(java.io.InputStream value)
Deprecated.As of JCR 2.0,setValue(Binary)
should be used instead.void
setValue(java.lang.String value)
Sets the value of this property tovalue
.void
setValue(java.lang.String[] values)
Sets the value of this property to thevalues
array.void
setValue(java.math.BigDecimal value)
Sets the value of this property tovalue
.void
setValue(java.util.Calendar value)
Sets the value of this property tovalue
.void
setValue(Binary value)
Sets the value of this property tovalue
.void
setValue(Node value)
Sets thisREFERENCE
orWEAKREFERNCE
property to refer to the specified node.void
setValue(Value value)
Sets the value of this property tovalue
.void
setValue(Value[] values)
Sets the value of this property to thevalues
array.-
Methods inherited from interface javax.jcr.Item
accept, getAncestor, getDepth, getName, getParent, getPath, getSession, isModified, isNew, isNode, isSame, refresh, remove, save
-
-
-
-
Field Detail
-
JCR_PRIMARY_TYPE
static final java.lang.String JCR_PRIMARY_TYPE
A constant for the property namejcr:primaryType
(in expanded form), declared in node typent:base
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_MIXIN_TYPES
static final java.lang.String JCR_MIXIN_TYPES
A constant for the property namejcr:mixinTypes
(in expanded form), declared in node typent:base
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CONTENT
static final java.lang.String JCR_CONTENT
A constant for the property namejcr:content
(in expanded form), declared in node typent:linkedFile
. Note,jcr:content
is also the name of a child node declared innt:file
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_DATA
static final java.lang.String JCR_DATA
A constant for the property namejcr:data
(in expanded form), declared in node typent:resource
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PROTOCOL
static final java.lang.String JCR_PROTOCOL
A constant for the property namejcr:protocol
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_HOST
static final java.lang.String JCR_HOST
A constant for the property namejcr:host
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PORT
static final java.lang.String JCR_PORT
A constant for the property namejcr:port
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_REPOSITORY
static final java.lang.String JCR_REPOSITORY
A constant for the property namejcr:repository
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_WORKSPACE
static final java.lang.String JCR_WORKSPACE
A constant for the property namejcr:workspace
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PATH
static final java.lang.String JCR_PATH
A constant for the property namejcr:path
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_ID
static final java.lang.String JCR_ID
A constant for the property namejcr:id
(in expanded form), declared in node typent:address
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_UUID
static final java.lang.String JCR_UUID
A constant for the property namejcr:uuid
(in expanded form), declared in node typemix:referenceable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_TITLE
static final java.lang.String JCR_TITLE
A constant for the property namejcr:title
(in expanded form), declared in node typesmix:title
andnt:activity
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_DESCRIPTION
static final java.lang.String JCR_DESCRIPTION
A constant for the property namejcr:description
(in expanded form), declared in node typemix:title
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CREATED
static final java.lang.String JCR_CREATED
A constant for the property namejcr:created
(in expanded form), declared in node typesmix:created
andnt:version
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CREATED_BY
static final java.lang.String JCR_CREATED_BY
A constant for the property namejcr:createdBy
(in expanded form), declared in node typemix:created
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LAST_MODIFIED
static final java.lang.String JCR_LAST_MODIFIED
A constant for the property namejcr:lastModified
(in expanded form), declared in node typemix:lastModified
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LAST_MODIFIED_BY
static final java.lang.String JCR_LAST_MODIFIED_BY
A constant for the property namejcr:lastModifiedBy
(in expanded form), declared in node typemix:lastModified
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LANGUAGE
static final java.lang.String JCR_LANGUAGE
A constant for the property namejcr:language
(in expanded form), declared in node typesmix:language
andnt:query
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_MIMETYPE
static final java.lang.String JCR_MIMETYPE
A constant for the property namejcr:mimeType
(in expanded form), declared in node typemix:mimeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_ENCODING
static final java.lang.String JCR_ENCODING
A constant for the property namejcr:encoding
(in expanded form), declared in node typemix:mimeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_NODE_TYPE_NAME
static final java.lang.String JCR_NODE_TYPE_NAME
A constant for the property namejcr:nodeTypeName
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_SUPERTYPES
static final java.lang.String JCR_SUPERTYPES
A constant for the property namejcr:supertypes
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_IS_ABSTRACT
static final java.lang.String JCR_IS_ABSTRACT
A constant for the property namejcr:isAbstract
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_IS_MIXIN
static final java.lang.String JCR_IS_MIXIN
A constant for the property namejcr:isMixin
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_HAS_ORDERABLE_CHILD_NODES
static final java.lang.String JCR_HAS_ORDERABLE_CHILD_NODES
A constant for the property namejcr:hasOrderableChildNodes
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PRIMARY_ITEM_NAME
static final java.lang.String JCR_PRIMARY_ITEM_NAME
A constant for the property namejcr:primaryItemName
(in expanded form), declared in node typent:nodeType
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_NAME
static final java.lang.String JCR_NAME
A constant for the property namejcr:name
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_AUTOCREATED
static final java.lang.String JCR_AUTOCREATED
A constant for the property namejcr:autoCreated
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_MANDATORY
static final java.lang.String JCR_MANDATORY
A constant for the property namejcr:mandatory
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PROTECTED
static final java.lang.String JCR_PROTECTED
A constant for the property namejcr:protected
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_ON_PARENT_VERSION
static final java.lang.String JCR_ON_PARENT_VERSION
A constant for the property namejcr:onParentVersion
(in expanded form), declared in node typesnt:propertyDefinition
andnt:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_REQUIRED_TYPE
static final java.lang.String JCR_REQUIRED_TYPE
A constant for the property namejcr:requiredType
(in expanded form), declared in node typent:propertyDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_VALUE_CONSTRAINTS
static final java.lang.String JCR_VALUE_CONSTRAINTS
A constant for the property namejcr:valueConstraints
(in expanded form), declared in node typent:propertyDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_DEFAULT_VALUES
static final java.lang.String JCR_DEFAULT_VALUES
A constant for the property namejcr:defaultValues
(in expanded form), declared in node typent:propertyDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_MULTIPLE
static final java.lang.String JCR_MULTIPLE
A constant for the property namejcr:multiple
(in expanded form), declared in node typent:propertyDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_REQUIRED_PRIMARY_TYPES
static final java.lang.String JCR_REQUIRED_PRIMARY_TYPES
A constant for the property namejcr:requiredPrimaryTypes
(in expanded form), declared in node typent:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_DEFAULT_PRIMARY_TYPE
static final java.lang.String JCR_DEFAULT_PRIMARY_TYPE
A constant for the property namejcr:defaultPrimaryType
(in expanded form), declared in node typent:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_SAME_NAME_SIBLINGS
static final java.lang.String JCR_SAME_NAME_SIBLINGS
A constant for the property namejcr:sameNameSiblings
(in expanded form), declared in node typent:childNodeDefinition
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LOCK_OWNER
static final java.lang.String JCR_LOCK_OWNER
A constant for the property namejcr:lockOwner
(in expanded form), declared in node typemix:lockable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LOCK_IS_DEEP
static final java.lang.String JCR_LOCK_IS_DEEP
A constant for the property namejcr:lockIsDeep
(in expanded form), declared in node typemix:lockable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_LIFECYCLE_POLICY
static final java.lang.String JCR_LIFECYCLE_POLICY
A constant for the property namejcr:lifecyclePolicy
(in expanded form), declared in node typemix:lifecycle
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CURRENT_LIFECYCLE_STATE
static final java.lang.String JCR_CURRENT_LIFECYCLE_STATE
A constant for the property namejcr:currentLifecycleState
(in expanded form), declared in node typemix:lifecycle
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_IS_CHECKED_OUT
static final java.lang.String JCR_IS_CHECKED_OUT
A constant for the property namejcr:isCheckedOut
(in expanded form), declared in node typemix:simpleVersionable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_FROZEN_PRIMARY_TYPE
static final java.lang.String JCR_FROZEN_PRIMARY_TYPE
A constant for the property namejcr:frozenPrimaryType
(in expanded form), declared in node typent:frozenNode
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_FROZEN_MIXIN_TYPES
static final java.lang.String JCR_FROZEN_MIXIN_TYPES
A constant for the property namejcr:frozenMixinTypes
(in expanded form), declared in node typent:frozenNode
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_FROZEN_UUID
static final java.lang.String JCR_FROZEN_UUID
A constant for the property namejcr:frozenUuid
(in expanded form), declared in node typent:frozenNode
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_VERSION_HISTORY
static final java.lang.String JCR_VERSION_HISTORY
A constant for the property namejcr:versionHistory
(in expanded form), declared in node typemix:versionable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_BASE_VERSION
static final java.lang.String JCR_BASE_VERSION
A constant for the property namejcr:baseVersion
(in expanded form), declared in node typemix:versionable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_PREDECESSORS
static final java.lang.String JCR_PREDECESSORS
A constant for the property namejcr:predecessors
(in expanded form), declared in node typesmix:versionable
andnt:version
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_MERGE_FAILED
static final java.lang.String JCR_MERGE_FAILED
A constant for the property namejcr:mergeFailed
(in expanded form), declared in node typemix:versionable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_ACTIVITY
static final java.lang.String JCR_ACTIVITY
A constant for the property namejcr:activity
(in expanded form), declared in node typesmix:versionable
andnt:version
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CONFIGURATION
static final java.lang.String JCR_CONFIGURATION
A constant for the property namejcr:configuration
(in expanded form), declared in node typemix:versionable
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_VERSIONABLE_UUID
static final java.lang.String JCR_VERSIONABLE_UUID
A constant for the property namejcr:versionableUuid
(in expanded form), declared in node typent:version
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_COPIED_FROM
static final java.lang.String JCR_COPIED_FROM
A constant for the property namejcr:copiedFrom
(in expanded form), declared in node typent:version
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_SUCCESSORS
static final java.lang.String JCR_SUCCESSORS
A constant for the property namejcr:successors
(in expanded form), declared in node typent:versione
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_CHILD_VERSION_HISTORY
static final java.lang.String JCR_CHILD_VERSION_HISTORY
A constant for the property namejcr:childVersionHistory
(in expanded form), declared in node typent:versionedChild
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_ROOT
static final java.lang.String JCR_ROOT
A constant for the property namejcr:root
(in expanded form), declared in node typent:configuration
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
JCR_STATEMENT
static final java.lang.String JCR_STATEMENT
A constant for the property namejcr:statement
(in expanded form), declared in node typent:query
.- Since:
- JCR 2.0
- See Also:
- Constant Field Values
-
-
Method Detail
-
setValue
void setValue(Value value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. If this property's property type is not constrained by the node type of its parent node, then the property type is changed to that of the suppliedvalue
. If the property type is constrained, then a best-effort conversion is attempted.This method is a session-write and therefore requires a
save
to dispatch the change.A
ConstraintViolationException
will be thrown either immediately, on dispatch, or on persist, if the change would violate a node type or implementation-specific constraint. Implementations may differ on when this validation is performed.A
VersionException
will be thrown either immediately, on dispatch, or on persist, if this property belongs to a node that is versionable and checked-in or is non-versionable but whose nearest versionable ancestor is checked-in. Implementations may differ on when this validation is performed.A
LockException
will be thrown either immediately, on dispatch, or on persist, if a lock prevents the setting of the value. Implementations may differ on when this validation is performed.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(Value[] values) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property to thevalues
array. If this property's property type is not constrained by the node type of its parent node, then the property type may be changed. If the property type is constrained, then a best-effort conversion is attempted, according to an implemention-dependent definition of "best effort". The change will be persisted (if valid) onsave
.A
ConstraintViolationException
will be thrown either immediately, on dispatch, or on persist, if the change would violate a node type or implementation-specific constraint. Implementations may differ on when this validation is performed.A
VersionException
will be thrown either immediately, on dispatch, or on persist, if this property belongs to a node that is read-only due to a checked-in node. Implementations may differ on when this validation is performed.A
LockException
will be thrown either immediately, on dispatch, or on persist, if a lock prevents the setting of the value. Implementations may differ on when this validation is performed.- Parameters:
values
- The new values to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified values is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(java.lang.String value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
String
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified values is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(java.lang.String[] values) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property to thevalues
array. Same as
except that the values are specified as asetValue(Value[] values)
String[]
.- Parameters:
values
- The new values to set the property to.- Throws:
ValueFormatException
- if the type or format of one or more of the specified values is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(java.io.InputStream value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Deprecated.As of JCR 2.0,setValue(Binary)
should be used instead.Sets the value of this property tovalue
. Same as
except that the value is specified as ansetValue(Value value)
InputStream
.The passed stream is closed before this method returns either normally or because of an exception.
- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(Binary value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
Binary
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.- Since:
- JCR 2.0
-
setValue
void setValue(long value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
long
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(double value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
double
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(java.math.BigDecimal value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
BigDecimal
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.- Since:
- JCR 2.0
-
setValue
void setValue(java.util.Calendar value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
Calendar
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(boolean value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets the value of this property tovalue
. Same as
except that the value is specified as asetValue(Value value)
boolean
.- Parameters:
value
- The new value to set the property to.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
setValue
void setValue(Node value) throws ValueFormatException, VersionException, LockException, ConstraintViolationException, RepositoryException
Sets thisREFERENCE
orWEAKREFERNCE
property to refer to the specified node.- Parameters:
value
- The node to which this property will refer.- Throws:
ValueFormatException
- if the type or format of the specified value is incompatible with the type of this property the specified node is not referenceable.VersionException
- if this property belongs to a node that is read-only due to a checked-in node and this implementation performs this validation immediately.LockException
- if a lock prevents the setting of the value and this implementation performs this validation immediately.ConstraintViolationException
- if the change would violate a node-type or other constraint and this implementation performs this validation immediately.RepositoryException
- if another error occurs.
-
getValue
Value getValue() throws ValueFormatException, RepositoryException
Returns the value of this property as aValue
object.The object returned is a copy of the stored value and is immutable.
- Returns:
- the
Value
. - Throws:
ValueFormatException
- if the property is multi-valued.RepositoryException
- if another error occurs.
-
getValues
Value[] getValues() throws ValueFormatException, RepositoryException
Returns an array of all the values of this property. Used to access multi-value properties. The array returned is a copy of the stored values, so changes to it are not reflected in internal storage.- Returns:
- a
Value
array. - Throws:
ValueFormatException
- if the property is single-valued.RepositoryException
- if another error occurs.
-
getString
java.lang.String getString() throws ValueFormatException, RepositoryException
Returns aString
representation of the value of this property. A shortcut forProperty.getValue().getString()
.- Returns:
- A string representation of the value of this property.
- Throws:
ValueFormatException
- if conversion to aString
is not possible or if the property is multi-valued.RepositoryException
- if another error occurs.- See Also:
Value
-
getStream
java.io.InputStream getStream() throws ValueFormatException, RepositoryException
Deprecated.As of JCR 2.0,getBinary()
should be used instead.Returns anInputStream
representation of the value of this property. A shortcut forProperty.getValue().getStream()
.It is the responsibility of the caller to close the returned InputStream.
- Returns:
- A stream representation of the value of this property.
- Throws:
ValueFormatException
- if the property is multi-valued.RepositoryException
- if another error occurs- See Also:
Value
-
getBinary
Binary getBinary() throws ValueFormatException, RepositoryException
Returns aBinary
representation of the value of this property. A shortcut forProperty.getValue().getBinary()
.- Returns:
- A
Binary
representation of the value of this property. - Throws:
ValueFormatException
- if the property is multi-valued.RepositoryException
- if another error occurs.- Since:
- JCR 2.0
- See Also:
Value
,Binary
-
getLong
long getLong() throws ValueFormatException, RepositoryException
Returns along
representation of the value of this property. A shortcut forProperty.getValue().getLong()
.- Returns:
- A
long
representation of the value of this property. - Throws:
ValueFormatException
- if conversion to along
is not possible or if the property is multi-valued.RepositoryException
- if another error occurs.- See Also:
Value
-
getDouble
double getDouble() throws ValueFormatException, RepositoryException
Returns adouble
representation of the value of this property. A shortcut forProperty.getValue().getDouble()
.- Returns:
- A
double
representation of the value of this property. - Throws:
ValueFormatException
- if conversion to adouble
is not possible or if the property is multi-valued.RepositoryException
- if another error occurs.- See Also:
Value
-
getDecimal
java.math.BigDecimal getDecimal() throws ValueFormatException, RepositoryException
Returns aBigDecimal
representation of the value of this property. A shortcut forProperty.getValue().getDecimal()
.- Returns:
- A
BigDecimal
representation of the value of this property. - Throws:
ValueFormatException
- if conversion to aBigDecimal
is not possible or if the property is multi-valued.RepositoryException
- if another error occurs- Since:
- JCR 2.0
- See Also:
Value
-
getDate
java.util.Calendar getDate() throws ValueFormatException, RepositoryException
Returns aCalendar
representation of the value of this property. A shortcut forProperty.getValue().getDate()
.- Returns:
- A
Calendar
representation of the value of this property. - Throws:
ValueFormatException
- if conversion to a string is not possible or if the property is multi-valued.RepositoryException
- if another error occurs.- See Also:
Value
-
getBoolean
boolean getBoolean() throws ValueFormatException, RepositoryException
Returns aboolean
representation of the value of this property. A shortcut forProperty.getValue().getBoolean()
.- Returns:
- A
boolean
representation of the value of this property. - Throws:
ValueFormatException
- if conversion to aboolean
is not possible or if the property is multi-valued.RepositoryException
- if another error occurs.- See Also:
Value
-
getNode
Node getNode() throws ItemNotFoundException, ValueFormatException, RepositoryException
If this property is of typeREFERENCE
,WEAKREFERENCE
orPATH
(or convertible to one of these types) this method returns theNode
to which this property refers.If this property is of type
PATH
and it contains a relative path, it is interpreted relative to the parent node of this property. For example ".
" refers to the parent node itself, "..
" to the parent of the parent node and "foo
" to a sibling node of this property.- Returns:
- the referenced Node
- Throws:
ValueFormatException
- if this property cannot be converted to a referring type (REFERENCE
,WEAKREFERENCE
orPATH
), if the property is multi-valued or if this property is a referring type but is currently part of the frozen state of a version in version storage.ItemNotFoundException
- If this property is of typePATH
orWEAKREFERENCE
and no target node accessible by the currentSession
exists in this workspace. Note that this applies even if the property is aPATHS
and a property exists at the specified location. To dereference to a target property (as opposed to a target node), the methodProperty.getProperty
is used.RepositoryException
- if another error occurs.
-
getProperty
Property getProperty() throws ItemNotFoundException, ValueFormatException, RepositoryException
If this property is of typePATH
(or convertible to this type) this method returns theProperty
to which this property refers.If this property contains a relative path, it is interpreted relative to the parent node of this property. Therefore, when resolving such a relative path, the segment "
.
" refers to the parent node itself, "..
" to the parent of the parent node and "foo
" to a sibling property of this property or this property itself.For example, if this property is located at
/a/b/c
and it has a value of "../d
" then this method will return the property at/a/d
if such exists.If this property is multi-valued, this method throws a
ValueFormatException
.If this property cannot be converted to a
PATH
then aValueFormatException
is thrown.If this property is currently part of the frozen state of a version in version storage, this method will throw a
ValueFormatException
.- Returns:
- the referenced property
- Throws:
ValueFormatException
- if this property cannot be converted to aPATH
, if the property is multi-valued or if this property is a referring type but is currently part of the frozen state of a version in version storage.ItemNotFoundException
- If no property accessible by the currentSession
exists in this workspace at the specified path. Note that this applies even if a node exists at the specified location. To dereference to a target node, the methodProperty.getNode
is used.RepositoryException
- if another error occurs.- Since:
- JCR 2.0
-
getLength
long getLength() throws ValueFormatException, RepositoryException
Returns the length of the value of this property.For a
BINARY
property,getLength
returns the number of bytes. For other property types,getLength
returns the same value that would be returned by callingString.length()
on the value when it has been converted to aSTRING
according to standard JCR property type conversion.Returns -1 if the implementation cannot determine the length.
- Returns:
- an
long
. - Throws:
ValueFormatException
- if this property is multi-valued.RepositoryException
- if another error occurs.
-
getLengths
long[] getLengths() throws ValueFormatException, RepositoryException
Returns an array holding the lengths of the values of this (multi-value) property in bytes where each is individually calculated as described ingetLength()
.Returns a
-1
in the appropriate position if the implementation cannot determine the length of a value.- Returns:
- an array of lengths
- Throws:
ValueFormatException
- if this property is single-valued.RepositoryException
- if another error occurs.
-
getDefinition
PropertyDefinition getDefinition() throws RepositoryException
Returns the property definition that applies to this property. In some cases there may appear to be more than one definition that could apply to this node. However, it is assumed that upon creation or change of this property, a single particular definition is chosen by the implementation. It is that definition that this method returns. How this governing definition is selected upon property creation or change from among others which may have been applicable is an implementation issue and is not covered by this specification.- Returns:
- a
PropertyDefinition
object. - Throws:
RepositoryException
- if an error occurs.- See Also:
NodeType.getPropertyDefinitions()
-
getType
int getType() throws RepositoryException
Returns the type of thisProperty
. One of:PropertyType.STRING
PropertyType.BINARY
PropertyType.DATE
PropertyType.DOUBLE
PropertyType.LONG
PropertyType.BOOLEAN
PropertyType.NAME
PropertyType.PATH
PropertyType.REFERENCE
PropertyType.WEAKREFERENCE
PropertyType.URI
p
, the type returned byp.getType()
will differ from the type returned byp.getDefinition.getRequiredType()
only in the case where the latter returnsUNDEFINED
. The type of a property instance is neverUNDEFINED
(it must always have some actual type).- Returns:
- an int
- Throws:
RepositoryException
- if an error occurs
-
isMultiple
boolean isMultiple() throws RepositoryException
Returnstrue
if this property is multi-valued andfalse
if this property is single-valued.- Returns:
true
if this property is multi-valued;false
otherwise.- Throws:
RepositoryException
- if an error occurs.
-
-