org.datanucleus.store.mapped.mapping
Class ReferenceMapping

java.lang.Object
  org.datanucleus.store.mapped.mapping.JavaTypeMapping
      org.datanucleus.store.mapped.mapping.MultiMapping
          org.datanucleus.store.mapped.mapping.MultiPersistableMapping
              org.datanucleus.store.mapped.mapping.ReferenceMapping

All Implemented Interfaces:

MappingCallbacks

Direct Known Subclasses:

InterfaceMapping, ObjectMapping, ReferenceIdMapping

public abstract class ReferenceMapping
extends MultiPersistableMapping
implements MappingCallbacks

Mapping for a "reference" type. This can be used for things like interfaces, or Object which are simply a reference to some specific (PersistenceCapable) class. This can be persisted in several ways (see "mappingStrategy") :-

• List of possible "implementations" of the reference type where column(s) are created for each possible implementation of the reference as a FK to the implementation table. This has the advantage that it retains referential integrity since direct FKs are used.
• What Kodo/Xcalia used was a single column storing the identity toString() form.

Field Summary

static int	ID_MAPPING Single column containing the "identity" of an object.
protected static Localiser	LOCALISER_MAPPED Localiser for messages
protected int	mappingStrategy Strategy for how the reference(s) are mapped.
static int	PER_IMPLEMENTATION_MAPPING Each implementation has its own column(s) as a FK to the related table.
static int	XCALIA_MAPPING Single column containing the Xcalia form of the "identity" of an object.

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

javaTypeMappings, numberOfDatastoreMappings

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

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

Constructor Summary

ReferenceMapping()

Method Summary

Class	getJavaType() Accessor for the java type being mapped.
String	getJavaTypeForDatastoreMapping(int index) Accessor for the java type represented by a particular datastore mapping.
int	getMappingNumberForValue(ExecutionContext ec, Object value) Convenience accessor for the number of the java type mapping where the passed value would be stored.
int	getMappingStrategy() Accessor for the mapping strategy.
Object	getObject(ExecutionContext ec, Object rs, int[] pos) Method to retrieve an object of this type from the ResultSet.
protected Object	getObjectForReferenceString(ExecutionContext ec, String refString) Method to convert a "reference string" into the associated object.
protected String	getReferenceStringForObject(ExecutionContext ec, Object value) Method to convert an object to be stored into a "reference string" to store.
void	initialize(AbstractMemberMetaData mmd, DatastoreContainerObject container, ClassLoaderResolver clr) Initialize this JavaTypeMapping for the specified field/property.
void	insertPostProcessing(ObjectProvider sm) Method executed just after the insert of the owning object, allowing any necessary action to this field and the object stored in it.
void	postFetch(ObjectProvider sm) Method executed just after a fetch of the owning object, allowing any necessary action to this field and the object stored in it.
void	postInsert(ObjectProvider sm) Method executed just after the insert of the owning object, allowing any necessary action to this field and the object stored in it.
void	postUpdate(ObjectProvider sm) Method executed just afer any update of the owning object, allowing any necessary action to this field and the object stored in it.
void	preDelete(ObjectProvider sm) Method executed just before the owning object is deleted, allowing tidying up of any relation information.
protected void	prepareDatastoreMapping(ClassLoaderResolver clr) Convenience method to create the necessary columns to represent this reference in the datastore.
void	setObject(ExecutionContext ec, Object ps, int[] pos, Object value, ObjectProvider ownerSM, int ownerFieldNumber) Sets the specified positions in the PreparedStatement associated with this field, and value.

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

setObject

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

addJavaTypeMapping, getDatastoreMapping, getDatastoreMappings, getJavaTypeMapping, getNumberOfDatastoreMappings

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

addDatastoreMapping, equals, failureMessage, getAbsoluteFieldNumber, getBoolean, getByte, getChar, getColumnMetaDataForMember, getDatastoreContainer, getDouble, getFloat, getInt, getLong, getMemberMetaData, getObject, getReferenceMapping, getRoleForMember, getShort, getStoreManager, getString, getType, getValueForDatastoreMapping, hashCode, hasSimpleDatastoreRepresentation, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, initialize, isNullable, isSerialised, representableAsStringLiteralInStatement, setAbsFieldNumber, setBoolean, setByte, setChar, setDatastoreContainer, setDouble, setFloat, setInt, setLong, setMemberMetaData, setReferenceMapping, setRoleForMember, setShort, setString

Methods inherited from class java.lang.Object

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

Field Detail

LOCALISER_MAPPED

protected static final Localiser LOCALISER_MAPPED

Localiser for messages

PER_IMPLEMENTATION_MAPPING

public static final int PER_IMPLEMENTATION_MAPPING

Each implementation has its own column(s) as a FK to the related table.

See Also:

Constant Field Values

ID_MAPPING

public static final int ID_MAPPING

Single column containing the "identity" of an object.

See Also:

Constant Field Values

XCALIA_MAPPING

public static final int XCALIA_MAPPING

Single column containing the Xcalia form of the "identity" of an object.

See Also:

Constant Field Values

mappingStrategy

protected int mappingStrategy

Strategy for how the reference(s) are mapped.

Constructor Detail

ReferenceMapping

public ReferenceMapping()

Method Detail

initialize

public void initialize(AbstractMemberMetaData mmd,
                       DatastoreContainerObject container,
                       ClassLoaderResolver clr)

Initialize this JavaTypeMapping for the specified field/property.

Overrides:

