io.flamingock.internal.common.core.error

Class TargetSystemException

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.TargetSystemException

All Implemented Interfaces:

java.io.Serializable

public class TargetSystemException
extends FlamingockException

Exception thrown when target system configuration or resolution fails.

This exception provides comprehensive context about target system issues including:

• The target system ID that was requested
• Available target systems in the configuration
• Validation mode (strict vs relaxed)
• Fallback behavior and resolution status
• Configuration suggestions and resolution guidance

This exception should be used for target system validation failures, missing target systems, configuration errors, and initialization problems.

Since:

6.0.0

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TargetSystemException.FailureType

Constructor Summary

Constructors

Constructor and Description
TargetSystemException(java.lang.String message, TargetSystemException.FailureType failureType, java.lang.String requestedTargetSystemId, java.util.Set<java.lang.String> availableTargetSystems, boolean strictValidation, java.lang.String fallbackTargetSystemId, java.lang.String resolutionSuggestion, java.lang.Throwable cause) Creates a new TargetSystemException with comprehensive context.
TargetSystemException(java.lang.String message, TargetSystemException.FailureType failureType, java.lang.Throwable cause) Creates a TargetSystemException with minimal context (for backward compatibility).

Method Summary

Modifier and Type	Method and Description
java.util.Set<java.lang.String>	getAvailableTargetSystems()
TargetSystemException.FailureType	getFailureType()
java.lang.String	getFallbackTargetSystemId()
java.lang.String	getRequestedTargetSystemId()
java.lang.String	getResolutionSuggestion()
static TargetSystemException	initializationFailed(java.lang.String targetSystemId, java.lang.Throwable cause) Factory method for target system initialization failures.
boolean	isStrictValidation()
static TargetSystemException	notFound(java.lang.String requestedId, java.util.Set<java.lang.String> availableIds, boolean strictValidation) Factory method for target system not found errors.

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

TargetSystemException

public TargetSystemException(java.lang.String message,
                             TargetSystemException.FailureType failureType,
                             java.lang.String requestedTargetSystemId,
                             java.util.Set<java.lang.String> availableTargetSystems,
                             boolean strictValidation,
                             java.lang.String fallbackTargetSystemId,
                             java.lang.String resolutionSuggestion,
                             java.lang.Throwable cause)

Creates a new TargetSystemException with comprehensive context.

Parameters:

message - descriptive error message

failureType - the specific type of target system failure

requestedTargetSystemId - the target system ID that was requested

availableTargetSystems - set of available/configured target system IDs

strictValidation - whether strict validation was enabled

fallbackTargetSystemId - the fallback target system ID (if applicable)

resolutionSuggestion - guidance on how to resolve the issue

cause - the underlying exception that caused the failure

TargetSystemException

public TargetSystemException(java.lang.String message,
                             TargetSystemException.FailureType failureType,
                             java.lang.Throwable cause)

Creates a TargetSystemException with minimal context (for backward compatibility).

Parameters:

message - descriptive error message

failureType - the type of target system failure

cause - the underlying exception

Method Detail

notFound

public static TargetSystemException notFound(java.lang.String requestedId,
                                             java.util.Set<java.lang.String> availableIds,
                                             boolean strictValidation)

Factory method for target system not found errors.

Parameters:

requestedId - the target system ID that wasn't found

availableIds - the available target system IDs

strictValidation - whether strict validation is enabled

initializationFailed

public static TargetSystemException initializationFailed(java.lang.String targetSystemId,
                                                         java.lang.Throwable cause)

Factory method for target system initialization failures.

Parameters:

targetSystemId - the target system that failed to initialize

cause - the underlying initialization error

getFailureType

public TargetSystemException.FailureType getFailureType()

getRequestedTargetSystemId

public java.lang.String getRequestedTargetSystemId()

getAvailableTargetSystems

public java.util.Set<java.lang.String> getAvailableTargetSystems()

isStrictValidation

public boolean isStrictValidation()

getFallbackTargetSystemId

public java.lang.String getFallbackTargetSystemId()

getResolutionSuggestion

public java.lang.String getResolutionSuggestion()