Package org.assertj.core.api

Class AssertionsForClassTypes

java.lang.Object

org.assertj.core.api.AssertionsForClassTypes

Direct Known Subclasses:

AssertionsForInterfaceTypes

public class AssertionsForClassTypes
extends Object

Java 8 is picky when choosing the right assertThat method if the object under test is generic and bounded, for example if foo is instance of T that extends Exception, java 8 will complain that it can't resolve the proper assertThat method (normally assertThat(Throwable) as foo might implement an interface like List, if that occurred assertThat(List) would also be a possible choice - thus confusing java 8.

This why Assertions have been split in AssertionsForClassTypes and AssertionsForInterfaceTypes (see http://stackoverflow.com/questions/29499847/ambiguous-method-in-java-8-why).

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AssertionsForClassTypes()	Creates a new AssertionsForClassTypes.

Method Summary

Modifier and Type	Method	Description
static <T> Condition<T>	allOf(Iterable<? extends Condition<? super T>> conditions)	Creates a new AllOf
static <T> Condition<T>	allOf(Condition<? super T>... conditions)	Creates a new AllOf
static <T> Condition<T>	anyOf(Iterable<? extends Condition<? super T>> conditions)	Creates a new AnyOf
static <T> Condition<T>	anyOf(Condition<? super T>... conditions)	Only delegate to AnyOf.anyOf(Condition...) so that Assertions offers a full feature entry point to all AssertJ features (but you can use AnyOf if you prefer).
static AbstractBooleanAssert<?>	assertThat(boolean actual)	Creates a new instance of BooleanAssert.
static AbstractBooleanArrayAssert<?>	assertThat(boolean[] actual)	Creates a new instance of BooleanArrayAssert.
static Boolean2DArrayAssert	assertThat(boolean[][] actual)	Creates a new instance of Boolean2DArrayAssert.
static AbstractByteAssert<?>	assertThat(byte actual)	Creates a new instance of ByteAssert.
static AbstractByteArrayAssert<?>	assertThat(byte[] actual)	Creates a new instance of ByteArrayAssert.
static Byte2DArrayAssert	assertThat(byte[][] actual)	Creates a new instance of Byte2DArrayAssert.
static AbstractCharacterAssert<?>	assertThat(char actual)	Creates a new instance of CharacterAssert.
static AbstractCharArrayAssert<?>	assertThat(char[] actual)	Creates a new instance of CharArrayAssert.
static Char2DArrayAssert	assertThat(char[][] actual)	Creates a new instance of Char2DArrayAssert.
static AbstractDoubleAssert<?>	assertThat(double actual)	Creates a new instance of DoubleAssert.
static AbstractDoubleArrayAssert<?>	assertThat(double[] actual)	Creates a new instance of DoubleArrayAssert.
static Double2DArrayAssert	assertThat(double[][] actual)	Creates a new instance of Double2DArrayAssert.
static AbstractFloatAssert<?>	assertThat(float actual)	Creates a new instance of FloatAssert.
static AbstractFloatArrayAssert<?>	assertThat(float[] actual)	Creates a new instance of FloatArrayAssert.
static Float2DArrayAssert	assertThat(float[][] actual)	Creates a new instance of Float2DArrayAssert.
static AbstractIntegerAssert<?>	assertThat(int actual)	Creates a new instance of IntegerAssert.
static AbstractIntArrayAssert<?>	assertThat(int[] actual)	Creates a new instance of IntArrayAssert.
static Int2DArrayAssert	assertThat(int[][] actual)	Creates a new instance of Int2DArrayAssert.
static AbstractLongAssert<?>	assertThat(long actual)	Creates a new instance of LongAssert.
static AbstractLongArrayAssert<?>	assertThat(long[] actual)	Creates a new instance of LongArrayAssert.
static Long2DArrayAssert	assertThat(long[][] actual)	Creates a new instance of Long2DArrayAssert.
static AbstractShortAssert<?>	assertThat(short actual)	Creates a new instance of ShortAssert.
static AbstractShortArrayAssert<?>	assertThat(short[] actual)	Creates a new instance of ShortArrayAssert.
static Short2DArrayAssert	assertThat(short[][] actual)	Creates a new instance of Short2DArrayAssert.
static AbstractFileAssert<?>	assertThat(File actual)	Creates a new instance of FileAssert.
static AbstractInputStreamAssert<?,? extends InputStream>	assertThat(InputStream actual)	Creates a new instance of InputStreamAssert.
static AbstractBooleanAssert<?>	assertThat(Boolean actual)	Creates a new instance of BooleanAssert.
static AbstractByteAssert<?>	assertThat(Byte actual)	Creates a new instance of ByteAssert.
static AbstractCharacterAssert<?>	assertThat(Character actual)	Creates a new instance of CharacterAssert.
static ClassAssert	assertThat(Class<?> actual)	Creates a new instance of ClassAssert.
static AbstractDoubleAssert<?>	assertThat(Double actual)	Creates a new instance of DoubleAssert.
static AbstractFloatAssert<?>	assertThat(Float actual)	Creates a new instance of FloatAssert.
static AbstractIntegerAssert<?>	assertThat(Integer actual)	Creates a new instance of IntegerAssert.
static AbstractLongAssert<?>	assertThat(Long actual)	Creates a new instance of LongAssert.
static AbstractShortAssert<?>	assertThat(Short actual)	Creates a new instance of ShortAssert.
static AbstractStringAssert<?>	assertThat(String actual)	Creates a new instance of StringAssert.
static AbstractCharSequenceAssert<?,? extends CharSequence>	assertThat(StringBuffer actual)	Creates a new instance of CharSequenceAssert from a StringBuffer.
static AbstractCharSequenceAssert<?,? extends CharSequence>	assertThat(StringBuilder actual)	Creates a new instance of CharSequenceAssert from a StringBuilder.
static AbstractBigDecimalAssert<?>	assertThat(BigDecimal actual)	Creates a new instance of BigDecimalAssert.
static AbstractUriAssert<?>	assertThat(URI actual)	Creates a new instance of UriAssert.
static AbstractUrlAssert<?>	assertThat(URL actual)	Creates a new instance of UrlAssert.
static AbstractDurationAssert<?>	assertThat(Duration duration)	Creates a new instance of DurationAssert.
static AbstractInstantAssert<?>	assertThat(Instant instant)	Creates a new instance of InstantAssert.
static AbstractLocalDateAssert<?>	assertThat(LocalDate localDate)	Creates a new instance of LocalDateAssert.
static AbstractLocalDateTimeAssert<?>	assertThat(LocalDateTime actual)	Creates a new instance of LocalDateTimeAssert.
static AbstractLocalTimeAssert<?>	assertThat(LocalTime actual)	Creates a new instance of LocalTimeAssert.
static AbstractOffsetDateTimeAssert<?>	assertThat(OffsetDateTime actual)	Creates a new instance of OffsetDateTime.
static AbstractOffsetTimeAssert<?>	assertThat(OffsetTime actual)	Create assertion for OffsetTime.
static AbstractPeriodAssert<?>	assertThat(Period period)	Creates a new instance of PeriodAssert.
static AbstractZonedDateTimeAssert<?>	assertThat(ZonedDateTime actual)	Creates a new instance of ZonedDateTimeAssert.
static <RESULT> CompletableFutureAssert<RESULT>	assertThat(CompletableFuture<RESULT> actual)	Create assertion for CompletableFuture.
static AbstractDateAssert<?>	assertThat(Date actual)	Creates a new instance of DateAssert.
static <VALUE> OptionalAssert<VALUE>	assertThat(Optional<VALUE> actual)	Create assertion for Optional.
static OptionalDoubleAssert	assertThat(OptionalDouble actual)	Create assertion for OptionalDouble.
static OptionalIntAssert	assertThat(OptionalInt actual)	Create assertion for OptionalInt.
static OptionalLongAssert	assertThat(OptionalLong actual)	Create assertion for OptionalInt.
static MatcherAssert	assertThat(Matcher actual)	Create assertion for Matcher
static <T> ObjectAssert<T>	assertThat(T actual)	Creates a new instance of ObjectAssert.
static <T> ObjectArrayAssert<T>	assertThat(T[] actual)	Creates a new instance of ObjectArrayAssert.
static <T> Object2DArrayAssert<T>	assertThat(T[][] actual)	Creates a new instance of Object2DArrayAssert.
static AbstractThrowableAssert<?,? extends Throwable>	assertThatCode(ThrowableAssert.ThrowingCallable shouldRaiseOrNotThrowable)	Allows to capture and then assert on a Throwable more easily when used with Java 8 lambdas.
static <T extends Throwable> ThrowableTypeAssert<T>	assertThatExceptionOfType(Class<? extends T> exceptionType)	Entry point to check that an exception of type T is thrown by a given throwingCallable which allows to chain assertions on the thrown exception.
static NotThrownAssert	assertThatNoException()	Entry point to check that no exception of any type is thrown by a given throwingCallable.
static AbstractThrowableAssert<?,? extends Throwable>	assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)	Allows to capture and then assert on a Throwable (easier done with lambdas).
static AbstractThrowableAssert<?,? extends Throwable>	assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable, String description, Object... args)	Allows to capture and then assert on a Throwable like assertThatThrownBy(ThrowingCallable) but this method let you set the assertion description the same way you do with as(String, Object...).
static Index	atIndex(int index)	Only delegate to Index.atIndex(int) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Index if you prefer).
static Throwable	catchThrowable(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)	Allows catching a Throwable more easily when used with Java 8 lambdas.
static <THROWABLE extends Throwable> THROWABLE	catchThrowableOfType(ThrowableAssert.ThrowingCallable shouldRaiseThrowable, Class<THROWABLE> type)	Allows catching a Throwable of a specific type.
static String	contentOf(File file)	Loads the text content of a file with the default character set, so that it can be passed to assertThat(String).
static String	contentOf(File file, String charsetName)	Loads the text content of a file, so that it can be passed to assertThat(String).
static String	contentOf(File file, Charset charset)	Loads the text content of a file, so that it can be passed to assertThat(String).
static String	contentOf(URL url)	Loads the text content of a URL with the default character set, so that it can be passed to assertThat(String).
static String	contentOf(URL url, String charsetName)	Loads the text content of a URL, so that it can be passed to assertThat(String).
static String	contentOf(URL url, Charset charset)	Loads the text content of a URL, so that it can be passed to assertThat(String).
static <T> DoesNotHave<T>	doesNotHave(Condition<? super T> condition)	Creates a new DoesNotHave.
static <K, V> MapEntry<K,V>	entry(K key, V value)	Only delegate to MapEntry.entry(Object, Object) so that Assertions offers a full feature entry point to all AssertJ features (but you can use MapEntry if you prefer).
static Properties<Object>	extractProperty(String propertyName)	Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).
static <T> Properties<T>	extractProperty(String propertyName, Class<T> propertyType)	Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).
static void	fail(String failureMessage)	Only delegate to Fail.fail(String) so that Assertions offers a full feature entry point to all Assertj Assert features (but you can use Fail if you prefer).
static void	fail(String failureMessage, Throwable realCause)	Only delegate to Fail.fail(String, Throwable) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
static void	failBecauseExceptionWasNotThrown(Class<? extends Throwable> throwableClass)	Only delegate to Fail.failBecauseExceptionWasNotThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
static <E> Filters<E>	filter(E[] array)	Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).
static <E> Filters<E>	filter(Iterable<E> iterableToFilter)	Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).
static InFilter	in(Object... values)	Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches one of the given values.
static List<String>	linesOf(File file)	Loads the text content of a file into a list of strings with the default charset, each string corresponding to a line.
static List<String>	linesOf(File file, String charsetName)	Loads the text content of a file into a list of strings, each string corresponding to a line.
static List<String>	linesOf(File file, Charset charset)	Loads the text content of a file into a list of strings, each string corresponding to a line.
static List<String>	linesOf(URL url)	Loads the text content of a URL into a list of strings with the default charset, each string corresponding to a line.
static List<String>	linesOf(URL url, String charsetName)	Loads the text content of a URL into a list of strings, each string corresponding to a line.
static List<String>	linesOf(URL url, Charset charset)	Loads the text content of a URL into a list of strings, each string corresponding to a line.
static List<String>	linesOf(Path path)	Loads the text content of a path into a list of strings with the default charset, each string corresponding to a line.
static List<String>	linesOf(Path path, String charsetName)	Loads the text content of a path into a list of strings, each string corresponding to a line.
static List<String>	linesOf(Path path, Charset charset)	Loads the text content of a path into a list of strings, each string corresponding to a line.
static NotFilter	not(Object valueNotToMatch)	Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match the given value.
static <T> Not<T>	not(Condition<? super T> condition)	Creates a new Not.
static NotInFilter	notIn(Object... valuesNotToMatch)	Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match any of the given values.
static Offset<Double>	offset(Double value)	Assertions entry point for double Offset.
static Offset<Float>	offset(Float value)	Assertions entry point for float Offset.
static void	registerCustomDateFormat(String userCustomDateFormatPattern)	Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).
static void	registerCustomDateFormat(DateFormat userCustomDateFormat)	Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).
static void	setAllowComparingPrivateFields(boolean allowComparingPrivateFields)	Globally sets whether the use of private fields is allowed for comparison.
static void	setAllowExtractingPrivateFields(boolean allowExtractingPrivateFields)	Globally sets whether IterableAssert#extracting(String) and ObjectArrayAssert#extracting(String) should be allowed to extract private fields, if not and they try it fails with exception.
static void	setLenientDateParsing(boolean value)	Instead of using default strict date/time parsing, it is possible to use lenient parsing mode for default date formats parser to interpret inputs that do not precisely match supported date formats (lenient parsing).
static void	setMaxLengthForSingleLineDescription(int maxLengthForSingleLineDescription)	In error messages, sets the threshold when iterable/array formatting will on one line (if their String description is less than this parameter) or it will be formatted with one element per line.
static void	setRemoveAssertJRelatedElementsFromStackTrace(boolean removeAssertJRelatedElementsFromStackTrace)	Only delegate to Fail.setRemoveAssertJRelatedElementsFromStackTrace(boolean) so that Assertions offers a full feature entry point to all AssertJ Assert features (but you can use Fail if you prefer).
static void	shouldHaveThrown(Class<? extends Throwable> throwableClass)	Only delegate to Fail.shouldHaveThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).
static Tuple	tuple(Object... values)	Utility method to build nicely a Tuple when working with AbstractIterableAssert.extracting(String...) or AbstractObjectArrayAssert.extracting(String...)
static void	useDefaultDateFormatsOnly()	Remove all registered custom date formats => use only the defaults date formats to parse string as date.
static Offset<Byte>	within(Byte value)	Assertions entry point for Byte Offset to use with isCloseTo assertions.
static Offset<Double>	within(Double value)	Alias for offset(Double) to use with isCloseTo assertions.
static Offset<Float>	within(Float value)	Alias for offset(Float) to use with isCloseTo assertions.
static Offset<Integer>	within(Integer value)	Assertions entry point for Integer Offset to use with isCloseTo assertions.
static Offset<Long>	within(Long value)	Assertions entry point for Long Offset to use with isCloseTo assertions.
static Offset<Short>	within(Short value)	Assertions entry point for Short Offset to use with isCloseTo assertions.
static Offset<BigDecimal>	within(BigDecimal value)	Assertions entry point for BigDecimal Offset to use with isCloseTo assertions.
static Percentage	withinPercentage(Double value)	Assertions entry point for Double Percentage to use with isCloseTo assertions for percentages.
static Percentage	withinPercentage(Integer value)	Assertions entry point for Integer Percentage to use with isCloseTo assertions for percentages.
static Percentage	withinPercentage(Long value)	Assertions entry point for Long Percentage to use with isCloseTo assertions for percentages.