initialize in class JavaTypeMapping

Parameters:

mmd - AbstractMemberMetaData for the field to be mapped (if any)

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

clr - the ClassLoaderResolver

getMappingStrategy

public int getMappingStrategy()

Accessor for the mapping strategy. There are various supported strategies for reference fields with the default being one mapping per implementation, but also allowing a single (String) mapping for all implementations.

Returns:

The mapping strategy

prepareDatastoreMapping

protected void prepareDatastoreMapping(ClassLoaderResolver clr)

Convenience method to create the necessary columns to represent this reference in the datastore. With "per-implementation" mapping strategy will create columns for each of the possible implementations. With "identity"/"xcalia" will create a single column to store a reference to the implementation value.

Parameters:

clr - The ClassLoaderResolver

getJavaTypeForDatastoreMapping

public String getJavaTypeForDatastoreMapping(int index)

Accessor for the java type represented by a particular datastore mapping. This implementation relays to the superclass implementation except in the case of "identity" mapping strategy, in which case it returns "java.lang.String".

Overrides:

getJavaTypeForDatastoreMapping in class JavaTypeMapping

Parameters:

index - requested datastore field index.

Returns:

the name of java-type for the requested datastore field.

getMappingNumberForValue

public int getMappingNumberForValue(ExecutionContext ec,
                                    Object value)

Convenience accessor for the number of the java type mapping where the passed value would be stored. If no suitable mapping is found will return -1. If is a persistent interface then will return -2 meaning persist against *any* mapping

Overrides:

getMappingNumberForValue in class MultiPersistableMapping

Parameters:

ec - ExecutionContext

value - The value

Returns:

The index of javaTypeMappings to use (if any), or -1 (none), or -2 (any)

setObject

public void setObject(ExecutionContext ec,
                      Object ps,
                      int[] pos,
                      Object value,
                      ObjectProvider ownerSM,
                      int ownerFieldNumber)

Sets the specified positions in the PreparedStatement associated with this field, and value.

Overrides:

setObject in class MultiPersistableMapping

Parameters:

ec - the ExecutionContext

ps - a datastore object that executes statements in the database

pos - The position(s) of the PreparedStatement to populate

value - the value stored in this field

ownerSM - the owner StateManager

ownerFieldNumber - the owner absolute field number

getObject

public Object getObject(ExecutionContext ec,
                        Object rs,
                        int[] pos)

Method to retrieve an object of this type from the ResultSet.

Overrides:

getObject in class MultiPersistableMapping

Parameters:

ec - ExecutionContext

rs - The ResultSet

pos - The parameter positions

Returns:

The object

getJavaType

public Class getJavaType()

Description copied from class: JavaTypeMapping

Accessor for the java type being mapped. This is the java type that the mapping represents. Some examples :

• if the field is of type "MyClass" then the mapping will be OIDMapping (or subclass) the javaType will be OID, and the type will be MyClass.
• if the field is of type "int" then the mapping will be IntegerMapping, the javaType will be Integer, and the type will be int.

The "java type" is the java-type name used in the plugin.xml mapping file

Specified by:

getJavaType in class JavaTypeMapping

Returns:

The java type

getReferenceStringForObject

protected String getReferenceStringForObject(ExecutionContext ec,
                                             Object value)

Method to convert an object to be stored into a "reference string" to store. Reference string is of the form :

• ID_MAPPING : "{classname}:{id}"
• XCALIA_MAPPING (datastore-id) : "{definer}:{id-key}" where definer is discriminator/classname
• XCALIA_MAPPING (app-id) : "{definer}:{id}" where definer is discriminator/classname

Parameters:

ec - ExecutionContext

value - The object

Returns:

The reference string

getObjectForReferenceString

protected Object getObjectForReferenceString(ExecutionContext ec,
                                             String refString)

Method to convert a "reference string" into the associated object. Reference string is of the form :

• ID_MAPPING : "{classname}:{id}"
• XCALIA_MAPPING (datastore-id) : "{definer}:{id-key}" where definer is discriminator/classname
• XCALIA_MAPPING (app-id) : "{definer}:{id}" where definer is discriminator/classname

Parameters:

ec - execution context

refString - The reference string

Returns:

The referenced object

postFetch

public void postFetch(ObjectProvider sm)

Method executed just after a fetch of the owning object, allowing any necessary action to this field and the object stored in it.

Specified by:

postFetch in interface MappingCallbacks

Parameters:

sm - StateManager for the owner.

insertPostProcessing

public void insertPostProcessing(ObjectProvider sm)

Method executed just after the insert of the owning object, allowing any necessary action to this field and the object stored in it.

Specified by:

insertPostProcessing in interface MappingCallbacks

Parameters:

sm - StateManager for the owner

postInsert

public void postInsert(ObjectProvider sm)

Method executed just after the insert of the owning object, allowing any necessary action to this field and the object stored in it.

Specified by:

postInsert in interface MappingCallbacks

Parameters:

sm - StateManager for the owner

postUpdate

public void postUpdate(ObjectProvider sm)

Method executed just afer any update of the owning object, allowing any necessary action to this field and the object stored in it.

Specified by:

postUpdate in interface MappingCallbacks

Parameters:

sm - StateManager for the owner

preDelete

public void preDelete(ObjectProvider sm)

Method executed just before the owning object is deleted, allowing tidying up of any relation information.

Specified by:

preDelete in interface MappingCallbacks

Parameters:

sm - StateManager for the owner