org.sormula.annotation.cascade

Annotation Type InsertCascade

@Retention(value=RUNTIME)
 @Target(value=ANNOTATION_TYPE)
public @interface InsertCascade

Used within a Cascade annotation to define a cascade insert operation.

Since:

1.0

Author:

Jeff Miller

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
java.lang.Class<? extends InsertOperation>	operation Specifies operation to perform as a insert cascade.
boolean	post Specifies when the cascade is to occur.
boolean	setForeignKeyReference Indicates that foreign key reference should be set on target (child) rows during cascade.
boolean	setForeignKeyValues Indicates that foreign key values should be set on target (child) rows during cascade.

Element Detail

operation

public abstract java.lang.Class<? extends InsertOperation> operation

Specifies operation to perform as a insert cascade. Typically it is InsertOperation. Use subclass of InsertOperation to customize the insert cascade.

Returns:

operation to use for cascade

Default:

org.sormula.operation.InsertOperation.class

post

public abstract boolean post

Specifies when the cascade is to occur.

Returns:

true to perform cascade after source row operation; false to perform cascade before source row operation

Default:

true

setForeignKeyValues

public abstract boolean setForeignKeyValues

Indicates that foreign key values should be set on target (child) rows during cascade. Foreign key value fields are defined by Cascade.foreignKeyValueFields(), OneToManyCascade.foreignKeyValueFields(), or OneToOneCascade.foreignKeyValueFields().

Foreign key values are set prior to cascade for insert, update, delete, and save cascades. They are set after select cascades.

This value is particularly useful when parent key is created based upon an identity column Column.identity() is true. Child row's parent foreign key will be set when parent is inserted.

Returns:

true to set foreign key values during cascade

Since:

3.0

Default:

true

setForeignKeyReference

public abstract boolean setForeignKeyReference

Indicates that foreign key reference should be set on target (child) rows during cascade. Foreign key reference field is defined by Cascade.foreignKeyReferenceField(), OneToManyCascade.foreignKeyReferenceField(), or OneToOneCascade.foreignKeyReferenceField().

Foreign key reference is set prior to cascade for insert, update, delete, and save cascades. It is set after select cascades.

Returns:

true to set foreign key reference during cascade

Since:

3.0

Default:

true