org.apache.openjpa.jdbc.meta.strats
Class RelationToManyInverseKeyFieldStrategy

java.lang.Object
  org.apache.openjpa.jdbc.meta.strats.AbstractStrategy
      org.apache.openjpa.jdbc.meta.strats.AbstractFieldStrategy
          org.apache.openjpa.jdbc.meta.strats.ContainerFieldStrategy
              org.apache.openjpa.jdbc.meta.strats.StoreCollectionFieldStrategy
                  org.apache.openjpa.jdbc.meta.strats.RelationToManyInverseKeyFieldStrategy

All Implemented Interfaces:

java.io.Serializable, FieldStrategy, Strategy

Direct Known Subclasses:

RelationCollectionInverseKeyFieldStrategy, RelationMapInverseKeyFieldStrategy

public abstract class RelationToManyInverseKeyFieldStrategy
extends StoreCollectionFieldStrategy

Maps a relation to a set of other objects using an inverse foreign key in the related object table.

Author:

Abe White

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.openjpa.jdbc.meta.strats.AbstractFieldStrategy

field

Constructor Summary

RelationToManyInverseKeyFieldStrategy()

Method Summary

void	delete(org.apache.openjpa.kernel.OpenJPAStateManager sm, JDBCStore store, RowManager rm) Set the where values appropriately to delete the proper instance, and set all relations on non-secondary tables as updates.
protected ClassMapping[]	getIndependentElementMappings(boolean traverse) Return all independent mappings to which this strategy must join in order to access collection elements, or empty array if none.
protected ForeignKey	getJoinForeignKey(ClassMapping elem) Return the foreign key used to join to the owning field for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).
void	initialize() Perform caching and other initialization operations.
void	insert(org.apache.openjpa.kernel.OpenJPAStateManager sm, JDBCStore store, RowManager rm) Set values for the mapping into the proper rows.
Joins	join(Joins joins, boolean forceOuter) Join this value to the class table.
protected Joins	join(Joins joins, ClassMapping elem) Join to the owning field table for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).
protected Joins	joinElementRelation(Joins joins, ClassMapping elem) Join this value's table to the table for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).
protected java.lang.Object	loadElement(org.apache.openjpa.kernel.OpenJPAStateManager sm, JDBCStore store, JDBCFetchConfiguration fetch, Result res, Joins joins) Load an element of the collection.
void	map(boolean adapt) Map the owning mapping using this strategy.
protected void	selectElement(Select sel, ClassMapping elem, JDBCStore store, JDBCFetchConfiguration fetch, int eagerMode, Joins joins) Implement this method to select the elements of this field for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).
java.lang.Object	toDataStoreValue(java.lang.Object val, JDBCStore store) Translate the given external field value to its datastore equivalent.
void	update(org.apache.openjpa.kernel.OpenJPAStateManager sm, JDBCStore store, RowManager rm) Set values for the mapping into the proper rows.

Methods inherited from class org.apache.openjpa.jdbc.meta.strats.StoreCollectionFieldStrategy

add, getJoinForeignKey, isEagerSelectToMany, load, loadEagerJoin, loadEagerParallel, loadProjection, newLRSProxy, selectAll, selectEagerJoin, selectEagerParallel, supportsSelect, toCollection

Methods inherited from class org.apache.openjpa.jdbc.meta.strats.ContainerFieldStrategy

appendIsEmpty, appendIsNotEmpty, appendIsNotNull, appendIsNull, appendJoinCount, appendSize, appendUnaliasedJoin

Methods inherited from class org.apache.openjpa.jdbc.meta.strats.AbstractFieldStrategy

assertNotMappedBy, isVersionable, joinKey, joinKeyRelation, joinRelation, load, loadKeyProjection, select, setFieldMapping, toKeyDataStoreValue, where

Methods inherited from class org.apache.openjpa.jdbc.meta.strats.AbstractStrategy

customDelete, customInsert, customUpdate, getAlias, isCustomDelete, isCustomInsert, isCustomUpdate

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.openjpa.jdbc.meta.Strategy

customDelete, customInsert, customUpdate, getAlias, isCustomDelete, isCustomInsert, isCustomUpdate

Constructor Detail

RelationToManyInverseKeyFieldStrategy

public RelationToManyInverseKeyFieldStrategy()

Method Detail

getIndependentElementMappings

protected ClassMapping[] getIndependentElementMappings(boolean traverse)

Description copied from class: ContainerFieldStrategy

Return all independent mappings to which this strategy must join in order to access collection elements, or empty array if none.

Specified by:

getIndependentElementMappings in class ContainerFieldStrategy

Parameters:

traverse - whether we're traversing through to the related type

See Also:

ValueMapping.getIndependentTypeMappings(), ClassMapping.EMPTY_MAPPINGS

getJoinForeignKey

