org.datanucleus.store.mapped.mapping
Class ArrayMapping

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.ArrayMapping

All Implemented Interfaces:

MappingCallbacks

public class ArrayMapping
extends AbstractContainerMapping
implements MappingCallbacks

Mapping for an array.

Field Summary

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

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

Constructor Summary

ArrayMapping()

Method Summary

protected boolean	containerIsStoredInSingleColumn() Convenience method to return if the array is stored in the owning table as a column.
java.lang.Class	getJavaType() Accessor for the Java type represented here.
void	insertPostProcessing(ObjectProvider op) Hook so that we can handle any post-processing on the insert of a particular field.
void	postFetch(ObjectProvider sm) Method to be called after any fetch of the owner class element.
void	postInsert(ObjectProvider sm) Method to be called after the insert of the owner class element.
void	postUpdate(ObjectProvider sm) Method to be called after any update of the owner class element.
void	preDelete(ObjectProvider sm) Method to be called before any delete of the owner class element, if the field in the owner is dependent

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

getDatastoreContainer, getDatastoreMapping, getDatastoreMappings, getJavaTypeForDatastoreMapping, getNumberOfDatastoreMappings, getObject, hasSimpleDatastoreRepresentation, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, initialize, 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, setMemberMetaData, setObject, setReferenceMapping, setRoleForMember

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayMapping

public ArrayMapping()

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

containerIsStoredInSingleColumn

protected boolean containerIsStoredInSingleColumn()

Convenience method to return if the array is stored in the owning table as a column. Overrides the superclass since arrays can be stored in a single column also when the no join is specified and the array is of a primitive/wrapper type.

Overrides:

containerIsStoredInSingleColumn in class AbstractContainerMapping

Returns:

Whether it is stored in a single column in the main table.

insertPostProcessing

public void insertPostProcessing(ObjectProvider op)

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:

op - ObjectProvider

postInsert

public void postInsert(ObjectProvider 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

postFetch

public void postFetch(ObjectProvider sm)

Method to be called after any fetch of the owner class element.

Specified by:

postFetch in interface MappingCallbacks

Overrides:

postFetch in class AbstractContainerMapping

Parameters:

sm - StateManager of the owner

postUpdate

public void postUpdate(ObjectProvider sm)

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

• Update an array field of an object by replacing the array with a new array, 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(ObjectProvider sm)

Method to be called before any delete of the owner class element, if the field in the owner is dependent

Specified by:

preDelete in interface MappingCallbacks

Parameters:

sm - StateManager of the owner