org.datanucleus.store.mapped.mapping
Class GregorianCalendarMapping

java.lang.Object
  org.datanucleus.store.mapped.mapping.JavaTypeMapping
      org.datanucleus.store.mapped.mapping.SingleFieldMultiMapping
          org.datanucleus.store.mapped.mapping.GregorianCalendarMapping

public class GregorianCalendarMapping
extends SingleFieldMultiMapping

Maps the class fields of a GregorianCalendar to datastore field(s). JPOX traditionally supported this as mapping to 2 datastore fields (timestamp millisecs and timezone). Here we also support it as mapping to a single datastore field (timestamp).

Field Summary

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

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

Constructor Summary

GregorianCalendarMapping()

Method Summary

protected void	addDatastoreFields()
java.lang.Class	getJavaType() Accessor for the java type being mapped.
java.lang.String	getJavaTypeForDatastoreMapping(int index) Accessor for the name of the java-type actually used when mapping the particular datastore field.
java.lang.Object	getObject(ExecutionContext ec, java.lang.Object resultSet, int[] exprIndex) Obtains a value from datastoreResults at position specified by exprIndex.
java.lang.Object	getValueForDatastoreMapping(OMFContext omfCtx, int index, java.lang.Object value) Method to return the value to be stored in the specified datastore index given the overall value for this java type.
void	initialize(AbstractMemberMetaData fmd, DatastoreContainerObject container, ClassLoaderResolver clr) Initialize this JavaTypeMapping for the supplied table and field/property metadata.
void	initialize(MappedStoreManager storeMgr, java.lang.String type) Initialize this JavaTypeMapping with the given StoreManager for the given type.
void	setObject(ExecutionContext ec, java.lang.Object preparedStatement, int[] exprIndex, java.lang.Object value) Sets a value into datastoreStatement at position specified by exprIndex.

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

addDatastoreField, hasSimpleDatastoreRepresentation

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

addDatastoreMapping, equals, failureMessage, getBoolean, getByte, getChar, getColumnMetaDataForMember, getDatastoreContainer, getDatastoreMapping, getDatastoreMappings, getDouble, getFloat, getInt, getLong, getMemberMetaData, getNumberOfDatastoreMappings, getObject, getReferenceMapping, getRoleForMember, getShort, getString, getType, hashCode, includeInFetchStatement, includeInInsertStatement, includeInUpdateStatement, isNullable, isSerialised, setBoolean, setByte, setChar, setDatastoreContainer, setDouble, setFloat, setInt, setLong, setMemberMetaData, setObject, setReferenceMapping, setRoleForMember, setShort, setString

Methods inherited from class java.lang.Object

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

Constructor Detail

GregorianCalendarMapping

public GregorianCalendarMapping()

Method Detail

initialize

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

Description copied from class: JavaTypeMapping

Initialize this JavaTypeMapping for the supplied table and field/property metadata. Subclasses should override this method to perform any datastore initialization operations. Assumes the "roleForMember" is already set

Overrides:

initialize in class JavaTypeMapping

Parameters:

fmd - MetaData for the field/property to be mapped (if any)

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

clr - the ClassLoaderResolver

initialize

public void initialize(MappedStoreManager storeMgr,
                       java.lang.String type)

Description copied from class: JavaTypeMapping

Initialize this JavaTypeMapping with the given StoreManager for the given type. Used when the mapping is for a parameter in a query. This will not set the "mmd" and "datastoreContainer" parameters. If these are required for usage of the mapping then you should call "setFieldInformation(AbstractMemberMetaData, DatastoreContainerObject)" below Subclasses should override this method to perform any datastore initialization operations.

Overrides:

initialize in class JavaTypeMapping

Parameters:

storeMgr - The Datastore Adapter that this Mapping should use.

type - The Class that this mapping maps to the database.

See Also:

MappingFactory.createMapping(Class, MappedStoreManager, String)

addDatastoreFields

protected void addDatastoreFields()

getJavaType

public java.lang.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

getJavaTypeForDatastoreMapping

public java.lang.String getJavaTypeForDatastoreMapping(int index)

Accessor for the name of the java-type actually used when mapping the particular datastore field. This java-type must have an entry in the datastore mappings.

Overrides:

getJavaTypeForDatastoreMapping in class SingleFieldMultiMapping

Parameters:

index - requested datastore field index.

Returns:

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

getValueForDatastoreMapping

public java.lang.Object getValueForDatastoreMapping(OMFContext omfCtx,
                                                    int index,
                                                    java.lang.Object value)

Method to return the value to be stored in the specified datastore index given the overall value for this java type.

Overrides:

getValueForDatastoreMapping in class JavaTypeMapping

Parameters:

index - The datastore index

value - The overall value for this java type

omfCtx - OMF Context

Returns:

The value for this datastore index

setObject

public void setObject(ExecutionContext ec,
                      java.lang.Object preparedStatement,
                      int[] exprIndex,
                      java.lang.Object value)

Description copied from class: JavaTypeMapping

Sets a value into datastoreStatement at position specified by exprIndex.

Overrides:

setObject in class JavaTypeMapping

Parameters:

ec - ExecutionContext

preparedStatement - a datastore object that executes statements in the database

exprIndex - the position of the value in the statement

value - the value

getObject

public java.lang.Object getObject(ExecutionContext ec,
                                  java.lang.Object resultSet,
                                  int[] exprIndex)

Description copied from class: JavaTypeMapping

Obtains a value from datastoreResults at position specified by exprIndex.

Overrides:

getObject in class JavaTypeMapping

Parameters:

ec - ExecutionContext

resultSet - an object returned from the datastore with values

exprIndex - the position of the value in the result

Returns:

the value