org.datanucleus.store.mapped.mapping
Class CollectionMapping

java.lang.Object
  org.datanucleus.store.mapped.mapping.JavaTypeMapping
      org.datanucleus.store.mapped.mapping.SingleFieldMapping
          org.datanucleus.store.mapped.mapping.AbstractContainerMapping
              org.datanucleus.store.mapped.mapping.CollectionMapping

All Implemented Interfaces:

MappingCallbacks

public class CollectionMapping
extends AbstractContainerMapping
implements MappingCallbacks

Mapping for Collection/Set/List types.

Field Summary

Fields inherited from class org.datanucleus.store.mapped.mapping.JavaTypeMapping

datastoreContainer, datastoreMappings, LOCALISER, mmd, referenceMapping, roleForMember, storeMgr, type

Constructor Summary

CollectionMapping()

Method Summary

java.lang.Class	getJavaType() Accessor for the Java type represented here.
void	insertPostProcessing(StateManager sm) Hook so that we can handle any post-processing on the insert of a particular field.
ScalarExpression	newLiteral(QueryExpression qs, java.lang.Object value) Accessor for a literal representing this type.
ScalarExpression	newScalarExpression(QueryExpression qs, LogicSetExpression te) Accessor for a scalar expression involving this object.
void	postInsert(StateManager sm) Method to be called after the insert of the owner class element.
void	postUpdate(StateManager sm) Method to be called after any update of the owner class element.
void	preDelete(StateManager sm) Method to be called before any delete of the owner class element.

Methods inherited from class org.datanucleus.store.mapped.mapping.AbstractContainerMapping

containerIsStoredInSingleColumn, getDatastoreContainer, getDatastoreMapping, getDatastoreMappings, getJavaTypeForDatastoreMapping, getNumberOfDatastoreMappings, getObject, getSampleValue, hasSimpleDatastoreRepresentation, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, initialize, postFetch, prepareDatastoreMapping, replaceFieldWithWrapper, setObject

Methods inherited from class org.datanucleus.store.mapped.mapping.SingleFieldMapping

equals, getBoolean, getByte, getChar, getDefaultLength, getDouble, getFloat, getInt, getLong, getShort, getString, getValidValues, setBoolean, setByte, setChar, setDouble, setFloat, setInt, setLong, setShort, setString

Methods inherited from class org.datanucleus.store.mapped.mapping.JavaTypeMapping

addDatastoreMapping, failureMessage, getColumnMetaDataForMember, getMemberMetaData, getObject, getReferenceMapping, getRoleForMember, getType, getValueForDatastoreMapping, hashCode, initialize, isNullable, isSerialised, setDatastoreContainer, setDefault, setMemberMetaData, setObject, setReferenceMapping, setRoleForMember

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.datanucleus.store.mapped.mapping.MappingCallbacks

postFetch

Constructor Detail

CollectionMapping

public CollectionMapping()

Method Detail

getJavaType

public java.lang.Class getJavaType()

Accessor for the Java type represented here.

Specified by:

getJavaType in class JavaTypeMapping

Returns:

The java type

insertPostProcessing

public void insertPostProcessing(StateManager sm)

Description copied from interface: MappingCallbacks

Hook so that we can handle any post-processing on the insert of a particular field. For example with Oracle we need to insert "EMPTY_CLOB" and then immediately after do a SELECT of it and update the contents of the CLOB/BLOB.

Specified by:

insertPostProcessing in interface MappingCallbacks

Parameters:

sm - StateManager

postInsert

public void postInsert(StateManager sm)

Method to be called after the insert of the owner class element.

Specified by:

postInsert in interface MappingCallbacks

Parameters:

sm - StateManager of the owner

postUpdate

public void postUpdate(StateManager sm)

Method to be called after any update of the owner class element. This method could be called in two situations

• Update a collection field of an object by replacing the collection with a new collection, so UpdateRequest is called, which calls here
• Persist a new object, and it needed to wait til the element was inserted so goes into dirty state and then flush() triggers UpdateRequest, which comes here

Specified by:

postUpdate in interface MappingCallbacks

Parameters:

sm - StateManager of the owner

preDelete

public void preDelete(StateManager sm)

Method to be called before any delete of the owner class element.

Specified by:

preDelete in interface MappingCallbacks

Parameters:

sm - StateManager of the owner

newLiteral

public ScalarExpression newLiteral(QueryExpression qs,
                                   java.lang.Object value)

Accessor for a literal representing this type.

Overrides:

newLiteral in class JavaTypeMapping

Parameters:

qs - The Query

value - the value of this object in the literal

Returns:

The literal

newScalarExpression

public ScalarExpression newScalarExpression(QueryExpression qs,
                                            LogicSetExpression te)

Accessor for a scalar expression involving this object.

Overrides:

newScalarExpression in class JavaTypeMapping

Parameters:

qs - The Query

te - The table holding this object.

Returns:

The expression