Package com.opencqrs.framework.command

Interface ExpectDsl.Failing

Enclosing interface:

ExpectDsl

public static interface ExpectDsl.Failing

Fluent API for assertions after failed command execution. Provides methods to verify the exception type and precondition violations.

All assertion methods return this to allow method chaining:

 .fails()
     .throwing(IllegalStateException.class)
     .throwsSatisfying(ex -> assertThat(ex.getMessage()).contains("invalid"));
 

Method Summary

Modifier and Type	Method	Description
<T extends Throwable> ExpectDsl.Failing	throwing(Class<T> t)	Asserts that the thrown exception is an instance of the specified type.
<T extends Throwable> ExpectDsl.Failing	throwing(T t)	Asserts that the thrown exception matches the specified throwable by type and message.
<T extends Throwable> ExpectDsl.Failing	throwsSatisfying(Consumer<T> assertion)	Asserts that the thrown exception satisfies custom assertions.
ExpectDsl.Failing	violatingAnyCondition()	Asserts that the command failed due to a Command.SubjectCondition violation.
ExpectDsl.Failing	violatingExactly(Command.SubjectCondition condition)	Asserts that the command failed due to a specific Command.SubjectCondition violation.

Method Details

throwing

<T extends Throwable> ExpectDsl.Failing throwing(Class<T> t)

Asserts that the thrown exception is an instance of the specified type.

Type Parameters:

T - the exception type

Parameters:

t - the expected exception class

Returns:

this for method chaining

Throws:

AssertionError - if the exception is not of the expected type

throwing

<T extends Throwable> ExpectDsl.Failing throwing(T t)

Asserts that the thrown exception matches the specified throwable by type and message. The actual exception must be an instance of the same class and have an equal message.

Type Parameters:

T - the exception type

Parameters:

t - the expected throwable to compare against

Returns:

this for method chaining

Throws:

AssertionError - if the exception type or message differs

throwsSatisfying

<T extends Throwable> ExpectDsl.Failing throwsSatisfying(Consumer<T> assertion)

Asserts that the thrown exception satisfies custom assertions.

Example:

 .fails()
     .throwsSatisfying((IllegalArgumentException ex) ->
         assertThat(ex.getMessage()).contains("order not found"));
 

Type Parameters:

T - the exception type

Parameters:

assertion - a consumer receiving the exception for custom assertions

Returns:

this for method chaining

Throws:

AssertionError - if thrown by the consumer

violatingAnyCondition

ExpectDsl.Failing violatingAnyCondition()

Asserts that the command failed due to a Command.SubjectCondition violation. This matches either Command.SubjectCondition.PRISTINE or Command.SubjectCondition.EXISTS violations.

Returns:

this for method chaining

Throws:

AssertionError - if the failure was not due to a precondition violation

violatingExactly

ExpectDsl.Failing violatingExactly(Command.SubjectCondition condition)

Asserts that the command failed due to a specific Command.SubjectCondition violation.

Example:

 // Command requires the subject to not exist yet
 .fails()
     .violatingExactly(Command.SubjectCondition.PRISTINE);
 

Parameters:

condition - the expected violated condition (Command.SubjectCondition.PRISTINE or Command.SubjectCondition.EXISTS)

Returns:

this for method chaining

Throws:

IllegalArgumentException - if Command.SubjectCondition.NONE is passed

AssertionError - if the failure was not due to the specified condition