Methods inherited from class java.lang.Object

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

Constructor Details

AssertionsForClassTypes

protected AssertionsForClassTypes()

Creates a new AssertionsForClassTypes.

Method Details

assertThat

public static <RESULT>
CompletableFutureAssert<RESULT> assertThat(CompletableFuture<RESULT> actual)

Create assertion for CompletableFuture.

Type Parameters:

RESULT - the type of the value contained in the CompletableFuture.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static <VALUE> OptionalAssert<VALUE> assertThat(Optional<VALUE> actual)

Create assertion for Optional.

Type Parameters:

VALUE - the type of the value contained in the Optional.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static OptionalDoubleAssert assertThat(OptionalDouble actual)

Create assertion for OptionalDouble.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static OptionalIntAssert assertThat(OptionalInt actual)

Create assertion for OptionalInt.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static MatcherAssert assertThat(Matcher actual)

Create assertion for Matcher

Parameters:

actual - the actual value

Returns:

the created assertion object

assertThat

public static OptionalLongAssert assertThat(OptionalLong actual)

Create assertion for OptionalInt.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractBigDecimalAssert<?> assertThat(BigDecimal actual)

Creates a new instance of BigDecimalAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractUriAssert<?> assertThat(URI actual)

Creates a new instance of UriAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractUrlAssert<?> assertThat(URL actual)

