org.junit.gen5.commons.util

Class Preconditions

java.lang.Object

org.junit.gen5.commons.util.Preconditions

@API(value=Internal)
public final class Preconditions
extends java.lang.Object

Collection of utilities for asserting preconditions for method and constructor arguments.

Each method in this class throws a PreconditionViolationException if the precondition is violated.

DISCLAIMER

These utilities are intended solely for usage within the JUnit framework itself. Any usage by external parties is not supported. Use at your own risk!

Since:

5.0

Method Summary

Modifier and Type	Method and Description
static void	condition(boolean predicate, java.lang.String message) Assert that the supplied predicate is true.
static void	condition(boolean predicate, java.util.function.Supplier<java.lang.String> messageSupplier) Assert that the supplied predicate is true.
static java.lang.String	notBlank(java.lang.String str, java.lang.String message) Assert that the supplied String is not null or blank.
static java.lang.String	notBlank(java.lang.String str, java.util.function.Supplier<java.lang.String> messageSupplier) Assert that the supplied String is not null or blank.
static java.lang.String	notEmpty(java.lang.String str, java.lang.String message) Assert that the supplied String is not null or empty.
static java.lang.String	notEmpty(java.lang.String str, java.util.function.Supplier<java.lang.String> messageSupplier) Assert that the supplied String is not null or empty.
static <T extends java.util.Collection<?>> T	notEmpty(T collection, java.lang.String message) Assert that the supplied Collection is not null or empty.
static java.lang.Object[]	notNull(java.lang.Object[] objects, java.lang.String message) Assert that none of the supplied Objects are null.
static <T> T	notNull(T object, java.lang.String message) Assert that the supplied Object is not null.
static <T> T	notNull(T object, java.util.function.Supplier<java.lang.String> messageSupplier) Assert that the supplied Object is not null.

Methods inherited from class java.lang.Object

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

Method Detail

notNull

public static <T> T notNull(T object,
                            java.lang.String message)
                     throws PreconditionViolationException

Assert that the supplied Object is not null.

Parameters:

object - the object to check

message - precondition violation message

Returns:

the supplied object as a convenience

Throws:

PreconditionViolationException - if the supplied object is null

See Also:

notNull(Object, Supplier)

notNull

public static java.lang.Object[] notNull(java.lang.Object[] objects,
                                         java.lang.String message)
                                  throws PreconditionViolationException

Assert that none of the supplied Objects are null.

Parameters:

objects - the objects to check

message - precondition violation message

Returns:

the supplied objects as a convenience

Throws:

PreconditionViolationException - if any of the supplied objects are null

See Also:

notNull(Object, Supplier)

notNull

public static <T> T notNull(T object,
                            java.util.function.Supplier<java.lang.String> messageSupplier)
                     throws PreconditionViolationException

Assert that the supplied Object is not null.

Parameters:

object - the object to check

messageSupplier - precondition violation message supplier

Returns:

the supplied object as a convenience

Throws:

PreconditionViolationException - if the supplied object is null

See Also:

condition(boolean, Supplier)

notEmpty

public static java.lang.String notEmpty(java.lang.String str,
                                        java.lang.String message)
                                 throws PreconditionViolationException

Assert that the supplied String is not null or empty.

Parameters:

str - the string to check

message - precondition violation message

Returns:

the supplied string as a convenience

Throws:

PreconditionViolationException - if the supplied string is null or empty

See Also:

notEmpty(String, Supplier)

notEmpty

public static java.lang.String notEmpty(java.lang.String str,
                                        java.util.function.Supplier<java.lang.String> messageSupplier)
                                 throws PreconditionViolationException

Assert that the supplied String is not null or empty.

Parameters:

str - the string to check

messageSupplier - precondition violation message supplier

Returns:

the supplied string as a convenience

Throws:

PreconditionViolationException - if the supplied string is null or empty

See Also:

StringUtils.isNotEmpty(CharSequence), condition(boolean, Supplier)

notEmpty

public static <T extends java.util.Collection<?>> T notEmpty(T collection,
                                                             java.lang.String message)
                                                      throws PreconditionViolationException

Assert that the supplied Collection is not null or empty.

Parameters:

collection - the collection to check

message - precondition violation message

Returns:

the supplied collection as a convenience

Throws:

PreconditionViolationException - if the supplied collection is null or empty

See Also:

condition(boolean, Supplier)

notBlank

public static java.lang.String notBlank(java.lang.String str,
                                        java.lang.String message)
                                 throws PreconditionViolationException

Assert that the supplied String is not null or blank.

Parameters:

str - the string to check

message - precondition violation message

Returns:

the supplied string as a convenience

Throws:

PreconditionViolationException - if the supplied string is null or blank

See Also:

notBlank(String, Supplier)

notBlank

public static java.lang.String notBlank(java.lang.String str,
                                        java.util.function.Supplier<java.lang.String> messageSupplier)
                                 throws PreconditionViolationException

Assert that the supplied String is not null or blank.

Parameters:

str - the string to check

messageSupplier - precondition violation message supplier

Returns:

the supplied string as a convenience

Throws:

PreconditionViolationException - if the supplied string is null or blank

See Also:

StringUtils.isNotBlank(String), condition(boolean, Supplier)

condition

public static void condition(boolean predicate,
                             java.lang.String message)
                      throws PreconditionViolationException

Assert that the supplied predicate is true.

Parameters:

predicate - the predicate to check

message - precondition violation message

Throws:

PreconditionViolationException - if the predicate is false

See Also:

condition(boolean, Supplier)

condition

public static void condition(boolean predicate,
                             java.util.function.Supplier<java.lang.String> messageSupplier)
                      throws PreconditionViolationException

Assert that the supplied predicate is true.

Parameters:

predicate - the predicate to check

messageSupplier - precondition violation message supplier

Throws:

PreconditionViolationException - if the predicate is false