Package io.jpostman.junit

Class JUnitAssertions<T extends JUnitAssertions<T>>

java.lang.Object

io.jpostman.junit.JUnitAssertions<T>

All Implemented Interfaces:

JPostmanAssertions<JUnitContext,T>

Direct Known Subclasses:

JUnitSoftAssertions

public class JUnitAssertions<T extends JUnitAssertions<T>>
extends Object
implements JPostmanAssertions<JUnitContext,T>

Fluent JUnit assertions with optional secure log output.

Hard assertions run immediately. Soft assertions override the assertion execution hook and verify collected failures later.

Field Summary

Fields

Modifier and Type	Field	Description
protected JUnitContext	context
protected boolean	includeLog
protected boolean	statusCodeAsserted

Method Summary

Modifier and Type	Method	Description
<V> T	allMatch(String path, Class<V> type, BiPredicate<V,Integer> predicate, String message)	Asserts that every value returned by the response path matches the predicate.
T	allMatch(String path, BiPredicate<Object,Integer> predicate, String message)	Asserts that every numeric value returned by the response path matches the predicate.
T	allMatch(String path, Predicate<Number> predicate, String message)	Asserts that every numeric value returned by the response path matches the predicate.
protected T	assertWithLog(Runnable assertion)	Executes an assertion and wraps failures with optional secure log context.
JUnitContext	context()	Returns the owning context for continuing the fluent chain.
T	exists(String path)	Asserts that the current secure response contains the given path.
T	exists(String path, String message)	Asserts that the current secure response contains the given path.
T	isEqual(Object actual, Object expected)	Asserts that the actual value is equal to the expected value.
T	isEqual(Object actual, Object expected, String message)	Asserts that the actual value is equal to the expected value.
T	isFalse(boolean condition)	Asserts that the condition is false.
T	isFalse(boolean condition, String message)	Asserts that the condition is false.
T	isNotEqual(Object actual, Object expected)	Asserts that the actual value is not equal to the expected value.
T	isNotEqual(Object actual, Object expected, String message)	Asserts that the actual value is not equal to the expected value.
T	isNotNull(Object value)	Asserts that the value is not null.
T	isNotNull(Object value, String message)	Asserts that the value is not null.
T	isNull(Object value)	Asserts that the value is null.
T	isNull(Object value, String message)	Asserts that the value is null.
T	isTrue(boolean condition)	Asserts that the condition is true.
T	isTrue(boolean condition, String message)	Asserts that the condition is true.
T	notExists(String path)	Asserts that the current secure response does not contain the given path.
T	notExists(String path, String message)	Asserts that the current secure response does not contain the given path.
T	pathEquals(String path, Object expected)	Asserts that the value at the given response path is equal to the expected value.
T	pathEquals(String path, Object expected, String message)	Asserts that the value at the given response path is equal to the expected value.
T	pathNotNull(String path)	Asserts that the value at the given response path is not null.
T	pathNotNull(String path, String message)	Asserts that the value at the given response path is not null.
protected T	self()
T	statusCode(int expected)	Asserts that the current secure response has the expected status code.
T	statusCode(int expected, String message)	Asserts that the current secure response has the expected status code.
JUnitContext	verify()	Verifies status code 200 and returns the test context.
JUnitContext	verify(int statusCode)	Verifies the expected status code and returns the test context.
protected AssertionError	wrap(AssertionError error)	Wraps an assertion error with optional secure log context.

Methods inherited from class java.lang.Object

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

Field Detail

context

protected final JUnitContext context

includeLog

protected final boolean includeLog

statusCodeAsserted

protected boolean statusCodeAsserted

Method Detail

self

protected T self()

context

public JUnitContext context()

Returns the owning context for continuing the fluent chain.

Specified by:

context in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Returns:

owning JUnit context

isEqual

public T isEqual(Object actual,
                 Object expected)

Asserts that the actual value is equal to the expected value.

Specified by:

isEqual in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

actual - the actual value

expected - the expected value

Returns:

this assertion helper

isEqual

public T isEqual(Object actual,
                 Object expected,
                 String message)

Asserts that the actual value is equal to the expected value.

Specified by:

isEqual in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

actual - the actual value

expected - the expected value

message - custom failure message

Returns:

this assertion helper

isNotEqual

public T isNotEqual(Object actual,
                    Object expected)

Asserts that the actual value is not equal to the expected value.

Specified by:

isNotEqual in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

actual - the actual value

expected - the expected value

Returns:

this assertion helper

isNotEqual

public T isNotEqual(Object actual,
                    Object expected,
                    String message)

Asserts that the actual value is not equal to the expected value.

Specified by:

isNotEqual in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

actual - the actual value

expected - the expected value

message - custom failure message

Returns:

this assertion helper

isTrue

public T isTrue(boolean condition)

Asserts that the condition is true.

Specified by:

isTrue in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

condition - the condition to check

Returns:

this assertion helper

isTrue

public T isTrue(boolean condition,
                String message)

Asserts that the condition is true.

Specified by:

