org.sormula.operation.cascade

Class ModifyCascadeOperation<S,T>

java.lang.Object

org.sormula.operation.cascade.CascadeOperation<S,T>

org.sormula.operation.cascade.ModifyCascadeOperation<S,T>

Type Parameters:

S - row class of table that is source of cascade

T - row class of table that is target of cascade

All Implemented Interfaces:

java.lang.AutoCloseable

Direct Known Subclasses:

DeleteCascadeOperation, InsertCascadeOperation, SaveCascadeOperation, UpdateCascadeOperation

public abstract class ModifyCascadeOperation<S,T>
extends CascadeOperation<S,T>

Base class for cascades that modify database.

Author:

Jeff Miller

Constructor Summary

Constructors

Constructor and Description
ModifyCascadeOperation(ModifyOperation<S> sourceOperation, RowField<S,?> targetField, Table<T> targetTable, java.lang.Class<?> cascadeSqlOperationClass) Constructs from source operation and targets of the cascade.

Method Summary

Modifier and Type	Method and Description
void	cascade(S sourceRow) Performs cascade operation.
void	close() Cleans up by closing any JDBC resources.
protected void	deriveSqlOperationAttributes() Sets the sql operation attributes that are the same as source attributes for all levels.
boolean	isBatch() Returns source operation ModifyOperation.isBatch().
void	prepare() Prepares operation by initializing JDBC statements.

Methods inherited from class org.sormula.operation.cascade.CascadeOperation

createOperation, getDepth, getForeignKeyReferenceFieldName, getForeignKeyValueFieldNames, getKeyFieldCount, getNamedParameterMap, getRequiredCascades, getSourceOperation, getSourceRow, getSourceTable, getTargetField, getTargetForeignKeyValueFieldList, getTargetTable, isPost, prepareForeignKeyReferenceField, prepareForeignKeyValueFields, setForeignKeyFieldNames, setForeignKeyReference, setForeignKeyReference, setForeignKeyReferenceFieldName, setForeignKeyValues, setForeignKeyValues, setPost

Methods inherited from class java.lang.Object

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

Constructor Detail

ModifyCascadeOperation

public ModifyCascadeOperation(ModifyOperation<S> sourceOperation,
                              RowField<S,?> targetField,
                              Table<T> targetTable,
                              java.lang.Class<?> cascadeSqlOperationClass)

Constructs from source operation and targets of the cascade.

Parameters:

sourceOperation - operation where cascade originates

targetField - cascade operation uses row(s) from this field

targetTable - cascade operation is performed on this table

cascadeSqlOperationClass - class of cascade operation false if cascade is performed before row execute (see ModifyOperation.preExecute(R)

Since:

4.1

Method Detail

isBatch

public boolean isBatch()

Returns source operation ModifyOperation.isBatch().

Note that batch operations do not support identity operations (InsertOperation.setAutoGeneratedKeys(boolean) and Column.identity()). So cascaded inserts cannot have values generated for identity columns.

Returns:

true if rows are to be inserted/updated/deleted in batch mode

Since:

4.1

cascade

public void cascade(S sourceRow)
             throws OperationException

Performs cascade operation. Retains value of source row parameter. Subclasses should invoke super.cascade() and then implement their specific behavior.

Overrides:

cascade in class CascadeOperation<S,T>

Parameters:

sourceRow - row in parent table that was source the cascade

Throws:

OperationException - if error

prepare

public void prepare()
             throws OperationException

Prepares operation by initializing JDBC statements. This method prepares foreign key mapping with CascadeOperation.prepareForeignKeyValueFields(). Subclasses should override to perform additional preparation.

Overrides:

prepare in class CascadeOperation<S,T>

Throws:

OperationException - if error

deriveSqlOperationAttributes

protected void deriveSqlOperationAttributes()

Description copied from class: CascadeOperation

Sets the sql operation attributes that are the same as source attributes for all levels. Cascade depth is also set as 1 + source depth.

Overrides:

deriveSqlOperationAttributes in class CascadeOperation<S,T>

close

public void close()
           throws OperationException

Cleans up by closing any JDBC resources.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class CascadeOperation<S,T>

Throws:

OperationException - if error