org.eclipse.persistence.internal.oxm

Class TreeObjectBuilder

java.lang.Object

org.eclipse.persistence.internal.core.descriptors.CoreObjectBuilder<AbstractRecord,AbstractSession,DatabaseField,DatabaseMapping>

org.eclipse.persistence.internal.descriptors.ObjectBuilder

org.eclipse.persistence.internal.oxm.XMLObjectBuilder

org.eclipse.persistence.internal.oxm.TreeObjectBuilder

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

public class TreeObjectBuilder
extends XMLObjectBuilder
implements ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

INTERNAL:

Purpose: Perform the unmarshal and marshal operations based on the object-to-XML mapping metadata.

Responsibilities:

• Convert mapping metadata to a tree of XPathNodes. This tree is then traversed during unmarshal and marshal operations.
• Create records appropriate to this implementation of ObjectBuilder.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TreeObjectBuilder(ClassDescriptor descriptor)

Method Summary

Modifier and Type	Method and Description
boolean	addClassIndicatorFieldToRow(AbstractMarshalRecord abstractMarshalRecord)
java.util.List	addExtraNamespacesToNamespaceResolver(Descriptor desc, AbstractMarshalRecord marshalRecord, CoreAbstractSession session, boolean allowOverride, boolean ignoreEqualResolvers)
AbstractRecord	buildRow(AbstractRecord record, java.lang.Object object, AbstractSession session, DatabaseMapping.WriteType writeType) Build the row representation of an object.
XMLRecord	buildRow(XMLRecord record, java.lang.Object object, CoreAbstractSession session, XMLMarshaller marshaller, XPathFragment rootFragment)
java.lang.Class	classFromRow(UnmarshalRecord unmarshalRecord, AbstractSession session)
AbstractRecord	createRecord(AbstractSession session) Create a new row/record for the object builder.
AbstractRecord	createRecord(int size, AbstractSession session) Create a new row/record for the object builder.
AbstractMarshalRecord	createRecord(java.lang.String rootName, AbstractSession session) Create a new row/record for the object builder with the given name.
AbstractMarshalRecord	createRecord(java.lang.String rootName, org.w3c.dom.Node parent, AbstractSession session) Create a new row/record for the object builder with the given name.
java.util.List	getContainerValues()
java.util.List	getDefaultEmptyContainerValues()
java.util.List	getNullCapableValues()
java.util.List<DatabaseMapping>	getPrimaryKeyMappings() Return primary key mappings.
XPathNode	getRootXPathNode()
java.util.List	getTransformationMappings()
void	initialize(AbstractSession session) Cache all the mappings by their attribute and fields.
boolean	marshalAttributes(MarshalRecord marshalRecord, java.lang.Object object, CoreAbstractSession session)

Methods inherited from class org.eclipse.persistence.internal.oxm.XMLObjectBuilder

addNamespaceDeclarations, buildAttributesIntoObject, buildIntoNestedRow, buildIntoNestedRow, buildIntoNestedRow, buildObject, buildRow, buildRow, buildRow, createRecord, createRecordFor, createRecordFor, createRecordFor, extractPrimaryKeyFromExpression, extractPrimaryKeyFromObject, extractPrimaryKeyRowFromExpression, getNamespaceResolver, isXMLObjectBuilder, isXsiTypeIndicatorField, setDescriptor, writeExtraNamespaces, writeOutMappings

Methods inherited from class org.eclipse.persistence.internal.descriptors.ObjectBuilder

addPrimaryKeyForNonDefaultTable, addPrimaryKeyForNonDefaultTable, assignReturnRow, assignReturnValueForField, assignSequenceNumber, assignSequenceNumber, buildAttributesIntoShallowObject, buildAttributesIntoWorkingCopyClone, buildBackupClone, buildDeleteExpression, buildExpressionFromExample, buildNewInstance, buildObject, buildObject, buildObjectFromResultSet, buildObjectsFromCursorInto, buildObjectsFromResultSetInto, buildObjectsInto, buildPrimaryKeyAttributesIntoObject, buildPrimaryKeyExpression, buildPrimaryKeyExpressionFromKeys, buildPrimaryKeyExpressionFromObject, buildRow, buildRowForShallowInsert, buildRowForShallowInsert, buildRowForTranslation, buildRowForUpdate, buildRowForUpdate, buildRowForUpdateAfterShallowInsert, buildRowForUpdateAfterShallowInsert, buildRowForUpdateBeforeShallowDelete, buildRowForUpdateBeforeShallowDelete, buildRowForUpdateWithChangeSet, buildRowForWhereClause, buildRowFromPrimaryKeyValues, buildRowWithChangeSet, buildTemplateInsertRow, buildTemplateInsertRow, buildTemplateUpdateRow, buildUpdateExpression, cacheForeignKeyValues, cacheForeignKeyValues, cascadeDiscoverAndPersistUnregisteredNewObjects, cascadePerformRemove, cascadePerformRemovePrivateOwnedObjectFromChangeSet, cascadeRegisterNewForCreate, clearPrimaryKey, clone, compareForChange, compareObjects, copyInto, copyInto, copyObject, createObjectChangeSet, createObjectChangeSet, createObjectChangeSet, createPrimaryKeyExpression, createRecordFromXMLContext, extractPrimaryKeyFromObject, extractPrimaryKeyFromRow, extractPrimaryKeyRowFromObject, extractRowFromExpression, extractValueFromObjectForField, fixObjectReferences, getBaseChangeRecordForField, getBaseMappingForField, getBaseValueForField, getBatchFetchedAttributes, getCloningMappings, getDescriptor, getEagerMappings, getFieldClassification, getFieldForQueryKeyName, getFieldsMap, getJoinedAttributes, getLockAttribute, getMappingForAttributeName, getMappingForField, getMappingsByField, getParentObjectForField, getPrimaryKeyClassifications, getPrimaryKeyExpression, getReadOnlyMappingsByField, getReadOnlyMappingsForField, getRelationshipMappings, getSequenceMapping, getTargetFieldForQueryKeyName, hasBatchFetchedAttributes, hasCacheIndexesInSopObject, hasInBatchFetchedAttribute, hasJoinedAttributes, hasWrapperPolicy, initializeBatchFetchedAttributes, initializeJoinedAttributes, initializePrimaryKey, instantiateClone, instantiateEagerMappings, instantiateWorkingCopyClone, instantiateWorkingCopyCloneFromRow, isPrimaryKeyComponentInvalid, isPrimaryKeyExpression, isPrimaryKeyMapping, isSimple, iterate, load, loadAll, loadAll, mergeChangesIntoObject, mergeChangesIntoObject, mergeIntoObject, mergeIntoObject, populateAttributesForClone, postInitialize, recordPrivateOwnedRemovals, rehashFieldDependancies, setHasInBatchFetchedAttribute, setHasWrapperPolicy, setMappingsByField, setPrimaryKeyClassifications, setPrimaryKeyExpression, setReadOnlyMappingsByField, setSequenceMapping, shouldKeepRow, toString, trimFieldsForInsert, unwrapObject, updateCachedAttributes, validate, verifyDelete, wrapObject, writeIntoRowFromPrimaryKeyValues

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.persistence.internal.oxm.ObjectBuilder

