org.apache.openjpa.jdbc.meta
Interface Strategy

All Superinterfaces:

Serializable

All Known Subinterfaces:

ClassStrategy, DiscriminatorStrategy, FieldStrategy, LRSCollectionFieldStrategy, LRSMapFieldStrategy, VersionStrategy

All Known Implementing Classes:

AbstractClassStrategy, AbstractDiscriminatorStrategy, AbstractFieldStrategy, AbstractStrategy, AbstractVersionStrategy, ClassMapping, ClassNameDiscriminatorStrategy, ColumnVersionStrategy, ContainerFieldStrategy, Discriminator, EmbeddedClassStrategy, EmbedFieldStrategy, FieldMapping, FlatClassStrategy, FullClassStrategy, HandlerFieldStrategy, InValueDiscriminatorStrategy, MapTableFieldStrategy, MaxEmbeddedBlobFieldStrategy, MaxEmbeddedByteArrayFieldStrategy, MaxEmbeddedCharArrayFieldStrategy, MaxEmbeddedClobFieldStrategy, NoneClassStrategy, NoneDiscriminatorStrategy, NoneFieldStrategy, NoneVersionStrategy, NumberVersionStrategy, ObjectIdClassStrategy, PrimitiveFieldStrategy, RelationCollectionInverseKeyFieldStrategy, RelationCollectionTableFieldStrategy, RelationFieldStrategy, RelationMapInverseKeyFieldStrategy, RelationMapTableFieldStrategy, RelationToManyInverseKeyFieldStrategy, RelationToManyTableFieldStrategy, StateComparisonVersionStrategy, StoreCollectionFieldStrategy, StringFieldStrategy, SubclassJoinDiscriminatorStrategy, SuperclassDiscriminatorStrategy, SuperclassVersionStrategy, TimestampVersionStrategy, ValueMapDiscriminatorStrategy, Version, VerticalClassStrategy

public interface Strategy
extends Serializable

Interface implemented by all mapping strategies.

Since:

0.4.0

Author:

Abe White

Method Summary

void	customDelete(OpenJPAStateManager sm, JDBCStore store) Override this method to customize flushing this mapping.
void	customInsert(OpenJPAStateManager sm, JDBCStore store) Override this method to customize flushing this mapping.
void	customUpdate(OpenJPAStateManager sm, JDBCStore store) Override this method to customize flushing this mapping.
void	delete(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.
String	getAlias() Return the alias of this strategy.
void	initialize() Perform caching and other initialization operations.
void	insert(OpenJPAStateManager sm, JDBCStore store, RowManager rm) Set values for the mapping into the proper rows.
Boolean	isCustomDelete(OpenJPAStateManager sm, JDBCStore store) Return Boolean.FALSE if this mapping does not customize the delete process, Boolean.TRUE if it does, or null if it does customize the delete, but also relies on the standard delete method being called.
Boolean	isCustomInsert(OpenJPAStateManager sm, JDBCStore store) Return Boolean.FALSE if this mapping does not customize the insert process, Boolean.TRUE if it does, or null if it does customize the insert, but also relies on the standard insert method being called.
Boolean	isCustomUpdate(OpenJPAStateManager sm, JDBCStore store) Return Boolean.FALSE if this mapping does not customize the update process, Boolean.TRUE if it does, or null if it does customize the update, but also relies on the standard update method being called.
void	map(boolean adapt) Map the owning mapping using this strategy.
void	update(OpenJPAStateManager sm, JDBCStore store, RowManager rm) Set values for the mapping into the proper rows.

Method Detail

getAlias

String getAlias()

Return the alias of this strategy. For custom strategies, return the full class name.

map

void map(boolean adapt)

Map the owning mapping using this strategy.

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

Throws:

MetaDataException - if unable to map

initialize

void initialize()

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

insert

void insert(OpenJPAStateManager sm,
            JDBCStore store,
            RowManager rm)
            throws SQLException

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.

Throws:

SQLException

update

void update(OpenJPAStateManager sm,
            JDBCStore store,
            RowManager rm)
            throws SQLException

Set values for the mapping into the proper rows.

Throws:

SQLException

See Also:

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

delete

void delete(OpenJPAStateManager sm,
            JDBCStore store,
            RowManager rm)
            throws SQLException

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.

Throws:

SQLException

See Also:

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

isCustomInsert

Boolean isCustomInsert(OpenJPAStateManager sm,
                       JDBCStore store)

Return Boolean.FALSE if this mapping does not customize the insert process, Boolean.TRUE if it does, or null if it does customize the insert, but also relies on the standard insert method being called. Implement the customInsert(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore) method to implement the custom insertion behavior.

isCustomUpdate

Boolean isCustomUpdate(OpenJPAStateManager sm,
                       JDBCStore store)

Return Boolean.FALSE if this mapping does not customize the update process, Boolean.TRUE if it does, or null if it does customize the update, but also relies on the standard update method being called. Implement the customUpdate(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore) method to override the default update behavior.

isCustomDelete

Boolean isCustomDelete(OpenJPAStateManager sm,
                       JDBCStore store)

Return Boolean.FALSE if this mapping does not customize the delete process, Boolean.TRUE if it does, or null if it does customize the delete, but also relies on the standard delete method being called. Implement the customDelete(org.apache.openjpa.kernel.OpenJPAStateManager, org.apache.openjpa.jdbc.kernel.JDBCStore) method to override the default deletion behavior.

customInsert

void customInsert(OpenJPAStateManager sm,
                  JDBCStore store)
                  throws SQLException

Override this method to customize flushing this mapping. For classes, this method must also flush all fields. For fields, this method is called after the owning object is inserted, so if this field is in a row with other fields, that row will already exist.

Throws:

SQLException

customUpdate

void customUpdate(OpenJPAStateManager sm,
                  JDBCStore store)
                  throws SQLException

Override this method to customize flushing this mapping. For classes, this method must also flush all fields.

Throws:

SQLException

customDelete

void customDelete(OpenJPAStateManager sm,
                  JDBCStore store)
                  throws SQLException

Override this method to customize flushing this mapping. For classes, this method must also flush all fields. For fields, this method will be called after the owning object is deleted.

Throws:

SQLException