org.datanucleus.metadata

Class VersionMetaData

java.lang.Object

org.datanucleus.metadata.MetaData

org.datanucleus.metadata.VersionMetaData

All Implemented Interfaces:

Serializable

public class VersionMetaData
extends MetaData

Three common strategies for versioning instances are supported by standard metadata. These include state-comparison, timestamp, and version-number.

• State-comparison involves comparing the values in specific columns to determine if the database row was changed.
• Timestamp involves comparing the value in a date-time column in the table. The first time in a transaction the row is updated, the timestamp value is updated to the current time.
• Version-number involves comparing the value in a numeric column in the table. The first time in a transaction the row is updated, the version-number column value is incremented.

There are two forms of version storage.

• The JDO method of adding a surrogate column, using the column/columns/index info in this class
• The JPA method of using an existing field/method. This uses the "fieldName" info only

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected ColumnMetaData	columnMetaData Contains the metadata for column.
protected String	fieldName Name of the field that contains the version (if not generating a surrogate column).
protected IndexedValue	indexed Indexed value.
protected IndexMetaData	indexMetaData IndexMetaData for the version column.

Fields inherited from class org.datanucleus.metadata.MetaData

extensions, LOCALISER, METADATA_CREATED_STATE, METADATA_INITIALISED_STATE, METADATA_POPULATED_STATE, METADATA_USED_STATE, metaDataState, parent, VENDOR_NAME, VENDOR_NAME_OLD

Constructor Summary

Constructors

Constructor and Description
VersionMetaData() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
ColumnMetaData	getColumnMetaData()
String	getColumnName()
String	getFieldName()
IndexedValue	getIndexed()
IndexMetaData	getIndexMetaData()
VersionStrategy	getVersionStrategy()
void	initialise(ClassLoaderResolver clr, MetaDataManager mmgr) Initialisation method.
ColumnMetaData	newColumnMetaData() Method to create a new ColumnMetaData, add it, and return it.
IndexMetaData	newIndexMetaData() Method to create a new Index metadata, add it, and return it.
void	setColumnMetaData(ColumnMetaData columnMetaData) Mutator for column MetaData.
VersionMetaData	setColumnName(String columnName)
VersionMetaData	setFieldName(String fieldName)
VersionMetaData	setIndexed(IndexedValue indexed)
void	setIndexMetaData(IndexMetaData indexMetaData)
VersionMetaData	setStrategy(String strategy)
VersionMetaData	setStrategy(VersionStrategy strategy)
String	toString(String prefix, String indent) Returns a string representation of the object using a prefix This can be used as part of a facility to output a MetaData file.

Methods inherited from class org.datanucleus.metadata.MetaData

addExtension, addExtension, assertIfInitialised, getExtensions, getNoOfExtensions, getParent, getValueForExtension, getValuesForExtension, hasExtension, isInitialised, isPopulated, isUsed, newExtensionMetaData, removeExtension, setParent, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

columnMetaData

protected ColumnMetaData columnMetaData

Contains the metadata for column.

indexMetaData

protected IndexMetaData indexMetaData

IndexMetaData for the version column.

indexed

protected IndexedValue indexed

Indexed value.

fieldName

protected String fieldName

Name of the field that contains the version (if not generating a surrogate column).

Constructor Detail

VersionMetaData

public VersionMetaData()

Default constructor. Set the fields using setters, before populate().

Method Detail

initialise

public void initialise(ClassLoaderResolver clr,
              MetaDataManager mmgr)

Initialisation method. This should be called AFTER using the populate method if you are going to use populate. It creates the internal convenience arrays etc needed for normal operation.

Overrides:

initialise in class MetaData

getColumnMetaData

public final ColumnMetaData getColumnMetaData()

setColumnMetaData

public void setColumnMetaData(ColumnMetaData columnMetaData)

Mutator for column MetaData.

Parameters:

columnMetaData - The column MetaData to set.

newColumnMetaData

public ColumnMetaData newColumnMetaData()

Method to create a new ColumnMetaData, add it, and return it.

Returns:

The Column metadata

getVersionStrategy

public final VersionStrategy getVersionStrategy()

setStrategy

public VersionMetaData setStrategy(VersionStrategy strategy)

setStrategy

public VersionMetaData setStrategy(String strategy)

getIndexMetaData

public final IndexMetaData getIndexMetaData()

setIndexMetaData

public final void setIndexMetaData(IndexMetaData indexMetaData)

newIndexMetaData

public IndexMetaData newIndexMetaData()

Method to create a new Index metadata, add it, and return it.

Returns:

The Index metadata

getColumnName

public String getColumnName()

setColumnName

public VersionMetaData setColumnName(String columnName)

getIndexed

public IndexedValue getIndexed()

setIndexed

public VersionMetaData setIndexed(IndexedValue indexed)

getFieldName

public final String getFieldName()

setFieldName

public VersionMetaData setFieldName(String fieldName)

toString

public String toString(String prefix,
              String indent)

Returns a string representation of the object using a prefix This can be used as part of a facility to output a MetaData file.

Overrides:

toString in class MetaData

Parameters:

prefix - prefix string

indent - indent string

Returns:

a string representation of the object.