org.datanucleus.store.rdbms.mapping.java

Class ArrayMapping

java.lang.Object

org.datanucleus.store.rdbms.mapping.java.JavaTypeMapping

org.datanucleus.store.rdbms.mapping.java.SingleFieldMapping

org.datanucleus.store.rdbms.mapping.java.AbstractContainerMapping

org.datanucleus.store.rdbms.mapping.java.ArrayMapping

All Implemented Interfaces:

MappingCallbacks

Direct Known Subclasses:

OracleArrayMapping

public class ArrayMapping
extends AbstractContainerMapping
implements MappingCallbacks

Mapping for an array.

Field Summary

Fields inherited from class org.datanucleus.store.rdbms.mapping.java.JavaTypeMapping

absFieldNumber, datastoreMappings, mmd, referenceMapping, roleForMember, storeMgr, table, type

Constructor Summary

Constructors

Constructor and Description
ArrayMapping()

Method Summary

Modifier and Type	Method and Description
protected boolean	containerIsStoredInSingleColumn() Convenience method to return if the array is stored in the owning table as a column.
Class	getJavaType() Accessor for the Java type represented here.
void	insertPostProcessing(org.datanucleus.state.ObjectProvider op) Hook so that we can handle any post-processing on the insert of a particular field.
void	postFetch(org.datanucleus.state.ObjectProvider op) Method to be called after any fetch of the owner class element.
void	postInsert(org.datanucleus.state.ObjectProvider ownerOP) Method to be called after the insert of the owner class element.
void	postUpdate(org.datanucleus.state.ObjectProvider ownerOP) Method to be called after any update of the owner class element.
void	preDelete(org.datanucleus.state.ObjectProvider op) 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.rdbms.mapping.java.AbstractContainerMapping

getDatastoreMapping, getDatastoreMappings, getJavaTypeForDatastoreMapping, getNumberOfDatastoreMappings, getObject, getTable, hasSimpleDatastoreRepresentation, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, initialize, prepareDatastoreMapping, replaceFieldWithWrapper, setObject

Methods inherited from class org.datanucleus.store.rdbms.mapping.java.SingleFieldMapping

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.rdbms.mapping.java.JavaTypeMapping

addDatastoreMapping, equals, failureMessage, getAbsoluteFieldNumber, getColumnMetaDataForMember, getMemberMetaData, getObject, getReferenceMapping, getRoleForMember, getStoreManager, getType, getValueForDatastoreMapping, hashCode, initialize, isNullable, isSerialised, representableAsStringLiteralInStatement, setAbsFieldNumber, setMemberMetaData, setObject, setReferenceMapping, setRoleForMember, setTable

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 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(org.datanucleus.state.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(org.datanucleus.state.ObjectProvider ownerOP)

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

Specified by:

postInsert in interface MappingCallbacks

Parameters:

ownerOP - ObjectProvider of the owner

postFetch

public void postFetch(org.datanucleus.state.ObjectProvider op)

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

Specified by:

postFetch in interface MappingCallbacks

Overrides:

postFetch in class AbstractContainerMapping

Parameters:

op - ObjectProvider of the owner

postUpdate

public void postUpdate(org.datanucleus.state.ObjectProvider ownerOP)

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:

ownerOP - ObjectProvider of the owner

preDelete

public void preDelete(org.datanucleus.state.ObjectProvider op)

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:

op - ObjectProvider of the owner