Creates a new instance of UrlAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractBooleanAssert<?> assertThat(boolean actual)

Creates a new instance of BooleanAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractBooleanAssert<?> assertThat(Boolean actual)

Creates a new instance of BooleanAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractBooleanArrayAssert<?> assertThat(boolean[] actual)

Creates a new instance of BooleanArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Boolean2DArrayAssert assertThat(boolean[][] actual)

Creates a new instance of Boolean2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractByteAssert<?> assertThat(byte actual)

Creates a new instance of ByteAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractByteAssert<?> assertThat(Byte actual)

Creates a new instance of ByteAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractByteArrayAssert<?> assertThat(byte[] actual)

Creates a new instance of ByteArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Byte2DArrayAssert assertThat(byte[][] actual)

Creates a new instance of Byte2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractCharacterAssert<?> assertThat(char actual)

Creates a new instance of CharacterAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractCharArrayAssert<?> assertThat(char[] actual)

Creates a new instance of CharArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Char2DArrayAssert assertThat(char[][] actual)

Creates a new instance of Char2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractCharacterAssert<?> assertThat(Character actual)

Creates a new instance of CharacterAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static ClassAssert assertThat(Class<?> actual)

Creates a new instance of ClassAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractDoubleAssert<?> assertThat(double actual)

Creates a new instance of DoubleAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractDoubleAssert<?> assertThat(Double actual)

Creates a new instance of DoubleAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractDoubleArrayAssert<?> assertThat(double[] actual)

Creates a new instance of DoubleArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Double2DArrayAssert assertThat(double[][] actual)

Creates a new instance of Double2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractFileAssert<?> assertThat(File actual)

Creates a new instance of FileAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractInputStreamAssert<?,? extends InputStream> assertThat(InputStream actual)

Creates a new instance of InputStreamAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractFloatAssert<?> assertThat(float actual)

Creates a new instance of FloatAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractFloatAssert<?> assertThat(Float actual)

Creates a new instance of FloatAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractFloatArrayAssert<?> assertThat(float[] actual)

Creates a new instance of FloatArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Float2DArrayAssert assertThat(float[][] actual)

Creates a new instance of Float2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractIntegerAssert<?> assertThat(int actual)

Creates a new instance of IntegerAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractIntArrayAssert<?> assertThat(int[] actual)

Creates a new instance of IntArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Int2DArrayAssert assertThat(int[][] actual)

Creates a new instance of Int2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractIntegerAssert<?> assertThat(Integer actual)

Creates a new instance of IntegerAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLongAssert<?> assertThat(long actual)

Creates a new instance of LongAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLongAssert<?> assertThat(Long actual)

Creates a new instance of LongAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLongArrayAssert<?> assertThat(long[] actual)

Creates a new instance of LongArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Long2DArrayAssert assertThat(long[][] actual)

Creates a new instance of Long2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static <T> ObjectAssert<T> assertThat(T actual)

Creates a new instance of ObjectAssert.

Type Parameters:

