Package org.apache.juneau.assertions

Class ArrayAssertion<E>

java.lang.Object
org.apache.juneau.assertions.Assertion
org.apache.juneau.assertions.FluentAssertion<R>
org.apache.juneau.assertions.FluentObjectAssertion<E[],R>
org.apache.juneau.assertions.FluentArrayAssertion<E,ArrayAssertion<E>>
org.apache.juneau.assertions.ArrayAssertion<E>
Type Parameters:
E - The element type.
public class ArrayAssertion<E> extends FluentArrayAssertion<E,ArrayAssertion<E>>
Used for assertion calls against arrays.
Example:

import static org.apache.juneau.assertions.Assertions.*; String[] array = {"foo"}; assertArray(array).exists().isSize(1);

Test Methods
Transform Methods

Configuration Methods

See Also:

  • Constructor Details

    • ArrayAssertion

      public ArrayAssertion(E[] value)
      Constructor.
      Parameters:
      value - The object being tested.
      Can be null.

  • Method Details

    • create

      public static <E> ArrayAssertion<E> create(E[] value)
      Static creator.
      Type Parameters:
      E - The element type.
      Parameters:
      value - The object being tested.
      Can be null.
      Returns:
      A new assertion object.

    • setMsg

      public ArrayAssertion<E> setMsg(String msg, Object... args)
      Description copied from class: Assertion
      Allows you to override the assertion failure message.

      String can contain "{msg}" to represent the original message.

      Example:

      import static org.apache.juneau.assertions.Assertions.*; // Throws an assertion with a custom message instead of the default "Value was null." assertString(myString) .setMsg("My string was bad: {msg}") .isNotNull();

      Overrides:
      setMsg in class FluentArrayAssertion<E,ArrayAssertion<E>>
      Parameters:
      msg - The assertion failure message.
      args - Optional message arguments.
      Returns:
      This object.

    • setOut

      public ArrayAssertion<E> setOut(PrintStream value)
      Description copied from class: Assertion
      If an error occurs, send the error message to the specified stream instead of STDERR.
      Overrides:
      setOut in class FluentArrayAssertion<E,ArrayAssertion<E>>
      Parameters:
      value - The output stream. Can be null to suppress output.
      Returns:
      This object.

    • setSilent

      public ArrayAssertion<E> setSilent()
      Description copied from class: Assertion
      Suppresses output to STDERR.

      This is the equivalent to calling out(null).

      Overrides:
      setSilent in class FluentArrayAssertion<E,ArrayAssertion<E>>
      Returns:
      This object.

    • setStdOut

      public ArrayAssertion<E> setStdOut()
      Description copied from class: Assertion
      If an error occurs, send the error message to STDOUT instead of STDERR.
      Overrides:
      setStdOut in class FluentArrayAssertion<E,ArrayAssertion<E>>
      Returns:
      This object.

    • setThrowable

      public ArrayAssertion<E> setThrowable(Class<? extends RuntimeException> value)
      Description copied from class: Assertion
      If an error occurs, throw this exception instead of the standard AssertionError.

      The throwable class must have a public constructor that takes in any of the following parameters:

      • Throwable - The caused-by exception (if there is one).
      • String - The assertion failure message.

      If the throwable cannot be instantiated, a RuntimeException is thrown instead.

      Example:

      import static org.apache.juneau.assertions.Assertions.*; // Throws a BadRequest instead of an AssertionError if the string is null. assertString(myString) .setThrowable(BadRequest.class) .isNotNull();

      Overrides:
      setThrowable in class FluentArrayAssertion<E,ArrayAssertion<E>>
      Parameters:
      value - The new value for this setting.
      Returns:
      This object.