org.datanucleus.store.rdbms.table
Class ArrayTable

java.lang.Object
  org.datanucleus.store.rdbms.table.AbstractTable
      org.datanucleus.store.rdbms.table.TableImpl
          org.datanucleus.store.rdbms.table.JoinTable
              org.datanucleus.store.rdbms.table.ElementContainerTable
                  org.datanucleus.store.rdbms.table.ArrayTable

All Implemented Interfaces:

org.datanucleus.store.mapped.DatastoreContainerObject, org.datanucleus.store.mapped.DatastoreElementContainer, Table

public class ArrayTable
extends ElementContainerTable
implements org.datanucleus.store.mapped.DatastoreElementContainer

Representation of a join table for an array. An array requires ordering of elements so that they can be stored and retrieved in the same order.

JoinTable Mappings

The join table consists of the following mappings :-

• ownerMapping linking back to the owning class with the Collection.
• elementMapping either being an FK link to the element table or being an embedded/serialised element stored wholely in this table.
• orderMapping providing the ordering of the elements.

The primary-key is formed from the ownerMapping and the orderMapping (unless overridden by the user).

Field Summary

Fields inherited from class org.datanucleus.store.rdbms.table.ElementContainerTable

elementMapping, orderMapping, relationDiscriminatorMapping, relationDiscriminatorValue

Fields inherited from class org.datanucleus.store.rdbms.table.JoinTable

mmd, ownerMapping, ownerType

Fields inherited from class org.datanucleus.store.rdbms.table.AbstractTable

columns, columnsByName, dba, existsInDatastore, identifier, LOCALISER, state, storeMgr, TABLE_STATE_INITIALIZED, TABLE_STATE_INITIALIZED_MODIFIED, TABLE_STATE_NEW, TABLE_STATE_PK_INITIALIZED, TABLE_STATE_VALIDATED

Constructor Summary

ArrayTable(org.datanucleus.store.mapped.DatastoreIdentifier tableName, org.datanucleus.metadata.AbstractMemberMetaData mmd, RDBMSStoreManager storeMgr)
Constructor.

Method Summary

String	getElementType() Accessor for the element type stored in this array.
void	initialize(org.datanucleus.ClassLoaderResolver clr) Method to initialise the table definition.
boolean	isEmbeddedElement() Accessor for whether the element is embedded into this table.
boolean	isEmbeddedElementPC() Accessor for whether the element is a PersistenceCapable(embedded)
boolean	isSerialisedElement() Accessor for whether the element is serialised into this table.
boolean	isSerialisedElementPC() Accessor for whether the element is a PersistenceCapable(serialised)

Methods inherited from class org.datanucleus.store.rdbms.table.ElementContainerTable

applyUserPrimaryKeySpecification, getElementMapping, getExpectedCandidateKeys, getExpectedForeignKeys, getExpectedIndices, getForeignKeyToElement, getForeignKeyToOwner, getMemberMapping, getOrderMapping, getRelationDiscriminatorMapping, getRelationDiscriminatorValue

Methods inherited from class org.datanucleus.store.rdbms.table.JoinTable

debugMapping, getIdMapping, getOwnerMapping, getOwnerMemberMetaData, getPrimaryKey, requiresPrimaryKey

Methods inherited from class org.datanucleus.store.rdbms.table.TableImpl

createConstraints, dropConstraints, getSQLAddCandidateKeyStatements, getSQLAddFKStatements, getSQLCreateIndexStatements, getSQLCreateStatements, getSQLDropStatements, initializeColumnInfoForPrimaryKeyColumns, initializeColumnInfoFromDatastore, postInitialize, preInitialize, validate, validateColumns, validateConstraints, validatePrimaryKey

Methods inherited from class org.datanucleus.store.rdbms.table.AbstractTable

addColumnInternal, addDatastoreField, allowDDLOutput, assertIsInitialized, assertIsInitializedModified, assertIsPKInitialized, assertIsPKUninitialized, assertIsUninitialized, assertIsValidated, create, drop, equals, executeDdlStatement, executeDdlStatementList, exists, getCatalogName, getDatastoreField, getDatastoreFields, getDatastoreIdentifierFullyQualified, getDiscriminatorMapping, getDiscriminatorMetaData, getIdentifier, getMultitenancyMapping, getSchemaName, getStoreManager, getVersionMapping, getVersionMetaData, hasColumnName, hasDatastoreField, hashCode, isInitialized, isInitializedModified, isPKInitialized, isValidated, tableExistsInDatastore, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.datanucleus.store.mapped.DatastoreElementContainer

getElementMapping, getOwnerMapping

Methods inherited from interface org.datanucleus.store.mapped.DatastoreContainerObject

addDatastoreField, getDatastoreField, getDatastoreFields, getDiscriminatorMapping, getDiscriminatorMetaData, getIdentifier, getIdMapping, getMemberMapping, getMultitenancyMapping, getStoreManager, getVersionMapping, getVersionMetaData, hasDatastoreField

Constructor Detail

ArrayTable

public ArrayTable(org.datanucleus.store.mapped.DatastoreIdentifier tableName,
                  org.datanucleus.metadata.AbstractMemberMetaData mmd,
                  RDBMSStoreManager storeMgr)

Constructor.

Parameters:

tableName - Identifier name of the table

mmd - MetaData for the field of the owner

storeMgr - The Store Manager managing these tables.

Method Detail

initialize

public void initialize(org.datanucleus.ClassLoaderResolver clr)

Method to initialise the table definition.

Specified by:

initialize in interface Table

Overrides:

initialize in class ElementContainerTable

Parameters:

clr - The ClassLoaderResolver

getElementType

public String getElementType()

Accessor for the element type stored in this array.

Specified by:

getElementType in class ElementContainerTable

Returns:

Name of element type.

isSerialisedElement

public boolean isSerialisedElement()

Accessor for whether the element is serialised into this table. This can be a serialised PersistenceCapable, or a serialised simple type

Returns:

Whether the element is serialised.

isEmbeddedElement

public boolean isEmbeddedElement()

Accessor for whether the element is embedded into this table. This can be an embedded PersistenceCapable, or an embedded simple type

Returns:

Whether the element is embedded.

isSerialisedElementPC

public boolean isSerialisedElementPC()

Accessor for whether the element is a PersistenceCapable(serialised)

Returns:

Whether the element is PC and is serialised

isEmbeddedElementPC

public boolean isEmbeddedElementPC()

Accessor for whether the element is a PersistenceCapable(embedded)

Returns:

Whether the element is PC and is embedded