T - the actual value type.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static <T> ObjectArrayAssert<T> assertThat(T[] actual)

Creates a new instance of ObjectArrayAssert.

Type Parameters:

T - the actual elements type.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static <T> Object2DArrayAssert<T> assertThat(T[][] actual)

Creates a new instance of Object2DArrayAssert.

Type Parameters:

T - the actual elements type.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractShortAssert<?> assertThat(short actual)

Creates a new instance of ShortAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractShortAssert<?> assertThat(Short actual)

Creates a new instance of ShortAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractShortArrayAssert<?> assertThat(short[] actual)

Creates a new instance of ShortArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static Short2DArrayAssert assertThat(short[][] actual)

Creates a new instance of Short2DArrayAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static AbstractCharSequenceAssert<?,? extends CharSequence> assertThat(StringBuilder actual)

Creates a new instance of CharSequenceAssert from a StringBuilder.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.11.0

assertThat

public static AbstractCharSequenceAssert<?,? extends CharSequence> assertThat(StringBuffer actual)

Creates a new instance of CharSequenceAssert from a StringBuffer.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

Since:

3.11.0

assertThat

public static AbstractStringAssert<?> assertThat(String actual)

Creates a new instance of StringAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractDateAssert<?> assertThat(Date actual)

Creates a new instance of DateAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractZonedDateTimeAssert<?> assertThat(ZonedDateTime actual)

Creates a new instance of ZonedDateTimeAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLocalDateTimeAssert<?> assertThat(LocalDateTime actual)

Creates a new instance of LocalDateTimeAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractOffsetDateTimeAssert<?> assertThat(OffsetDateTime actual)

Creates a new instance of OffsetDateTime.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractOffsetTimeAssert<?> assertThat(OffsetTime actual)

Create assertion for OffsetTime.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLocalTimeAssert<?> assertThat(LocalTime actual)

Creates a new instance of LocalTimeAssert.

Parameters:

actual - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractLocalDateAssert<?> assertThat(LocalDate localDate)

Creates a new instance of LocalDateAssert.

Parameters:

localDate - the actual value.

Returns:

the created assertion object.

assertThat

public static AbstractInstantAssert<?> assertThat(Instant instant)

Creates a new instance of InstantAssert.

Parameters:

instant - the actual value.

Returns:

the created assertion object.

Since:

3.7.0

assertThat

public static AbstractDurationAssert<?> assertThat(Duration duration)

Creates a new instance of DurationAssert.

Parameters:

duration - the actual value.

Returns:

the created assertion object.

Since:

3.15.0

assertThat

public static AbstractPeriodAssert<?> assertThat(Period period)

Creates a new instance of PeriodAssert.

Parameters:

period - the actual value.

Returns:

the created assertion object.

Since:

3.17.0

assertThat

public static <T extends Throwable>
AbstractThrowableAssert<?,T> assertThat(T actual)

Creates a new instance of ThrowableAssert.

Type Parameters:

T - the type of the actual throwable.

Parameters:

actual - the actual value.

Returns:

the created ThrowableAssert.

assertThatThrownBy

public static AbstractThrowableAssert<?,? extends Throwable> assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)

Allows to capture and then assert on a Throwable (easier done with lambdas).

Java 8 example :

 @Test
  public void testException() {
    assertThatThrownBy(() -> { throw new Exception("boom!") }).isInstanceOf(Exception.class)
                                                              .hasMessageContaining("boom");
 }

If the provided ThrowableAssert.ThrowingCallable does not raise an exception, an error is immediately thrown, in that case the test description provided with as(String, Object...) is not honored.
To use a test description, use catchThrowable(ThrowableAssert.ThrowingCallable) as shown below:

 // assertion will fail but "display me" won't appear in the error
 assertThatThrownBy(() -> {}).as("display me")
                             .isInstanceOf(Exception.class);

 // assertion will fail AND "display me" will appear in the error
 Throwable thrown = catchThrowable(() -> {});
 assertThat(thrown).as("display me")
                   .isInstanceOf(Exception.class);

Alternatively you can also use assertThatCode(ThrowingCallable) for the test description provided with as(String, Object...) to always be honored.

Parameters:

shouldRaiseThrowable - The ThrowableAssert.ThrowingCallable or lambda with the code that should raise the throwable.

Returns:

the created ThrowableAssert.

assertThatThrownBy

public static AbstractThrowableAssert<?,? extends Throwable> assertThatThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable,
 String description,
 Object... args)

Allows to capture and then assert on a Throwable like assertThatThrownBy(ThrowingCallable) but this method let you set the assertion description the same way you do with as(String, Object...).

Example:

 @Test
  public void testException() {
    // if this assertion failed (but it doesn't), the error message would start with [Test explosive code]
    assertThatThrownBy(() -> { throw new IOException("boom!") }, "Test explosive code")
             .isInstanceOf(IOException.class)
             .hasMessageContaining("boom");
 }

If the provided ThrowingCallable does not raise an exception, an error is immediately thrown.

The test description provided is honored but not the one with as(String, Object...), example:

 // assertion will fail but "display me" won't appear in the error message
 assertThatThrownBy(() -> {}).as("display me")
                             .isInstanceOf(Exception.class);

 // assertion will fail AND "display me" will appear in the error message
 assertThatThrownBy(() -> {}, "display me")
                             .isInstanceOf(Exception.class);

Parameters:

shouldRaiseThrowable - The ThrowableAssert.ThrowingCallable or lambda with the code that should raise the throwable.

description - the new description to set.

args - optional parameter if description is a format String.

Returns:

the created ThrowableAssert.

Since:

3.9.0

assertThatExceptionOfType

public static <T extends Throwable>
ThrowableTypeAssert<T> assertThatExceptionOfType(Class<? extends T> exceptionType)

Entry point to check that an exception of type T is thrown by a given throwingCallable which allows to chain assertions on the thrown exception.

Example:

 assertThatExceptionOfType(IOException.class)
              .isThrownBy(() -> { throw new IOException("boom!"); })
              .withMessage("boom!"); 

This method is more or less the same of assertThatThrownBy(ThrowableAssert.ThrowingCallable) but in a more natural way.

Type Parameters:

T - the exception type.

Parameters:

exceptionType - the class of exception type.

Returns:

the created ThrowableTypeAssert.

assertThatNoException

public static NotThrownAssert assertThatNoException()

Entry point to check that no exception of any type is thrown by a given throwingCallable.

Example:

assertThatNoException().isThrownBy(() -> { System.out.println("OK"); });

This method is more or less the same of assertThatCode(...).doesNotThrowAnyException(); but in a more natural way.

Returns:

the created NotThrownAssert.

Since:

3.17.0

assertThatCode

public static AbstractThrowableAssert<?,? extends Throwable> assertThatCode(ThrowableAssert.ThrowingCallable shouldRaiseOrNotThrowable)