isTrue in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

condition - the condition to check

message - custom failure message

Returns:

this assertion helper

isFalse

public T isFalse(boolean condition)

Asserts that the condition is false.

Specified by:

isFalse in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

condition - the condition to check

Returns:

this assertion helper

isFalse

public T isFalse(boolean condition,
                 String message)

Asserts that the condition is false.

Specified by:

isFalse in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

condition - the condition to check

message - custom failure message

Returns:

this assertion helper

isNull

public T isNull(Object value)

Asserts that the value is null.

Specified by:

isNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

value - the value to check

Returns:

this assertion helper

isNull

public T isNull(Object value,
                String message)

Asserts that the value is null.

Specified by:

isNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

value - the value to check

message - custom failure message

Returns:

this assertion helper

isNotNull

public T isNotNull(Object value)

Asserts that the value is not null.

Specified by:

isNotNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

value - the value to check

Returns:

this assertion helper

isNotNull

public T isNotNull(Object value,
                   String message)

Asserts that the value is not null.

Specified by:

isNotNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

value - the value to check

message - custom failure message

Returns:

this assertion helper

statusCode

public T statusCode(int expected)

Asserts that the current secure response has the expected status code.

Specified by:

statusCode in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

expected - the expected status code

Returns:

this assertion helper

statusCode

public T statusCode(int expected,
                    String message)

Asserts that the current secure response has the expected status code.

Specified by:

statusCode in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

expected - the expected status code

message - custom failure message

Returns:

this assertion helper

exists

public T exists(String path)

Asserts that the current secure response contains the given path.

Specified by:

exists in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

Returns:

this assertion helper

exists

public T exists(String path,
                String message)

Asserts that the current secure response contains the given path.

Specified by:

exists in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

message - custom failure message

Returns:

this assertion helper

notExists

public T notExists(String path)

Asserts that the current secure response does not contain the given path.

Specified by:

notExists in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

Returns:

this assertion helper

notExists

public T notExists(String path,
                   String message)

Asserts that the current secure response does not contain the given path.

Specified by:

notExists in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

message - custom failure message

Returns:

this assertion helper

pathEquals

public T pathEquals(String path,
                    Object expected)

Asserts that the value at the given response path is equal to the expected value.

Specified by:

pathEquals in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

expected - the expected value

Returns:

this assertion helper

pathEquals

public T pathEquals(String path,
                    Object expected,
                    String message)

Asserts that the value at the given response path is equal to the expected value.

Specified by:

pathEquals in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

expected - the expected value

message - custom failure message

Returns:

this assertion helper

pathNotNull

public T pathNotNull(String path)

Asserts that the value at the given response path is not null.

Specified by:

pathNotNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

Returns:

this assertion helper

pathNotNull

public T pathNotNull(String path,
                     String message)

Asserts that the value at the given response path is not null.

Specified by:

pathNotNull in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - the response path to check

message - custom failure message

Returns:

this assertion helper

allMatch

public T allMatch(String path,
                  Predicate<Number> predicate,
                  String message)

Asserts that every numeric value returned by the response path matches the predicate.

Specified by:

allMatch in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - response path that resolves to a list of numeric values

predicate - predicate applied to each value

message - custom failure message. Use {} for the value.

Returns:

this assertion helper

allMatch

public T allMatch(String path,
                  BiPredicate<Object,Integer> predicate,
                  String message)

Asserts that every numeric value returned by the response path matches the predicate.

Specified by:

allMatch in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

path - response path that resolves to a list of numeric values

predicate - predicate applied to each value and index

message - custom failure message. Use {} placeholders for value and index.

Returns:

this assertion helper

allMatch

public <V> T allMatch(String path,
                      Class<V> type,
                      BiPredicate<V,Integer> predicate,
                      String message)

Asserts that every value returned by the response path matches the predicate.

Specified by:

allMatch in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Type Parameters:

V - expected value type

Parameters:

path - response path that resolves to a list of values

type - expected value type

predicate - predicate applied to each value and index

message - custom failure message. Use {} placeholders for value and index.

Returns:

this assertion helper

verify

public JUnitContext verify()

Verifies status code 200 and returns the test context.

This allows assertion chains to finish back on the context.

Specified by:

verify in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Returns:

current test context

verify

public JUnitContext verify(int statusCode)

Verifies the expected status code and returns the test context.

In hard mode, this fails immediately on status code mismatch. In soft mode, collected soft assertions are verified and the expected status code is added only when no status code assertion was already collected.

Specified by:

verify in interface JPostmanAssertions<JUnitContext,T extends JUnitAssertions<T>>

Parameters:

statusCode - expected status code

Returns:

current test context

assertWithLog

protected T assertWithLog(Runnable assertion)

Executes an assertion and wraps failures with optional secure log context.

Parameters:

assertion - assertion to execute

Returns:

this assertion helper

wrap

protected AssertionError wrap(AssertionError error)

Wraps an assertion error with optional secure log context.

Parameters:

error - original assertion error

Returns:

wrapped assertion error