EclipseLink 2.0.0, build 'v20091127-r5931' API Reference

org.eclipse.persistence.sdo
Class SDOProperty

java.lang.Object
  extended by org.eclipse.persistence.sdo.SDOProperty
All Implemented Interfaces:
Property, java.io.Serializable

public class SDOProperty
extends java.lang.Object
implements Property, java.io.Serializable

Purpose:A representation of a Property in the type of a data object.

Responsibilities:

See Also:
Serialized Form

Constructor Summary
SDOProperty(HelperContext aContext)
           
SDOProperty(HelperContext aContext, java.lang.String aName)
           
SDOProperty(HelperContext aContext, java.lang.String aName, SDOType aType)
           
SDOProperty(HelperContext aContext, java.lang.String aUri, java.lang.String aName, SDOType aType)
           
 
Method Summary
 void addMappingToOwner(boolean sdoMethodAttributeAccessor, int indexToAdd)
          INTERNAL:
 void buildChangeSummaryMapping()
          INTERNAL:
 void buildMapping(java.lang.String mappingUri)
          INTERNAL:
 void buildMapping(java.lang.String mappingUri, int indexToAdd)
          INTERNAL:
 XMLFragmentCollectionMapping buildXMLFragmentCollectionMapping(java.lang.String mappingUri)
           
 XMLFragmentMapping buildXMLFragmentMapping(java.lang.String uri)
           
 boolean equals(java.lang.Object obj)
          Indicate if a given SDOProperty instance is equal to this instance.
 java.lang.Object get(Property property)
          Returns the value of the specified instance property of this Property.
 java.util.List getAliasNames()
          Return a list of alias names for this Property.
 java.util.List getAppInfoElements()
          INTERNAL:
 java.util.Map getAppInfoMap()
          INTERNAL:
 SDOType getContainingType()
          Returns the containing type of this Property.
 java.lang.Object getDefault()
          Returns the default value this Property will have in a data object where the Property hasn't been set.
 int getIndexInDeclaredProperties()
          INTERNAL:
 int getIndexInType()
          INTERNAL:
 java.util.List getInstanceProperties()
          Returns a read-only List of instance Properties available on this Property.
 MimeTypePolicy getMimeTypePolicy()
          INTERNAL:
 java.lang.String getName()
          Returns the name of the Property.
 SDOProperty getOpposite()
          Returns the opposite Property if the Property is bi-directional or null otherwise.
 java.util.Map getPropertyValues()
          INTERNAL:
 java.lang.String getQualifiedXPath(java.lang.String uri, boolean simple)
          INTERNAL:
 java.util.Collection<SDOProperty> getSubstitutableElements()
           
 SDOType getType()
          Returns the type of the Property.
 java.lang.String getUri()
           
 DatabaseMapping getXmlMapping()
          INTERNAL:
 java.lang.String getXPath()
          INTERNAL:
 java.lang.String getXsdLocalName()
          INTERNAL: Returns the local name of the Property.
 javax.xml.namespace.QName getXsdType()
          INTERNAL:
 int hashCode()
          Return a unique hashCode (as an int) for this instance.
 boolean isContainment()
          Returns whether the Property is containment, i.e., whether it represents by-value composition.
 boolean isDefaultSet()
          INTERNAL: Return whether the default value has been set by the schema either via a define by an XSD or a DataObject.
 boolean isFinalized()
           
 boolean isGlobal()
          INTERNAL:
 boolean isMany()
          Returns whether the Property is many-valued.
 boolean isNameCollision()
           
 boolean isNamespaceQualified()
          INTERNAL: Returns if the element or attribute corresponding to this Property should be namespace qualified in the XSD.
 boolean isNullable()
          Returns whether or not instances of this property can be set to null.
 boolean isOpenContent()
          Return whether or not this is an open content property.
 boolean isReadOnly()
          Returns true if values for this Property cannot be modified using the SDO APIs.
 boolean isSubstitutable()
           
 boolean isValueProperty()
          INTERNAL:
 boolean isXsd()
          INTERNAL: Returns if this property was declared in an XML schema.
 void setAliasNames(java.util.List names)
          INTERNAL: Set this Property's alias name list which are unique within the Type.
 void setAppInfoElements(java.util.List appInfoElements)
          INTERNAL:
 void setContainingType(Type type)
          INTERNAL: Set the containing type of this Property.
 void setContainment(boolean containment)
          INTERNAL: Set this Property's Containment which shows parent-child relationship in a tree of DataObjects.
 void setDefault(java.lang.Object aDefaultValue)
          INTERNAL: Set the default value of this Property.
 void setFinalized(boolean isFinalized)
           
 void setGlobal(boolean global)
          INTERNAL:
 void setIndexInDeclaredProperties(int indexInDeclaredProperties)
          INTERNAL:
 void setIndexInType(int indexInType)
          INTERNAL:
 void setInstanceProperty(Property property, java.lang.Object value)
           
 void setMany(boolean many)
          INTERNAL: Set this property as single-valued(false) or many-valued(true).
 void setName(java.lang.String name)
          INTERNAL: Assign a string as a unique name of this Property among Properties that belongs to a DataObject.
 void setNameCollision(boolean nameCollision)
           
 void setNamespaceQualified(boolean namespaceQualified)
          INTERNAL: Set if the element or attribute corresponding to this Property is namespace qualified in the XSD.
 void setNullable(boolean nullable)
          INTERNAL:
 void setOpposite(Property property)
          INTERNAL: Set the opposite Property.
 void setPropertyValues(java.util.Map properties)
          INTERNAL:
 void setReadOnly(boolean readOnly)
          INTERNAL: Set this Property as read-only Property.
 void setSubstitutable(boolean substitutable)
           
 void setSubstitutableElements(java.util.Collection<SDOProperty> elements)
           
 void setType(Type type)
          INTERNAL: Assign a Type to this Property.
 void setUri(java.lang.String uri)
           
 void setValueProperty(boolean valueProperty)
          INTERNAL:
 void setXmlMapping(DatabaseMapping xmlMapping)
          INTERNAL:
 void setXsd(boolean xsd)
          INTERNAL: Set if this property was declared in an XML schema.
 void setXsdLocalName(java.lang.String xsdLocalName)
          INTERNAL: Set the local name of this property.
 void setXsdType(javax.xml.namespace.QName xsdType)
          INTERNAL:
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SDOProperty