Allows to capture and then assert on a Throwable more easily when used with Java 8 lambdas.

Example :

 ThrowingCallable callable = () -> {
   throw new Exception("boom!");
 };

 // assertion succeeds
 assertThatCode(callable).isInstanceOf(Exception.class)
                         .hasMessageContaining("boom");

 // assertion fails
 assertThatCode(callable).doesNotThrowAnyException();

If the provided ThrowableAssert.ThrowingCallable does not validate against next assertions, an error is immediately raised, in that case the test description provided with as(String, Object...) is not honored.
To use a test description, use catchThrowable(ThrowableAssert.ThrowingCallable) as shown below.

 ThrowingCallable doNothing = () -> {
   // do nothing
 };

 // assertion fails and "display me" appears in the assertion error
 assertThatCode(doNothing).as("display me")
                          .isInstanceOf(Exception.class);

 // assertion will fail AND "display me" will appear in the error
 Throwable thrown = catchThrowable(doNothing);
 assertThatCode(thrown).as("display me")
                       .isInstanceOf(Exception.class); 

This method was not named assertThat because the java compiler reported it ambiguous when used directly with a lambda :(

Parameters:

shouldRaiseOrNotThrowable - The ThrowableAssert.ThrowingCallable or lambda with the code that should raise the throwable.

Returns:

The captured exception or null if none was raised by the callable.

Since:

3.7.0

catchThrowable

public static Throwable catchThrowable(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)

Allows catching a Throwable more easily when used with Java 8 lambdas.

This caught Throwable can then be asserted.

Example:

@Test
 public void testException() {
   // when
   Throwable thrown = catchThrowable(() -> { throw new Exception("boom!"); });

   // then
   assertThat(thrown).isInstanceOf(Exception.class)
                     .hasMessageContaining("boom");
 } 

Parameters:

shouldRaiseThrowable - The lambda with the code that should raise the exception.

Returns:

The captured exception or null if none was raised by the callable.

See Also:

• catchThrowableOfType(ThrowableAssert.ThrowingCallable, Class)

catchThrowableOfType

public static <THROWABLE extends Throwable>
THROWABLE catchThrowableOfType(ThrowableAssert.ThrowingCallable shouldRaiseThrowable,
 Class<THROWABLE> type)

Allows catching a Throwable of a specific type.

A call is made to catchThrowable(ThrowingCallable), if no exception is thrown catchThrowableOfType returns null, otherwise it checks that the caught Throwable has the specified type then casts it to it before returning it, making it convenient to perform subtype-specific assertions on the result.

Example:

 class CustomParseException extends Exception {
   int line;
   int column;

   public CustomParseException(String msg, int l, int c) {
     super(msg);
     line = l;
     column = c;
   }
 }

 CustomParseException e = catchThrowableOfType(() -> { throw new CustomParseException("boom!", 1, 5); },
                                               CustomParseException.class);
 // assertions pass
 assertThat(e).hasMessageContaining("boom");
 assertThat(e.line).isEqualTo(1);
 assertThat(e.column).isEqualTo(5);

 // fails as CustomParseException is not a RuntimeException
 catchThrowableOfType(() -> { throw new CustomParseException("boom!", 1, 5); },
                      RuntimeException.class);

Type Parameters:

THROWABLE - the Throwable type.

Parameters:

shouldRaiseThrowable - The lambda with the code that should raise the exception.

type - The type of exception that the code is expected to raise.

Returns:

The captured exception or null if none was raised by the callable.

Since:

3.9.0

See Also:

• catchThrowable(ThrowableAssert.ThrowingCallable)

setRemoveAssertJRelatedElementsFromStackTrace

public static void setRemoveAssertJRelatedElementsFromStackTrace(boolean removeAssertJRelatedElementsFromStackTrace)

Only delegate to Fail.setRemoveAssertJRelatedElementsFromStackTrace(boolean) so that Assertions offers a full feature entry point to all AssertJ Assert features (but you can use Fail if you prefer).

Parameters:

removeAssertJRelatedElementsFromStackTrace - flag.

fail

public static void fail(String failureMessage)

Only delegate to Fail.fail(String) so that Assertions offers a full feature entry point to all Assertj Assert features (but you can use Fail if you prefer).

Parameters:

failureMessage - error message.

Throws:

AssertionError - with the given message.

fail

public static void fail(String failureMessage,
 Throwable realCause)

Only delegate to Fail.fail(String, Throwable) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).

Parameters:

failureMessage - the description of the failed assertion. It can be null.

realCause - cause of the error.

Throws:

AssertionError - with the given message and with the Throwable that caused the failure.

failBecauseExceptionWasNotThrown

public static void failBecauseExceptionWasNotThrown(Class<? extends Throwable> throwableClass)

Only delegate to Fail.failBecauseExceptionWasNotThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer). Assertions.shouldHaveThrown(Class) can be used as a replacement.

Parameters:

throwableClass - the Throwable class that was expected to be thrown.

Throws:

AssertionError - with a message explaining that a Throwable of given class was expected to be thrown but had not been.

shouldHaveThrown

public static void shouldHaveThrown(Class<? extends Throwable> throwableClass)

Only delegate to Fail.shouldHaveThrown(Class) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Fail if you prefer).

Parameters:

throwableClass - the Throwable class that was expected to be thrown.

Throws:

AssertionError - with a message explaining that a Throwable of given class was expected to be thrown but had not been.

setMaxLengthForSingleLineDescription

public static void setMaxLengthForSingleLineDescription(int maxLengthForSingleLineDescription)

In error messages, sets the threshold when iterable/array formatting will on one line (if their String description is less than this parameter) or it will be formatted with one element per line.

The following array will be formatted on one line as its length < 80

 String[] greatBooks = array("A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice");

 // formatted as:

 ["A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice"]

whereas this array is formatted on multiple lines (one element per line)

 String[] greatBooks = array("A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice", "Guards! Guards! (Discworld)");

 // formatted as:

 ["A Game of Thrones",
  "The Lord of the Rings",
  "Assassin's Apprentice",
  "Guards! Guards! (Discworld)"]

Parameters:

maxLengthForSingleLineDescription - the maximum length for an iterable/array to be displayed on one line

extractProperty

public static <T> Properties<T> extractProperty(String propertyName,
 Class<T> propertyType)

Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).

Typical usage is to chain extractProperty with from method, see examples below :

 // extract simple property values having a java standard type (here String)
 assertThat(extractProperty("name", String.class).from(fellowshipOfTheRing))
           .contains("Boromir", "Gandalf", "Frodo", "Legolas")
           .doesNotContain("Sauron", "Elrond");

 // extracting property works also with user's types (here Race)
 assertThat(extractProperty("race", String.class).from(fellowshipOfTheRing))
           .contains(HOBBIT, ELF).doesNotContain(ORC);

 // extract nested property on Race
 assertThat(extractProperty("race.name", String.class).from(fellowshipOfTheRing))
           .contains("Hobbit", "Elf")
           .doesNotContain("Orc");