protected ForeignKey getJoinForeignKey(ClassMapping elem)

Description copied from class: StoreCollectionFieldStrategy

Return the foreign key used to join to the owning field for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).

Specified by:

getJoinForeignKey in class StoreCollectionFieldStrategy

selectElement

protected void selectElement(Select sel,
                             ClassMapping elem,
                             JDBCStore store,
                             JDBCFetchConfiguration fetch,
                             int eagerMode,
                             Joins joins)

Description copied from class: StoreCollectionFieldStrategy

Implement this method to select the elements of this field for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null). Elements of the result will be loaded with StoreCollectionFieldStrategy.loadElement(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.kernel.JDBCFetchConfiguration, org.apache.openjpa.jdbc.sql.Result, org.apache.openjpa.jdbc.sql.Joins).

Specified by:

selectElement in class StoreCollectionFieldStrategy

loadElement

protected java.lang.Object loadElement(org.apache.openjpa.kernel.OpenJPAStateManager sm,
                                       JDBCStore store,
                                       JDBCFetchConfiguration fetch,
                                       Result res,
                                       Joins joins)
                                throws java.sql.SQLException

Description copied from class: StoreCollectionFieldStrategy

Load an element of the collection. The given state manager might be null if the load is for a projection or for processing eager parallel results.

Specified by:

loadElement in class StoreCollectionFieldStrategy

Throws:

java.sql.SQLException

join

protected Joins join(Joins joins,
                     ClassMapping elem)

Description copied from class: StoreCollectionFieldStrategy

Join to the owning field table for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).

Specified by:

join in class StoreCollectionFieldStrategy

joinElementRelation

protected Joins joinElementRelation(Joins joins,
                                    ClassMapping elem)

Description copied from class: StoreCollectionFieldStrategy

Join this value's table to the table for the given element mapping from ContainerFieldStrategy.getIndependentElementMappings(boolean) (or null).

Specified by:

joinElementRelation in class StoreCollectionFieldStrategy

See Also:

FieldMapping.joinRelation(org.apache.openjpa.jdbc.sql.Joins, boolean, boolean)

map

public void map(boolean adapt)

Description copied from interface: Strategy

Map the owning mapping using this strategy.

Specified by:

map in interface Strategy

Overrides:

map in class AbstractStrategy

Parameters:

adapt - if true, use the owning mapping's raw mapping info to set its ORM data; if false, ORM data will already be set

initialize

public void initialize()

Description copied from interface: Strategy

Perform caching and other initialization operations. This method is called after Strategy.map(boolean), and after all related components have been mapped as well.

Specified by:

initialize in interface Strategy

Overrides:

initialize in class AbstractStrategy

insert

public void insert(org.apache.openjpa.kernel.OpenJPAStateManager sm,
                   JDBCStore store,
                   RowManager rm)
            throws java.sql.SQLException

Description copied from interface: Strategy

Set values for the mapping into the proper rows. For class mappings, this method will be called only after the corresponding method has been called for all fields of this mapping.

Specified by:

insert in interface Strategy

Overrides:

insert in class AbstractStrategy

Throws:

java.sql.SQLException

update

public void update(org.apache.openjpa.kernel.OpenJPAStateManager sm,
                   JDBCStore store,
                   RowManager rm)
            throws java.sql.SQLException

Description copied from interface: Strategy

Set values for the mapping into the proper rows.

Specified by:

update in interface Strategy

Overrides:

update in class AbstractStrategy

Throws:

java.sql.SQLException

See Also:

Strategy.insert(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.sql.RowManager)

delete

public void delete(org.apache.openjpa.kernel.OpenJPAStateManager sm,
                   JDBCStore store,
                   RowManager rm)
            throws java.sql.SQLException

Description copied from interface: Strategy

Set the where values appropriately to delete the proper instance, and set all relations on non-secondary tables as updates. This allows foreign key analysis.

Specified by:

delete in interface Strategy

Overrides:

delete in class AbstractStrategy

Throws:

java.sql.SQLException

See Also:

Strategy.insert(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore, org.apache.openjpa.jdbc.sql.RowManager)

toDataStoreValue

public java.lang.Object toDataStoreValue(java.lang.Object val,
                                         JDBCStore store)

Description copied from interface: FieldStrategy

Translate the given external field value to its datastore equivalent. If the mapping occupies multiple columns in the datastore, return an object array, else return a single object. Simply returns the given object by default.

Specified by:

toDataStoreValue in interface FieldStrategy

Overrides:

toDataStoreValue in class AbstractFieldStrategy

join

public Joins join(Joins joins,
                  boolean forceOuter)

Description copied from interface: FieldStrategy

Join this value to the class table. Does nothing by default.

Specified by:

join in interface FieldStrategy

Overrides:

join in class AbstractFieldStrategy