org.datanucleus.store.rdbms.scostore

Class FKArrayStore

java.lang.Object

org.datanucleus.store.rdbms.scostore.BaseContainerStore

org.datanucleus.store.rdbms.scostore.ElementContainerStore

org.datanucleus.store.rdbms.scostore.AbstractArrayStore

org.datanucleus.store.rdbms.scostore.FKArrayStore

All Implemented Interfaces:

org.datanucleus.store.scostore.ArrayStore, org.datanucleus.store.scostore.Store

public class FKArrayStore
extends AbstractArrayStore

RDBMS-specific implementation of an FK ArrayStore.

Nested Class Summary

Nested classes/interfaces inherited from class org.datanucleus.store.rdbms.scostore.ElementContainerStore

ElementContainerStore.ElementInfo

Field Summary

Fields inherited from class org.datanucleus.store.rdbms.scostore.ElementContainerStore

addStmt, clearStmt, containerTable, elementInfo, elementIsPersistentInterface, elementMapping, elementsAreEmbedded, elementsAreSerialised, elementType, emd, iterateUsingDiscriminator, orderMapping, relationDiscriminatorMapping, relationDiscriminatorValue, removeStmt, sizeStmt, usingDiscriminatorInSizeStmt

Fields inherited from class org.datanucleus.store.rdbms.scostore.BaseContainerStore

allowNulls, clr, dba, ownerMapping, ownerMemberMetaData, relationType, storeMgr

Constructor Summary

Constructors

Constructor and Description
FKArrayStore(org.datanucleus.metadata.AbstractMemberMetaData mmd, RDBMSStoreManager storeMgr, org.datanucleus.ClassLoaderResolver clr)

Method Summary

Modifier and Type	Method and Description
void	clear(org.datanucleus.state.ObjectProvider ownerOP) Method to clear the Array.
protected String	getClearNullifyStmt() Generates the statement for clearing items by nulling the owner link out.
IteratorStatement	getIteratorStatement(org.datanucleus.ClassLoaderResolver clr, org.datanucleus.FetchPlan fp, boolean addRestrictionOnOwner) Method to return the SQLStatement and mapping for an iterator for this backing store.
Iterator	iterator(org.datanucleus.state.ObjectProvider ownerOP) Accessor for an iterator for the set.
boolean	set(org.datanucleus.state.ObjectProvider ownerOP, Object array) Method to set the array for the specified owner to the passed value.

Methods inherited from class org.datanucleus.store.rdbms.scostore.AbstractArrayStore

add, clearInternal, getArray, internalAdd, processBatchedWrites

Methods inherited from class org.datanucleus.store.rdbms.scostore.ElementContainerStore

executeClear, getAddStmtForJoinTable, getClearStmt, getContainerTable, getElementInfo, getElementInformationForClass, getElementMapping, getEmd, getOrderMapping, getRelationDiscriminatorMapping, getRelationDiscriminatorValue, getSize, getSizeStmt, hasOrderMapping, invalidateAddStmt, isElementsAreEmbedded, isElementsAreSerialised, size, validateElementForReading, validateElementForWriting, validateElementType

Methods inherited from class org.datanucleus.store.rdbms.scostore.BaseContainerStore

allowsBatching, getDatastoreAdapter, getObjectProviderForEmbeddedPCObject, getOwnerMapping, getOwnerMemberMetaData, getRelationType, getStoreManager, isEmbeddedMapping, setOwner

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.datanucleus.store.scostore.ArrayStore

size

Methods inherited from interface org.datanucleus.store.scostore.Store

getOwnerMemberMetaData, getStoreManager

Constructor Detail

FKArrayStore

public FKArrayStore(org.datanucleus.metadata.AbstractMemberMetaData mmd,
                    RDBMSStoreManager storeMgr,
                    org.datanucleus.ClassLoaderResolver clr)

Parameters:

mmd - Metadata for the owning field/property

storeMgr - Manager for the datastore

clr - ClassLoader resolver

Method Detail

clear

public void clear(org.datanucleus.state.ObjectProvider ownerOP)

Method to clear the Array. This is called when the container object is being deleted and the elements are to be removed (maybe for dependent field).

Specified by:

clear in interface org.datanucleus.store.scostore.ArrayStore

Overrides:

clear in class AbstractArrayStore

Parameters:

ownerOP - The ObjectProvider

getClearNullifyStmt

protected String getClearNullifyStmt()

Generates the statement for clearing items by nulling the owner link out. The statement will be

 UPDATE ARRAYTABLE SET OWNERCOL=NULL, INDEXCOL=NULL [,DISTINGUISHER=NULL]
 WHERE OWNERCOL=? [AND DISTINGUISHER=?]
 

when there is only one element table, and will be

 UPDATE ? SET OWNERCOL=NULL, INDEXCOL=NULL [,DISTINGUISHER=NULL]
 WHERE OWNERCOL=? [AND DISTINGUISHER=?]
 

when there is more than 1 element table.

Returns:

The Statement for clearing items for the owner.

set

public boolean set(org.datanucleus.state.ObjectProvider ownerOP,
                   Object array)

Method to set the array for the specified owner to the passed value.

Specified by:

set in interface org.datanucleus.store.scostore.ArrayStore

Overrides:

set in class AbstractArrayStore

Parameters:

ownerOP - ObjectProvider for the owner

array - the array

Returns:

Whether the array was updated successfully

iterator

public Iterator iterator(org.datanucleus.state.ObjectProvider ownerOP)

Accessor for an iterator for the set.

Specified by:

iterator in interface org.datanucleus.store.scostore.ArrayStore

Specified by:

iterator in class AbstractArrayStore

Parameters:

ownerOP - ObjectProvider for the set.

Returns:

Iterator for the set.

getIteratorStatement

public IteratorStatement getIteratorStatement(org.datanucleus.ClassLoaderResolver clr,
                                              org.datanucleus.FetchPlan fp,
                                              boolean addRestrictionOnOwner)

Method to return the SQLStatement and mapping for an iterator for this backing store.

Parameters:

clr - ClassLoader resolver

fp - FetchPlan to use in determing which fields of element to select

addRestrictionOnOwner - Whether to restrict to a particular owner (otherwise functions as bulk fetch for many owners).

Returns:

The SQLStatement and its associated StatementClassMapping