io.flamingock.internal.common.core.error

Class ChangeExecutionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

io.flamingock.internal.common.core.error.FlamingockException

io.flamingock.internal.common.core.error.ChangeExecutionException

All Implemented Interfaces:

java.io.Serializable

public class ChangeExecutionException
extends FlamingockException

Exception thrown when a Change execution fails.

This exception provides rich context about the failed change execution including:

• Change ID and stage information
• Execution mode (transactional, non-transactional, shared-transactional)
• Execution duration for performance analysis
• Target system information
• Original cause with preserved stack trace

This exception should be used instead of generic FlamingockException when change execution fails, as it provides much better debugging context.

Since:

6.0.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ChangeExecutionException(java.lang.String message, java.lang.String changeId, java.lang.String stageName, java.lang.String executionMode, java.time.Duration executionDuration, java.lang.String targetSystemId, java.lang.Throwable cause) Creates a new ChangeExecutionException with full execution context.
ChangeExecutionException(java.lang.String message, java.lang.String changeId, java.lang.Throwable cause) Creates a new ChangeExecutionException with minimal context (for backward compatibility).

Method Summary

Modifier and Type	Method and Description
java.lang.String	getChangeId()
java.time.Duration	getExecutionDuration()
java.lang.String	getExecutionMode()
java.lang.String	getStageName()
java.lang.String	getTargetSystemId()

Methods inherited from class io.flamingock.internal.common.core.error.FlamingockException

toFlamingockException

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ChangeExecutionException

public ChangeExecutionException(java.lang.String message,
                                java.lang.String changeId,
                                java.lang.String stageName,
                                java.lang.String executionMode,
                                java.time.Duration executionDuration,
                                java.lang.String targetSystemId,
                                java.lang.Throwable cause)

Creates a new ChangeExecutionException with full execution context.

Parameters:

message - descriptive error message

changeId - the ID of the failed change

stageName - the name of the stage containing the change

executionMode - the execution mode (e.g., "transactional", "non-transactional")

executionDuration - how long the change took before failing

targetSystemId - the target system where the change was being applied

cause - the underlying exception that caused the failure

ChangeExecutionException

public ChangeExecutionException(java.lang.String message,
                                java.lang.String changeId,
                                java.lang.Throwable cause)

Creates a new ChangeExecutionException with minimal context (for backward compatibility).

Parameters:

message - descriptive error message

changeId - the ID of the failed change

cause - the underlying exception that caused the failure

Method Detail

getChangeId

public java.lang.String getChangeId()

Returns:

the ID of the failed change

getStageName

public java.lang.String getStageName()

Returns:

the name of the stage containing the failed change

getExecutionMode

public java.lang.String getExecutionMode()

Returns:

the execution mode when the change failed

getExecutionDuration

public java.time.Duration getExecutionDuration()

Returns:

how long the change took before failing

getTargetSystemId

public java.lang.String getTargetSystemId()

Returns:

the target system ID where the change was being applied