buildNewInstance, extractPrimaryKeyFromObject, getDescriptor, isXsiTypeIndicatorField

Constructor Detail

TreeObjectBuilder

public TreeObjectBuilder(ClassDescriptor descriptor)

Method Detail

getRootXPathNode

public XPathNode getRootXPathNode()

Specified by:

getRootXPathNode in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

getPrimaryKeyMappings

public java.util.List<DatabaseMapping> getPrimaryKeyMappings()

Description copied from class: ObjectBuilder

Return primary key mappings.

Overrides:

getPrimaryKeyMappings in class ObjectBuilder

getTransformationMappings

public java.util.List getTransformationMappings()

Specified by:

getTransformationMappings in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

getContainerValues

public java.util.List getContainerValues()

Specified by:

getContainerValues in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

getNullCapableValues

public java.util.List getNullCapableValues()

Specified by:

getNullCapableValues in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

getDefaultEmptyContainerValues

public java.util.List getDefaultEmptyContainerValues()

Specified by:

getDefaultEmptyContainerValues in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

initialize

public void initialize(AbstractSession session)

Description copied from class: ObjectBuilder

Cache all the mappings by their attribute and fields.

Overrides:

initialize in class XMLObjectBuilder

buildRow

public AbstractRecord buildRow(AbstractRecord record,
                               java.lang.Object object,
                               AbstractSession session,
                               DatabaseMapping.WriteType writeType)

Description copied from class: ObjectBuilder

Build the row representation of an object.

Overrides:

buildRow in class ObjectBuilder

buildRow

public XMLRecord buildRow(XMLRecord record,
                          java.lang.Object object,
                          CoreAbstractSession session,
                          XMLMarshaller marshaller,
                          XPathFragment rootFragment)

Specified by:

buildRow in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

marshalAttributes

public boolean marshalAttributes(MarshalRecord marshalRecord,
                                 java.lang.Object object,
                                 CoreAbstractSession session)

Specified by:

marshalAttributes in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

createRecord

public AbstractRecord createRecord(AbstractSession session)

Create a new row/record for the object builder. This allows subclasses to define different record types.

Specified by:

createRecord in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

Overrides:

createRecord in class XMLObjectBuilder

createRecord

public AbstractMarshalRecord createRecord(java.lang.String rootName,
                                          AbstractSession session)

Create a new row/record for the object builder with the given name. This allows subclasses to define different record types.

Overrides:

createRecord in class XMLObjectBuilder

createRecord

public AbstractMarshalRecord createRecord(java.lang.String rootName,
                                          org.w3c.dom.Node parent,
                                          AbstractSession session)

Create a new row/record for the object builder with the given name. This allows subclasses to define different record types.

Overrides:

createRecord in class XMLObjectBuilder

createRecord

public AbstractRecord createRecord(int size,
                                   AbstractSession session)

Create a new row/record for the object builder. This allows subclasses to define different record types.

Overrides:

createRecord in class XMLObjectBuilder

addExtraNamespacesToNamespaceResolver

public java.util.List addExtraNamespacesToNamespaceResolver(Descriptor desc,
                                                            AbstractMarshalRecord marshalRecord,
                                                            CoreAbstractSession session,
                                                            boolean allowOverride,
                                                            boolean ignoreEqualResolvers)

Specified by:

addExtraNamespacesToNamespaceResolver in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

addClassIndicatorFieldToRow

public boolean addClassIndicatorFieldToRow(AbstractMarshalRecord abstractMarshalRecord)

Specified by:

addClassIndicatorFieldToRow in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>

classFromRow

public java.lang.Class classFromRow(UnmarshalRecord unmarshalRecord,
                                    AbstractSession session)

Specified by:

classFromRow in interface ObjectBuilder<AbstractRecord,AbstractSession,ClassDescriptor,XMLMarshaller>