Type Parameters:

T - the type of value to extract.

Parameters:

propertyName - the name of the property to be read from the elements of a Iterable. It may be a nested property (e.g. "address.street.number").

propertyType - the type of property to extract

Returns:

the created Properties.

Throws:

NullPointerException - if the given property name is null.

IllegalArgumentException - if the given property name is empty.

extractProperty

public static Properties<Object> extractProperty(String propertyName)

Only delegate to Properties.extractProperty(String) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Properties if you prefer).

Typical usage is to chain extractProperty with from method, see examples below :

 // extract simple property values, as no type has been defined the extracted property will be considered as Object
 // to define the real property type (here String) use extractProperty("name", String.class) instead.
 assertThat(extractProperty("name").from(fellowshipOfTheRing))
           .contains("Boromir", "Gandalf", "Frodo", "Legolas")
           .doesNotContain("Sauron", "Elrond");

 // extracting property works also with user's types (here Race), even though it will be considered as Object
 // to define the real property type (here String) use extractProperty("name", Race.class) instead.
 assertThat(extractProperty("race").from(fellowshipOfTheRing)).contains(HOBBIT, ELF).doesNotContain(ORC);

 // extract nested property on Race
 assertThat(extractProperty("race.name").from(fellowshipOfTheRing)).contains("Hobbit", "Elf").doesNotContain("Orc"); 

Parameters:

propertyName - the name of the property to be read from the elements of a Iterable. It may be a nested property (e.g. "address.street.number").

Returns:

the created Properties.

Throws:

NullPointerException - if the given property name is null.

IllegalArgumentException - if the given property name is empty.

tuple

public static Tuple tuple(Object... values)

Utility method to build nicely a Tuple when working with AbstractIterableAssert.extracting(String...) or AbstractObjectArrayAssert.extracting(String...)

Parameters:

values - the values stored in the Tuple

Returns:

the built Tuple

setAllowExtractingPrivateFields

public static void setAllowExtractingPrivateFields(boolean allowExtractingPrivateFields)

Globally sets whether IterableAssert#extracting(String) and ObjectArrayAssert#extracting(String) should be allowed to extract private fields, if not and they try it fails with exception.

Parameters:

allowExtractingPrivateFields - allow private fields extraction. Default true.

setAllowComparingPrivateFields

public static void setAllowComparingPrivateFields(boolean allowComparingPrivateFields)

Globally sets whether the use of private fields is allowed for comparison. The following (incomplete) list of methods will be impacted by this change :

• AbstractIterableAssert.usingElementComparatorOnFields(java.lang.String...)
• AbstractObjectAssert.isEqualToComparingFieldByField(Object)

If the value is false and these methods try to compare private fields, it will fail with an exception.

Parameters:

allowComparingPrivateFields - allow private fields comparison. Default true.

entry

public static <K,
V> MapEntry<K,V> entry(K key,
 V value)

Only delegate to MapEntry.entry(Object, Object) so that Assertions offers a full feature entry point to all AssertJ features (but you can use MapEntry if you prefer).

Typical usage is to call entry in MapAssert contains assertion, see examples below :

 Map<Ring, TolkienCharacter> ringBearers = ... // init omitted

 assertThat(ringBearers).contains(entry(oneRing, frodo), entry(nenya, galadriel));

Type Parameters:

K - the type of the key of this entry.

V - the type of the value of this entry.

Parameters:

key - the key of the entry to create.

value - the value of the entry to create.

Returns:

the created MapEntry.

atIndex

public static Index atIndex(int index)

Only delegate to Index.atIndex(int) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Index if you prefer).

Typical usage :

 List<Ring> elvesRings = newArrayList(vilya, nenya, narya);
 assertThat(elvesRings).contains(vilya, atIndex(0)).contains(nenya, atIndex(1)).contains(narya, atIndex(2));

Parameters:

index - the value of the index.

Returns:

the created Index.

Throws:

IllegalArgumentException - if the given value is negative.

offset

public static Offset<Double> offset(Double value)

Assertions entry point for double Offset.

Typical usage :

 assertThat(8.1).isEqualTo(8.0, offset(0.1));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

offset

public static Offset<Float> offset(Float value)

Assertions entry point for float Offset.

Typical usage :

 assertThat(8.2f).isCloseTo(8.0f, offset(0.2f));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Double> within(Double value)

Alias for offset(Double) to use with isCloseTo assertions.

Typical usage :

 assertThat(8.1).isCloseTo(8.0, within(0.1));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Float> within(Float value)

Alias for offset(Float) to use with isCloseTo assertions.

Typical usage :

 assertThat(8.2f).isCloseTo(8.0f, within(0.2f));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<BigDecimal> within(BigDecimal value)

Assertions entry point for BigDecimal Offset to use with isCloseTo assertions.

Typical usage :

 assertThat(BigDecimal.TEN).isCloseTo(new BigDecimal("10.5"), within(BigDecimal.ONE));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Byte> within(Byte value)

Assertions entry point for Byte Offset to use with isCloseTo assertions.

Typical usage :

 assertThat((byte)10).isCloseTo((byte)11, within((byte)1));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Integer> within(Integer value)

Assertions entry point for Integer Offset to use with isCloseTo assertions.

Typical usage :

 assertThat(10).isCloseTo(11, within(1));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Short> within(Short value)

Assertions entry point for Short Offset to use with isCloseTo assertions.

Typical usage :

 assertThat(10).isCloseTo(11, within(1));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

within

public static Offset<Long> within(Long value)

Assertions entry point for Long Offset to use with isCloseTo assertions.

Typical usage :

 assertThat(5l).isCloseTo(7l, within(2l));

Parameters:

value - the value of the offset.

Returns:

the created Offset.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

withinPercentage

public static Percentage withinPercentage(Double value)

Assertions entry point for Double Percentage to use with isCloseTo assertions for percentages.

Typical usage :

 assertThat(11.0).isCloseTo(10.0, withinPercentage(10.0));

Parameters:

value - the value of the percentage.

Returns:

the created Percentage.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

withinPercentage

public static Percentage withinPercentage(Integer value)

Assertions entry point for Integer Percentage to use with isCloseTo assertions for percentages.

Typical usage :

 assertThat(11).isCloseTo(10, withinPercentage(10));

Parameters:

value - the value of the percentage.

Returns:

the created Percentage.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

withinPercentage

public static Percentage withinPercentage(Long value)

Assertions entry point for Long Percentage to use with isCloseTo assertions for percentages.