public SDOProperty(HelperContext aContext)

SDOProperty

public SDOProperty(HelperContext aContext,
                   java.lang.String aName)

SDOProperty

public SDOProperty(HelperContext aContext,
                   java.lang.String aName,
                   SDOType aType)

SDOProperty

public SDOProperty(HelperContext aContext,
                   java.lang.String aUri,
                   java.lang.String aName,
                   SDOType aType)
Method Detail

getName

public java.lang.String getName()
Returns the name of the Property.

Specified by:
getName in interface Property
Returns:
the Property name.

getType

public SDOType getType()
Returns the type of the Property.

Specified by:
getType in interface Property
Returns:
the Property type.

isMany

public boolean isMany()
Returns whether the Property is many-valued.

Specified by:
isMany in interface Property
Returns:
true if the Property is many-valued.

isOpenContent

public boolean isOpenContent()
Return whether or not this is an open content property.

Specified by:
isOpenContent in interface Property
Returns:
true if this property is an open content property.

isContainment

public boolean isContainment()
Returns whether the Property is containment, i.e., whether it represents by-value composition.

Specified by:
isContainment in interface Property
Returns:
true if the Property is containment.

getContainingType

public SDOType getContainingType()
Returns the containing type of this Property.

Specified by:
getContainingType in interface Property
Returns:
the Property's containing type.
See Also:
Type.getProperties()

getDefault

public java.lang.Object getDefault()
Returns the default value this Property will have in a data object where the Property hasn't been set.

Specified by:
getDefault in interface Property
Returns:
the default value.

isReadOnly

public boolean isReadOnly()
Returns true if values for this Property cannot be modified using the SDO APIs. When true, DataObject.set(Property property, Object value) throws an exception. Values may change due to other factors, such as services operating on DataObjects.

Specified by:
isReadOnly in interface Property
Returns:
true if values for this Property cannot be modified.

