org.junit.platform.commons.util

Class Preconditions

java.lang.Object

org.junit.platform.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:

1.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 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 blank.
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 the supplied array and none of the objects it contains 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 <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)

notNull

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

Assert that the supplied array and none of the objects it contains are null.

Parameters:

objects - the array to check

message - precondition violation message

Returns:

the supplied array as a convenience

Throws:

PreconditionViolationException - if the supplied array or any of the objects its contains is null

See Also:

notNull(Object, 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 blank.

A String is blank if it is null or consists only of whitespace characters.

Parameters:

str - the string to check

message - precondition violation message

Returns:

the supplied string as a convenience

Throws:

PreconditionViolationException - if the supplied string is 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 blank.

A String is blank if it is null or consists only of whitespace characters.

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 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