Typical usage :

 assertThat(11L).isCloseTo(10L, withinPercentage(10L));

Parameters:

value - the value of the percentage.

Returns:

the created Percentage.

Throws:

NullPointerException - if the given value is null.

IllegalArgumentException - if the given value is negative.

allOf

@SafeVarargs
public static <T> Condition<T> allOf(Condition<? super T>... conditions)

Creates a new AllOf

Type Parameters:

T - the type of object the given condition accept.

Parameters:

conditions - the conditions to evaluate.

Returns:

the created AnyOf.

Throws:

NullPointerException - if the given array is null.

NullPointerException - if any of the elements in the given array is null.

allOf

public static <T> Condition<T> allOf(Iterable<? extends Condition<? super T>> conditions)

Creates a new AllOf

Type Parameters:

T - the type of object the given condition accept.

Parameters:

conditions - the conditions to evaluate.

Returns:

the created AnyOf.

Throws:

NullPointerException - if the given iterable is null.

NullPointerException - if any of the elements in the given iterable is null.

anyOf

@SafeVarargs
public static <T> Condition<T> anyOf(Condition<? super T>... conditions)

Only delegate to AnyOf.anyOf(Condition...) so that Assertions offers a full feature entry point to all AssertJ features (but you can use AnyOf if you prefer).

Typical usage (jedi and sith are Condition) :

 assertThat("Vader").is(anyOf(jedi, sith));

Type Parameters:

T - the type of object the given condition accept.

Parameters:

conditions - the conditions to evaluate.

Returns:

the created AnyOf.

Throws:

NullPointerException - if the given array is null.

NullPointerException - if any of the elements in the given array is null.

anyOf

public static <T> Condition<T> anyOf(Iterable<? extends Condition<? super T>> conditions)

Creates a new AnyOf

Type Parameters:

T - the type of object the given condition accept.

Parameters:

conditions - the conditions to evaluate.

Returns:

the created AnyOf.

Throws:

NullPointerException - if the given iterable is null.

NullPointerException - if any of the elements in the given iterable is null.

doesNotHave

public static <T> DoesNotHave<T> doesNotHave(Condition<? super T> condition)

Creates a new DoesNotHave.

Type Parameters:

T - the type of object the given condition accept.

Parameters:

condition - the condition to inverse.

Returns:

The Not condition created.

not

public static <T> Not<T> not(Condition<? super T> condition)

Creates a new Not.

Type Parameters:

T - the type of object the given condition accept.

Parameters:

condition - the condition to inverse.

Returns:

The Not condition created.

filter

public static <E> Filters<E> filter(E[] array)

Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).

Note that the given array is not modified, the filters are performed on an Iterable copy of the array.

Typical usage with Condition :

 assertThat(filter(players).being(potentialMVP).get()).containsOnly(james, rose);

and with filter language based on java bean property :

 assertThat(filter(players).with("pointsPerGame").greaterThan(20).and("assistsPerGame").greaterThan(7).get())
           .containsOnly(james, rose);

Type Parameters:

E - the array elements type.

Parameters:

array - the array to filter.

Returns:

the created Filters.

Throws:

NullPointerException - if the given array is null.

filter

public static <E> Filters<E> filter(Iterable<E> iterableToFilter)

Only delegate to Filters.filter(Object[]) so that Assertions offers a full feature entry point to all AssertJ features (but you can use Filters if you prefer).

Note that the given Iterable is not modified, the filters are performed on a copy.

Typical usage with Condition :

 assertThat(filter(players).being(potentialMVP).get()).containsOnly(james, rose);

and with filter language based on java bean property :

 assertThat(filter(players).with("pointsPerGame").greaterThan(20)
                           .and("assistsPerGame").greaterThan(7).get())
           .containsOnly(james, rose);

Type Parameters:

E - the iterable elements type.

Parameters:

iterableToFilter - the iterable to filter.

Returns:

the created Filters.

Throws:

NullPointerException - if the given array is null.

in

public static InFilter in(Object... values)

Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches one of the given values.

As often, an example helps:

 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);

 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);

 assertThat(employees).filteredOn("age", in(800, 26))
                      .containsOnly(yoda, obiwan, luke);

Parameters:

values - values to match (one match is sufficient)

Returns:

the created "in" filter

notIn

public static NotInFilter notIn(Object... valuesNotToMatch)

Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match any of the given values.

As often, an example helps:

 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);

 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);

 assertThat(employees).filteredOn("age", notIn(800, 50))
                      .containsOnly(luke);

Parameters:

valuesNotToMatch - values not to match (none of the values must match)

Returns:

the created "not in" filter

not

public static NotFilter not(Object valueNotToMatch)

Create a FilterOperator to use in filteredOn(String, FilterOperation) to express a filter keeping all Iterable elements whose property/field value matches does not match the given value.

As often, an example helps:

 Employee yoda   = new Employee(1L, new Name("Yoda"), 800);
 Employee obiwan = new Employee(2L, new Name("Obiwan"), 800);
 Employee luke   = new Employee(3L, new Name("Luke", "Skywalker"), 26);
 Employee noname = new Employee(4L, null, 50);

 List<Employee> employees = newArrayList(yoda, luke, obiwan, noname);

 assertThat(employees).filteredOn("age", not(800))
                      .containsOnly(luke, noname);

Parameters:

valueNotToMatch - the value not to match

Returns:

the created "not" filter

contentOf

public static String contentOf(File file,
 Charset charset)

Loads the text content of a file, so that it can be passed to assertThat(String).

Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).

Parameters:

file - the file.

charset - the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

contentOf

public static String contentOf(File file,
 String charsetName)

Loads the text content of a file, so that it can be passed to assertThat(String).

Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).

Parameters:

file - the file.

charsetName - the name of the character set to use.

Returns:

the content of the file.

Throws:

IllegalArgumentException - if the given character set is not supported on this platform.

UncheckedIOException - if an I/O exception occurs.

contentOf

public static String contentOf(File file)

Loads the text content of a file with the default character set, so that it can be passed to assertThat(String).

Note that this will load the entire file in memory; for larger files, there might be a more efficient alternative with assertThat(File).

Parameters:

file - the file.

Returns:

the content of the file.

Throws:

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(File file)

Loads the text content of a file into a list of strings with the default charset, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

file - the file.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(File file,
 Charset charset)

Loads the text content of a file into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

file - the file.

charset - the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(File file,
 String charsetName)

Loads the text content of a file into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

file - the file.

charsetName - the name of the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(Path path)

Loads the text content of a path into a list of strings with the default charset, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

path - the path.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

Since:

3.23.0

linesOf

public static List<String> linesOf(Path path,
 Charset charset)

Loads the text content of a path into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

path - the path.

charset - the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

Since:

3.23.0

linesOf

public static List<String> linesOf(Path path,
 String charsetName)

Loads the text content of a path into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