getOpposite

public SDOProperty getOpposite()
Returns the opposite Property if the Property is bi-directional or null otherwise.

Specified by:
getOpposite in interface Property
Returns:
the opposite Property if the Property is bi-directional or null

getAliasNames

public java.util.List getAliasNames()
Return a list of alias names for this Property.

Specified by:
getAliasNames in interface Property
Returns:
a list of alias names for this Property.

setName

public void setName(java.lang.String name)
INTERNAL: Assign a string as a unique name of this Property among Properties that belongs to a DataObject.

Parameters:
name - a string representing unique name of a property of a DataObject.

setType

public void setType(Type type)
INTERNAL: Assign a Type to this Property.

Parameters:
type - the type of this property.

setContainment

public void setContainment(boolean containment)
INTERNAL: Set this Property's Containment which shows parent-child relationship in a tree of DataObjects.

Parameters:
containment - a boolean value showing if this Property is containment.

setMany

public void setMany(boolean many)
INTERNAL: Set this property as single-valued(false) or many-valued(true). Default is false.

Parameters:
many - a boolean value if this property is many-valued or not.

setReadOnly

public void setReadOnly(boolean readOnly)
INTERNAL: Set this Property as read-only Property.

Parameters:
readOnly - boolean value implying this Property is readonly.

setAliasNames

public void setAliasNames(java.util.List names)
INTERNAL: Set this Property's alias name list which are unique within the Type.

Parameters:
names - a list of alias name of this Property.

setContainingType

public void setContainingType(Type type)
INTERNAL: Set the containing type of this Property.

Parameters:
type - a Type which is the containing type of this Property

setDefault

public void setDefault(java.lang.Object aDefaultValue)
INTERNAL: Set the default value of this Property.

Parameters:
aDefaultValue - an Object to be the default value of this type.

setOpposite

public void setOpposite(Property property)
INTERNAL: Set the opposite Property. If not null then this Property is a of a bi-directional Property.

Parameters:
the - opposite Property if the Property is bi-directional, otherwise null

setXsd

public void setXsd(boolean xsd)
INTERNAL: Set if this property was declared in an XML schema.

Parameters:
xsd - a boolean representing if this property was declared in an XML schema

isXsd

public boolean isXsd()
INTERNAL: Returns if this property was declared in an XML schema. Defaults to false.

Returns:
if this property was declared in an XML schema

setXsdLocalName

public void setXsdLocalName(java.lang.String xsdLocalName)
INTERNAL: Set the local name of this property.

Parameters:
xsdLocalName - a String representing the local name of this property if it was declared in an XML schema

getXsdLocalName

public java.lang.String getXsdLocalName()
INTERNAL: Returns the local name of the Property.

Returns:
the local name of the property.

setNamespaceQualified

public void setNamespaceQualified(boolean namespaceQualified)
INTERNAL: Set if the element or attribute corresponding to this Property is namespace qualified in the XSD.

Parameters:
namespaceQualified - a boolean representing if the element or attribute corresponding to this Property is namespace qualified in the XSD.

isNamespaceQualified

public boolean isNamespaceQualified()
INTERNAL: Returns if the element or attribute corresponding to this Property should be namespace qualified in the XSD.

Returns:
if the element or attribute corresponding to this Property should be namespace qualified in the XSD.

setXmlMapping

public void setXmlMapping(DatabaseMapping xmlMapping)
INTERNAL:


getXmlMapping

public DatabaseMapping getXmlMapping()
INTERNAL:


setGlobal

public void setGlobal(boolean global)
INTERNAL:


isGlobal

public boolean isGlobal()
INTERNAL:


buildMapping

public void buildMapping(java.lang.String mappingUri)
INTERNAL:


buildMapping

public void buildMapping(java.lang.String mappingUri,
                         int indexToAdd)
INTERNAL:


buildChangeSummaryMapping

public void buildChangeSummaryMapping()
INTERNAL:


addMappingToOwner

public void addMappingToOwner(boolean sdoMethodAttributeAccessor,
                              int indexToAdd)
INTERNAL:


getXPath

public java.lang.String getXPath()
INTERNAL:


getQualifiedXPath

