org.datanucleus.store.rdbms.mapping.java

Class EmbeddedMapping

java.lang.Object

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

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

org.datanucleus.store.rdbms.mapping.java.EmbeddedMapping

Direct Known Subclasses:

EmbeddedElementPCMapping, EmbeddedKeyPCMapping, EmbeddedPCMapping, EmbeddedValuePCMapping

public abstract class EmbeddedMapping
extends SingleFieldMapping

Mapping for an embedded PC object. The PC object can be embedded directly (1-1 relation) or be the element of a collection, or be the key or value of a map.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.datanucleus.ClassLoaderResolver	clr ClassLoader resolver
protected DiscriminatorMapping	discrimMapping Mapping for a discriminator (when supporting inherited embedded objects.
protected org.datanucleus.metadata.DiscriminatorMetaData	discrimMetaData
protected org.datanucleus.metadata.AbstractClassMetaData	embCmd MetaData for the embedded class.
protected org.datanucleus.metadata.EmbeddedMetaData	emd EmbeddedMetaData for the object being embedded.
protected List<JavaTypeMapping>	javaTypeMappings Mappings of the fields of the embedded PC.
protected short	objectType Type of PC object.
protected String	typeName Type name for the object being embedded.

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
EmbeddedMapping()

Method Summary

Modifier and Type	Method and Description
void	addJavaTypeMapping(JavaTypeMapping mapping) Add a new JavaTypeMapping to manage.
JavaTypeMapping	getDiscriminatorMapping()
Class	getJavaType() Accessor for the Java type being represented here.
JavaTypeMapping	getJavaTypeMapping(int i) Accessor for the java type mappings
JavaTypeMapping	getJavaTypeMapping(String fieldName) Accessor for the sub type mapping for a particular field name
int	getNumberOfJavaTypeMappings() Accessor for the number of java type mappings
Object	getObject(org.datanucleus.ExecutionContext ec, ResultSet rs, int[] param) Accessor for the embedded object from the result set
Object	getObject(org.datanucleus.ExecutionContext ec, ResultSet rs, int[] param, org.datanucleus.state.ObjectProvider ownerOP, int ownerFieldNumber) Accessor for the embedded object from the result set
void	initialize(org.datanucleus.metadata.AbstractMemberMetaData fmd, Table table, org.datanucleus.ClassLoaderResolver clr) Initialize this JavaTypeMapping with the given DatastoreAdapter for the given FieldMetaData.
void	initialize(org.datanucleus.metadata.AbstractMemberMetaData mmd, Table table, org.datanucleus.ClassLoaderResolver clr, org.datanucleus.metadata.EmbeddedMetaData emd, String typeName, int objectType) Initialize for the specified member.
protected void	prepareDatastoreMapping() Method to prepare a field mapping for use in the datastore.
void	setObject(org.datanucleus.ExecutionContext ec, PreparedStatement ps, int[] param, Object value) Mutator for the embedded object in the datastore.
void	setObject(org.datanucleus.ExecutionContext ec, PreparedStatement ps, int[] param, Object value, org.datanucleus.state.ObjectProvider ownerOP, int ownerFieldNumber) Mutator for the embedded object in the datastore.

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

getBoolean, getByte, getChar, getDefaultLength, getDouble, getFloat, getInt, getJavaTypeForDatastoreMapping, 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, getDatastoreMapping, getDatastoreMappings, getMemberMetaData, getNumberOfDatastoreMappings, getReferenceMapping, getRoleForMember, getStoreManager, getTable, getType, getValueForDatastoreMapping, hashCode, hasSimpleDatastoreRepresentation, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, initialize, isNullable, isSerialised, representableAsStringLiteralInStatement, setAbsFieldNumber, setMemberMetaData, setReferenceMapping, setRoleForMember, setTable

Methods inherited from class java.lang.Object

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

Field Detail

discrimMetaData

protected org.datanucleus.metadata.DiscriminatorMetaData discrimMetaData

discrimMapping

protected DiscriminatorMapping discrimMapping

Mapping for a discriminator (when supporting inherited embedded objects.

javaTypeMappings

protected List<JavaTypeMapping> javaTypeMappings

Mappings of the fields of the embedded PC.

clr

protected org.datanucleus.ClassLoaderResolver clr

ClassLoader resolver

emd

protected org.datanucleus.metadata.EmbeddedMetaData emd

EmbeddedMetaData for the object being embedded.

typeName

protected String typeName

Type name for the object being embedded.

objectType

protected short objectType

Type of PC object. Corresponds to the values in StateManagerImpl.

embCmd

protected org.datanucleus.metadata.AbstractClassMetaData embCmd

MetaData for the embedded class.

Constructor Detail

EmbeddedMapping

public EmbeddedMapping()

Method Detail

initialize

public void initialize(org.datanucleus.metadata.AbstractMemberMetaData fmd,
                       Table table,
                       org.datanucleus.ClassLoaderResolver clr)

Initialize this JavaTypeMapping with the given DatastoreAdapter for the given FieldMetaData.

Overrides:

initialize in class SingleFieldMapping

Parameters:

table - The datastore container storing this mapping (if any)

clr - the ClassLoaderResolver

fmd - FieldMetaData for the field to be mapped (if any)

Throws:

org.datanucleus.exceptions.NucleusException - if an error occurs

initialize

public void initialize(org.datanucleus.metadata.AbstractMemberMetaData mmd,
                       Table table,
                       org.datanucleus.ClassLoaderResolver clr,
                       org.datanucleus.metadata.EmbeddedMetaData emd,
                       String typeName,
                       int objectType)

Initialize for the specified member.

Parameters:

mmd - metadata for the embedded member

table - Table for persisting this field

clr - The ClassLoaderResolver

emd - Embedded MetaData for the object being embedded

typeName - type of the embedded PC object being stored

objectType - Object type of the PC object being embedded (see StateManagerImpl object types)

prepareDatastoreMapping

protected void prepareDatastoreMapping()

Method to prepare a field mapping for use in the datastore. Overridden so it does nothing

Overrides:

prepareDatastoreMapping in class SingleFieldMapping

addJavaTypeMapping

public void addJavaTypeMapping(JavaTypeMapping mapping)

Add a new JavaTypeMapping to manage.

Parameters:

mapping - the JavaTypeMapping

getNumberOfJavaTypeMappings

public int getNumberOfJavaTypeMappings()

Accessor for the number of java type mappings

Returns:

Number of java type mappings of the fields of the embedded PC element

getJavaTypeMapping

public JavaTypeMapping getJavaTypeMapping(int i)

Accessor for the java type mappings

Parameters:

i - the index position of the java type mapping

Returns:

the java type mapping

getJavaTypeMapping

public JavaTypeMapping getJavaTypeMapping(String fieldName)

Accessor for the sub type mapping for a particular field name

Parameters:

fieldName - The field name

Returns:

The type mapping for that field in the embedded object

getDiscriminatorMapping

public JavaTypeMapping getDiscriminatorMapping()

setObject

public void setObject(org.datanucleus.ExecutionContext ec,
                      PreparedStatement ps,
                      int[] param,
                      Object value)

Mutator for the embedded object in the datastore.

Overrides:

setObject in class SingleFieldMapping

Parameters:

ec - execution context

ps - The Prepared Statement

param - Param numbers in the PreparedStatement for the fields of this object

value - The embedded object to use

setObject

public void setObject(org.datanucleus.ExecutionContext ec,
                      PreparedStatement ps,
                      int[] param,
                      Object value,
                      org.datanucleus.state.ObjectProvider ownerOP,
                      int ownerFieldNumber)

Mutator for the embedded object in the datastore.

Overrides:

setObject in class JavaTypeMapping

Parameters:

ec - ExecutionContext

ps - The Prepared Statement

param - Param numbers in the PreparedStatement for the fields of this object

value - The embedded object to use

ownerOP - ObjectProvider of the owning object containing this embedded object

ownerFieldNumber - Field number in the owning object where this is stored

getObject

public Object getObject(org.datanucleus.ExecutionContext ec,
                        ResultSet rs,
                        int[] param)

Accessor for the embedded object from the result set

Overrides:

getObject in class SingleFieldMapping

Parameters:

ec - ExecutionContext

rs - The ResultSet

param - Array of param numbers in the ResultSet for the fields of this object

Returns:

The embedded object

getObject

public Object getObject(org.datanucleus.ExecutionContext ec,
                        ResultSet rs,
                        int[] param,
                        org.datanucleus.state.ObjectProvider ownerOP,
                        int ownerFieldNumber)

Accessor for the embedded object from the result set

Overrides:

getObject in class JavaTypeMapping

Parameters:

ec - ExecutionContext

rs - The ResultSet

param - Array of param numbers in the ResultSet for the fields of this object

ownerOP - ObjectProvider of the owning object containing this embedded object

ownerFieldNumber - Field number in the owning object where this is stored

Returns:

The embedded object

getJavaType

public Class getJavaType()

Accessor for the Java type being represented here.

Specified by:

getJavaType in class JavaTypeMapping

Returns:

The Java type