path - the path.

charsetName - the name of the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

Since:

3.23.0

contentOf

public static String contentOf(URL url,
 Charset charset)

Loads the text content of a URL, so that it can be passed to assertThat(String).

Note that this will load the entire contents in memory.

Parameters:

url - the URL.

charset - the character set to use.

Returns:

the content of the URL.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

contentOf

public static String contentOf(URL url,
 String charsetName)

Loads the text content of a URL, so that it can be passed to assertThat(String).

Note that this will load the entire contents in memory.

Parameters:

url - the URL.

charsetName - the name of the character set to use.

Returns:

the content of the URL.

Throws:

IllegalArgumentException - if the given character set is not supported on this platform.

UncheckedIOException - if an I/O exception occurs.

contentOf

public static String contentOf(URL url)

Loads the text content of a URL with the default character set, so that it can be passed to assertThat(String).

Note that this will load the entire file in memory; for larger files.

Parameters:

url - the URL.

Returns:

the content of the file.

Throws:

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(URL url)

Loads the text content of a URL into a list of strings with the default charset, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

url - the URL.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(URL url,
 Charset charset)

Loads the text content of a URL into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

url - the URL.

charset - the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

linesOf

public static List<String> linesOf(URL url,
 String charsetName)

Loads the text content of a URL into a list of strings, each string corresponding to a line. The line endings are either \n, \r or \r\n.

Parameters:

url - the URL.

charsetName - the name of the character set to use.

Returns:

the content of the file.

Throws:

NullPointerException - if the given charset is null.

UncheckedIOException - if an I/O exception occurs.

setLenientDateParsing

public static void setLenientDateParsing(boolean value)

Instead of using default strict date/time parsing, it is possible to use lenient parsing mode for default date formats parser to interpret inputs that do not precisely match supported date formats (lenient parsing).

With strict parsing, inputs must match exactly date/time format.

Example:

 final Date date = Dates.parse("2001-02-03");
 final Date dateTime = parseDatetime("2001-02-03T04:05:06");
 final Date dateTimeWithMs = parseDatetimeWithMs("2001-02-03T04:05:06.700");

 Assertions.setLenientDateParsing(true);

 // assertions will pass
 assertThat(date).isEqualTo("2001-01-34");
 assertThat(date).isEqualTo("2001-02-02T24:00:00");
 assertThat(date).isEqualTo("2001-02-04T-24:00:00.000");
 assertThat(dateTime).isEqualTo("2001-02-03T04:05:05.1000");
 assertThat(dateTime).isEqualTo("2001-02-03T04:04:66");
 assertThat(dateTimeWithMs).isEqualTo("2001-02-03T04:05:07.-300");

 // assertions will fail
 assertThat(date).hasSameTimeAs("2001-02-04"); // different date
 assertThat(dateTime).hasSameTimeAs("2001-02-03 04:05:06"); // leniency does not help here

To revert to default strict date parsing, call setLenientDateParsing(false).

Parameters:

value - whether lenient parsing mode should be enabled or not

registerCustomDateFormat

public static void registerCustomDateFormat(DateFormat userCustomDateFormat)

Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).

User date formats are used before default ones in the order they have been registered (first registered, first used).

AssertJ is gonna use any date formats registered with one of these methods :

• AbstractDateAssert.withDateFormat(String)
• AbstractDateAssert.withDateFormat(java.text.DateFormat)
• registerCustomDateFormat(java.text.DateFormat)
• registerCustomDateFormat(String)

Beware that AssertJ will use the newly registered format for all remaining Date assertions in the test suite

To revert to default formats only, call useDefaultDateFormatsOnly() or AbstractDateAssert.withDefaultDateFormatsOnly().

Code examples:

 Date date = ... // set to 2003 April the 26th
 assertThat(date).isEqualTo("2003-04-26");

 try {
   // date with a custom format : failure since the default formats don't match.
   assertThat(date).isEqualTo("2003/04/26");
 } catch (AssertionError e) {
   assertThat(e).hasMessage("Failed to parse 2003/04/26 with any of these date formats: " +
                            "[yyyy-MM-dd'T'HH:mm:ss.SSS, yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd]");
 }

 // registering a custom date format to make the assertion pass
 registerCustomDateFormat(new SimpleDateFormat("yyyy/MM/dd")); // registerCustomDateFormat("yyyy/MM/dd") would work to.
 assertThat(date).isEqualTo("2003/04/26");

 // the default formats are still available and should work
 assertThat(date).isEqualTo("2003-04-26");

Parameters:

userCustomDateFormat - the new Date format used for String based Date assertions.

registerCustomDateFormat

public static void registerCustomDateFormat(String userCustomDateFormatPattern)

Add the given date format to the ones used to parse date String in String based Date assertions like AbstractDateAssert.isEqualTo(String).

User date formats are used before default ones in the order they have been registered (first registered, first used).

AssertJ is gonna use any date formats registered with one of these methods :

• AbstractDateAssert.withDateFormat(String)
• AbstractDateAssert.withDateFormat(java.text.DateFormat)
• registerCustomDateFormat(java.text.DateFormat)
• registerCustomDateFormat(String)

Beware that AssertJ will use the newly registered format for all remaining Date assertions in the test suite

To revert to default formats only, call useDefaultDateFormatsOnly() or AbstractDateAssert.withDefaultDateFormatsOnly().

Code examples:

 Date date = ... // set to 2003 April the 26th
 assertThat(date).isEqualTo("2003-04-26");

 try {
   // date with a custom format : failure since the default formats don't match.
   assertThat(date).isEqualTo("2003/04/26");
 } catch (AssertionError e) {
   assertThat(e).hasMessage("Failed to parse 2003/04/26 with any of these date formats: " +
                            "[yyyy-MM-dd'T'HH:mm:ss.SSS, yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd]");
 }

 // registering a custom date format to make the assertion pass
 registerCustomDateFormat("yyyy/MM/dd");
 assertThat(date).isEqualTo("2003/04/26");

 // the default formats are still available and should work
 assertThat(date).isEqualTo("2003-04-26");

Parameters:

userCustomDateFormatPattern - the new Date format pattern used for String based Date assertions.

useDefaultDateFormatsOnly

public static void useDefaultDateFormatsOnly()

Remove all registered custom date formats => use only the defaults date formats to parse string as date.

Beware that the default formats are expressed in the current local timezone.

Defaults date format are:

• yyyy-MM-dd'T'HH:mm:ss.SSS
• yyyy-MM-dd HH:mm:ss.SSS (for Timestamp String representation support)
• yyyy-MM-dd'T'HH:mm:ss
• yyyy-MM-dd

Example of valid string date representations:

• 2003-04-26T03:01:02.999
• 2003-04-26 03:01:02.999
• 2003-04-26T13:01:02
• 2003-04-26