public java.lang.String getQualifiedXPath(java.lang.String uri,
                                          boolean simple)
INTERNAL:


get

public java.lang.Object get(Property property)
Description copied from interface: Property
Returns the value of the specified instance property of this Property.

Specified by:
get in interface Property
Parameters:
property - one of the properties returned by Property.getInstanceProperties().
Returns:
the value of the specified property.
See Also:
DataObject.get(Property)

getInstanceProperties

public java.util.List getInstanceProperties()
Description copied from interface: Property
Returns a read-only List of instance Properties available on this Property.

This list includes, at a minimum, any open content properties (extensions) added to the object before defining the Property's Type. Implementations may, but are not required to in the 2.1 version of SDO, provide additional instance properties.

Specified by:
getInstanceProperties in interface Property
Returns:
the List of instance Properties on this Property.

setPropertyValues

public void setPropertyValues(java.util.Map properties)
INTERNAL:


getPropertyValues

public java.util.Map getPropertyValues()
INTERNAL:


setInstanceProperty

public void setInstanceProperty(Property property,
                                java.lang.Object value)

setIndexInType

public void setIndexInType(int indexInType)
INTERNAL:


getIndexInType

public int getIndexInType()
INTERNAL:


setNullable

public void setNullable(boolean nullable)
INTERNAL:


isNullable

public boolean isNullable()
Description copied from interface: Property
Returns whether or not instances of this property can be set to null. The effect of calling set(null) on a non-nullable property is not specified by SDO.

Specified by:
isNullable in interface Property
Returns:
true if this property is nullable.

setXsdType

public void setXsdType(javax.xml.namespace.QName xsdType)
INTERNAL:


getXsdType

public javax.xml.namespace.QName getXsdType()
INTERNAL:


getMimeTypePolicy

public MimeTypePolicy getMimeTypePolicy()
INTERNAL:


setIndexInDeclaredProperties

public void setIndexInDeclaredProperties(int indexInDeclaredProperties)
INTERNAL:


getIndexInDeclaredProperties

public int getIndexInDeclaredProperties()
INTERNAL:


setValueProperty

public void setValueProperty(boolean valueProperty)
INTERNAL:


isValueProperty

public boolean isValueProperty()
INTERNAL:


setAppInfoElements

public void setAppInfoElements(java.util.List appInfoElements)
INTERNAL:


getAppInfoElements

public java.util.List getAppInfoElements()
INTERNAL:


getAppInfoMap

public java.util.Map getAppInfoMap()
INTERNAL:


setNameCollision

public void setNameCollision(boolean nameCollision)

isNameCollision

public boolean isNameCollision()

isDefaultSet

public boolean isDefaultSet()
INTERNAL: Return whether the default value has been set by the schema either via a define by an XSD or a DataObject.

Returns:
isDefaultSet

setUri

public void setUri(java.lang.String uri)

getUri

public java.lang.String getUri()

buildXMLFragmentMapping

public XMLFragmentMapping buildXMLFragmentMapping(java.lang.String uri)

buildXMLFragmentCollectionMapping

public XMLFragmentCollectionMapping buildXMLFragmentCollectionMapping(java.lang.String mappingUri)

isSubstitutable

public boolean isSubstitutable()

setSubstitutable

public void setSubstitutable(boolean substitutable)

getSubstitutableElements

public java.util.Collection<SDOProperty> getSubstitutableElements()

setSubstitutableElements

public void setSubstitutableElements(java.util.Collection<SDOProperty> elements)

setFinalized

public void setFinalized(boolean isFinalized)

isFinalized

public boolean isFinalized()

hashCode

public int hashCode()
Return a unique hashCode (as an int) for this instance.

Overrides:
hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)
Indicate if a given SDOProperty instance is equal to this instance. Equality is determined based on name, uri, and type. In addition, checking will be done to ensure that both properties are to be serialized in the same manner, ie. both to XML element or both to XML attribute.

Overrides:
equals in class java.lang.Object
Parameters:
obj - Object to compare to this SDOProperty instance
Returns:
true if obj is equal to this SDOProperty instance, false if not

EclipseLink 2.0.0, build 'v20091127-r5931' API Reference