io.flamingock.internal.core.task.navigation.navigator.strategy

Class SimpleTxChangeProcessStrategy

java.lang.Object

io.flamingock.internal.core.task.navigation.navigator.strategy.AbstractChangeProcessStrategy<TransactionalTargetSystemOps>

io.flamingock.internal.core.task.navigation.navigator.strategy.SimpleTxChangeProcessStrategy

All Implemented Interfaces:

ChangeProcessStrategy

public class SimpleTxChangeProcessStrategy
extends AbstractChangeProcessStrategy<TransactionalTargetSystemOps>

Change process strategy for transactional target systems with separate audit store.

This strategy is used when the target system supports transactions but uses a separate audit store (either a different database in community edition or cloud-based audit in cloud edition). Changes are applied within a transaction, but audit operations occur in a separate transaction context.

Execution Flow

1. Audit change start in separate audit store
2. Begin transaction in target system
3. Apply change to target system
4. Mark change as applied in target system (if marker supported)
5. Commit target system transaction
6. Audit execution result in separate audit store
7. Clear target system marker on success
8. On failure: audit rollback and execute rollback chain with best effort

Target System State Outcomes

• Success: Change committed, marker cleared
• Failure: Transaction rolled back automatically
• Partial Success: Change applied but audit failed (marker remains)

Audit Store State Outcomes

• STARTED: Change execution began but process interrupted
• STARTED → APPLIED: Change successfully applied and audited
• STARTED → FAILED: Change execution failed
• STARTED → FAILED → ROLLED_BACK: Change failed and automatic rollback audited

Marker Behavior

When the target system supports markers (not NoOpTargetSystemAuditMarker), this strategy creates a marker indicating change application status. This marker aids in recovery scenarios by providing clear indication of whether the change was successfully applied to the target system.

Field Summary

Fields inherited from class io.flamingock.internal.core.task.navigation.navigator.strategy.AbstractChangeProcessStrategy

auditStoreOperations, change, executionContext, resultBuilder, stepLogger, targetSystemOps, timeService

Constructor Summary

Constructors

Constructor and Description
SimpleTxChangeProcessStrategy(ExecutableTask change, ExecutionContext executionContext, TransactionalTargetSystemOps targetSystemOps, AuditStoreStepOperations auditStoreOperations, ChangeResultBuilder resultBuilder, LockGuardProxyFactory proxyFactory, io.flamingock.internal.common.core.context.ContextResolver baseContext, io.flamingock.internal.util.TimeService timeService)

Method Summary

Modifier and Type	Method and Description
protected void	auditAndLogAutoRollback()
protected ChangeProcessResult	doApplyChange() Strategy-specific implementation of change application.

Methods inherited from class io.flamingock.internal.core.task.navigation.navigator.strategy.AbstractChangeProcessStrategy

applyChange, auditAndLogAutoRollback, auditAndLogExecution, auditAndLogManualRollback, auditAndLogStartExecution, buildExecutionRuntime

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleTxChangeProcessStrategy

public SimpleTxChangeProcessStrategy(ExecutableTask change,
                                     ExecutionContext executionContext,
                                     TransactionalTargetSystemOps targetSystemOps,
                                     AuditStoreStepOperations auditStoreOperations,
                                     ChangeResultBuilder resultBuilder,
                                     LockGuardProxyFactory proxyFactory,
                                     io.flamingock.internal.common.core.context.ContextResolver baseContext,
                                     io.flamingock.internal.util.TimeService timeService)

Method Detail

doApplyChange

protected ChangeProcessResult doApplyChange()

Description copied from class: AbstractChangeProcessStrategy

Strategy-specific implementation of change application.

Concrete strategies must implement this method to define their specific transaction handling, execution flow, and error recovery patterns.

Specified by:

doApplyChange in class AbstractChangeProcessStrategy<TransactionalTargetSystemOps>

Returns:

Task execution result with success/failure status and details

auditAndLogAutoRollback

protected void auditAndLogAutoRollback()