org.ujorm.tools

Class Assert

java.lang.Object

org.ujorm.tools.Assert

public abstract class Assert
extends Object

Assertion utils, where all method can throw the IllegalArgumentException exception only. For a message format see the MsgFormatter#format(java.lang.Object...) method description.

See the next correct asserts

  Assert.isTrue(true, "TEST:{}{}", "A", "B");
  Assert.isTrue(30, (x) -> x > 20, "Wrong No");
  Assert.notNull("ABC");
  Assert.hasLength("ABC");
  Assert.hasLength(new char[]{'A','B','C'});
  Assert.hasLength(new StringBuilder().append("ABC"));
  Assert.hasLength(Arrays.asList("A", "B", "C"));

  Assert.isFalse(false);
  Assert.isFalse(15, (x) -> x > 20);
  Assert.isNull (null);
  Assert.isEmpty("");
  Assert.isEmpty(new char[0]);
  Assert.isEmpty(new StringBuilder());
  Assert.isEmpty((List) null);
 

Since:

1.73

See Also:

https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/util/Assert.html, https://commons.apache.org/proper/commons-lang/javadocs/api-3.1/org/apache/commons/lang3/Validate.html, https://google.github.io/guava/releases/19.0/api/docs/com/google/common/base/Preconditions.html

Field Summary

Fields

Modifier and Type	Field and Description
static Object[]	NO_MESSAGE No messge constant

Method Summary

Modifier and Type	Method and Description
static void	hasLength(byte[] array, Object... message) Checks if the argument is not empty, nor null.
static void	hasLength(Collection<?> values, Object... message) Checks if the argument is not empty, nor null.
static void	hasLength(char[] array, Object... message) Checks if the argument is not empty, nor null.
static void	hasLength(CharSequence value, Object... message) Checks if the argument is not empty, nor null.
static void	hasLength(Map<?,?> values, Object... message) Checks if the argument is not empty, nor null.
static void	hasLength(Object[] values, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(byte[] array, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(Collection<?> values, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(char[] array, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(CharSequence value, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(Map<?,?> values, Object... message) Checks if the argument is not empty, nor null.
static void	isEmpty(Object[] values, Object... message) Checks if the argument is not empty, nor null.
static void	isFalse(boolean condition) Checks if the argument is false.
static void	isFalse(boolean condition, Object... message) Checks if the argument is false.
static <T> void	isFalse(T value, Predicate<T> predicate, Object... message) Checks if the argument is not null and result of the the method Predicate.test() is false.
static <T> void	isFalseNullable(T value, Predicate<T> predicate, Object... message) Checks if the argument of the the method Predicate.test() is false.
static void	isNull(Object value) Checks if the argument is null.
static void	isNull(Object value, Object... message) Checks if the argument is null.
static void	isTrue(boolean condition) Checks if the argument is true.
static void	isTrue(boolean condition, Object... message) Checks if the argument is true.
static <T> void	isTrue(T condition, Predicate<T> predicate, Object... message) Checks if the value is not null and result of the the method Predicate.test() is true.
static <T> void	isTrueNullable(T value, Predicate<T> predicate, Object... message) Checks if the value is result of the the method Predicate.test() is true.
static void	notNull(Object value) Checks if the argument is not null.
static void	notNull(Object value, Object... message) Checks if the argument is not null.
static void	validState(boolean condition, Object... message) If the value Checks if the argument is true.

Methods inherited from class java.lang.Object

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

Field Detail

NO_MESSAGE

public static final Object[] NO_MESSAGE

No messge constant

Method Detail

validState

public static final void validState(boolean condition,
                                    @Nullable
                                    Object... message)
                             throws IllegalStateException

If the value Checks if the argument is true.

Throws:

IllegalStateException - When the condtion is false

isTrue

public static final void isTrue(boolean condition)
                         throws IllegalArgumentException

Checks if the argument is true.

Throws:

IllegalArgumentException

isTrue

public static final void isTrue(boolean condition,
                                @Nullable
                                Object... message)
                         throws IllegalArgumentException

Checks if the argument is true.

Throws:

IllegalArgumentException

isTrue

public static <T> void isTrue(@Nullable
                              T condition,
                              @Nonnull
                              Predicate<T> predicate,
                              @Nullable
                              Object... message)

Checks if the value is not null and result of the the method Predicate.test() is true.

isTrueNullable

public static <T> void isTrueNullable(@Nullable
                                      T value,
                                      @Nonnull
                                      Predicate<T> predicate,
                                      @Nullable
                                      Object... message)

Checks if the value is result of the the method Predicate.test() is true. An argument of the Predicable#test() method can be null.

notNull

public static final void notNull(@Nullable
                                 Object value)
                          throws IllegalArgumentException

Checks if the argument is not null.

Throws:

IllegalArgumentException

notNull

public static void notNull(@Nullable
                           Object value,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             byte[] array,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             char[] array,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             Object[] values,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             Collection<?> values,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             Map<?,?> values,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

hasLength

public static void hasLength(@Nullable
                             CharSequence value,
                             @Nullable
                             Object... message)
                      throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isFalse

public static final void isFalse(boolean condition)
                          throws IllegalArgumentException

Checks if the argument is false.

Throws:

IllegalArgumentException

isFalse

public static final void isFalse(boolean condition,
                                 @Nullable
                                 Object... message)
                          throws IllegalArgumentException

Checks if the argument is false.

Throws:

IllegalArgumentException

isFalse

public static <T> void isFalse(@Nullable
                               T value,
                               @Nonnull
                               Predicate<T> predicate,
                               @Nullable
                               Object... message)

Checks if the argument is not null and result of the the method Predicate.test() is false.

isFalseNullable

public static <T> void isFalseNullable(@Nullable
                                       T value,
                                       @Nonnull
                                       Predicate<T> predicate,
                                       @Nullable
                                       Object... message)

Checks if the argument of the the method Predicate.test() is false. An argument of the Predicable#test() method can be null.

isNull

public static final void isNull(@Nullable
                                Object value)
                         throws IllegalArgumentException

Checks if the argument is null.

Throws:

IllegalArgumentException

isNull

public static void isNull(@Nullable
                          Object value,
                          @Nullable
                          Object... message)
                   throws IllegalArgumentException

Checks if the argument is null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(byte[] array,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(@Nullable
                           char[] array,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(@Nullable
                           Object[] values,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(@Nullable
                           Collection<?> values,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(@Nullable
                           Map<?,?> values,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException

isEmpty

public static void isEmpty(@Nullable
                           CharSequence value,
                           @Nullable
                           Object... message)
                    throws IllegalArgumentException

Checks if the argument is not empty, nor null.

Throws:

IllegalArgumentException