Class Java6BDDAssertions
- Since:
- 2.5.0 / 3.5.0
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic AbstractBooleanAssert<?> then(boolean actual) Deprecated.Creates a new instance of.BooleanAssertstatic AbstractBooleanArrayAssert<?> then(boolean[] actual) Deprecated.Creates a new instance of.BooleanArrayAssertstatic Boolean2DArrayAssertthen(boolean[][] actual) Deprecated.Creates a new instance of.Boolean2DArrayAssertstatic AbstractByteAssert<?> then(byte actual) Deprecated.Creates a new instance of.ByteAssertstatic AbstractByteArrayAssert<?> then(byte[] actual) Deprecated.Creates a new instance of.ByteArrayAssertstatic Byte2DArrayAssertthen(byte[][] actual) Deprecated.Creates a new instance of.Byte2DArrayAssertstatic AbstractCharacterAssert<?> then(char actual) Deprecated.Creates a new instance of.CharacterAssertstatic AbstractCharArrayAssert<?> then(char[] actual) Deprecated.Creates a new instance of.CharArrayAssertstatic Char2DArrayAssertthen(char[][] actual) Deprecated.Creates a new instance of.Char2DArrayAssertstatic AbstractDoubleAssert<?> then(double actual) Deprecated.Creates a new instance of.DoubleAssertstatic AbstractDoubleArrayAssert<?> then(double[] actual) Deprecated.Creates a new instance of.DoubleArrayAssertstatic Double2DArrayAssertthen(double[][] actual) Deprecated.Creates a new instance of.Double2DArrayAssertstatic AbstractFloatAssert<?> then(float actual) Deprecated.Creates a new instance of.FloatAssertstatic AbstractFloatArrayAssert<?> then(float[] actual) Deprecated.Creates a new instance of.FloatArrayAssertstatic Float2DArrayAssertthen(float[][] actual) Deprecated.Creates a new instance of.Float2DArrayAssertstatic AbstractIntegerAssert<?> then(int actual) Deprecated.Creates a new instance of.IntegerAssertstatic AbstractIntArrayAssert<?> then(int[] actual) Deprecated.Creates a new instance of.IntArrayAssertstatic Int2DArrayAssertthen(int[][] actual) Deprecated.Creates a new instance of.Int2DArrayAssertstatic AbstractLongAssert<?> then(long actual) Deprecated.Creates a new instance of.LongAssertstatic AbstractLongArrayAssert<?> then(long[] actual) Deprecated.Creates a new instance of.LongArrayAssertstatic Long2DArrayAssertthen(long[][] actual) Deprecated.Creates a new instance of.Long2DArrayAssertstatic AbstractShortAssert<?> then(short actual) Deprecated.Creates a new instance of.ShortAssertstatic AbstractShortArrayAssert<?> then(short[] actual) Deprecated.Creates a new instance of.ShortArrayAssertstatic Short2DArrayAssertthen(short[][] actual) Deprecated.Creates a new instance of.Short2DArrayAssertstatic <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT, ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>>
ClassBasedNavigableIterableAssert<?, ACTUAL, ELEMENT, ELEMENT_ASSERT> Deprecated.This was added to help creating type-specific assertions for the elements of anIterableinstance.static AbstractFileAssert<?> Deprecated.Creates a new instance of.FileAssertstatic AbstractInputStreamAssert<?, ? extends InputStream> then(InputStream actual) Deprecated.Creates a new instance of.InputStreamAssertstatic AbstractBooleanAssert<?> Deprecated.Creates a new instance of.BooleanAssertstatic AbstractByteAssert<?> Deprecated.Creates a new instance of.ByteAssertstatic AbstractCharacterAssert<?> Deprecated.Creates a new instance of.CharacterAssertstatic AbstractCharSequenceAssert<?, ? extends CharSequence> then(CharSequence actual) Deprecated.Creates a new instance of.CharSequenceAssertstatic AbstractClassAssert<?> Deprecated.Creates a new instance ofClassAssertstatic AbstractDoubleAssert<?> Deprecated.Creates a new instance of.DoubleAssertstatic AbstractFloatAssert<?> Deprecated.Creates a new instance of.FloatAssertstatic AbstractIntegerAssert<?> Deprecated.Creates a new instance of.IntegerAssertstatic <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT, ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>>
FactoryBasedNavigableIterableAssert<?, ACTUAL, ELEMENT, ELEMENT_ASSERT> then(Iterable<? extends ELEMENT> actual, AssertFactory<ELEMENT, ELEMENT_ASSERT> assertFactory) Deprecated.This was added to help creating type-specific assertions for the elements of anIterableinstance.static <T> AbstractIterableAssert<?, Iterable<? extends T>, T, ObjectAssert<T>> Deprecated.Creates a new instance of.IterableAssertstatic AbstractLongAssert<?> Deprecated.Creates a new instance of.LongAssertstatic AbstractShortAssert<?> Deprecated.Creates a new instance of.ShortAssertstatic AbstractStringAssert<?> Deprecated.Creates a new instance of.StringAssertstatic AbstractCharSequenceAssert<?, ? extends CharSequence> then(StringBuffer actual) Deprecated.Creates a new instance offrom aCharSequenceAssertStringBuffer.static AbstractCharSequenceAssert<?, ? extends CharSequence> then(StringBuilder actual) Deprecated.Creates a new instance offrom aCharSequenceAssertStringBuilder.static AbstractBigDecimalAssert<?> then(BigDecimal actual) Deprecated.Creates a new instance of.BigDecimalAssertstatic AbstractBigIntegerAssert<?> then(BigInteger actual) Deprecated.Creates a new instance of.BigIntegerAssertstatic AbstractUriAssert<?> Deprecated.Creates a new instance of.UriAssertstatic AbstractUrlAssert<?> Deprecated.Creates a new instance of.UrlAssertstatic <T> AbstractCollectionAssert<?, Collection<? extends T>, T, ObjectAssert<T>> then(Collection<? extends T> actual) Deprecated.Creates a new instance of.CollectionAssertstatic AtomicBooleanAssertthen(AtomicBoolean actual) Deprecated.Create assertion forAtomicBoolean.static AtomicIntegerAssertthen(AtomicInteger actual) Deprecated.Create assertion forAtomicInteger.static AtomicIntegerArrayAssertthen(AtomicIntegerArray actual) Deprecated.Create int[] assertion forAtomicIntegerArray.static <OBJECT> AtomicIntegerFieldUpdaterAssert<OBJECT> then(AtomicIntegerFieldUpdater<OBJECT> actual) Deprecated.Create assertion forAtomicIntegerFieldUpdater.static AtomicLongAssertthen(AtomicLong actual) Deprecated.Create assertion forAtomicLong.static AtomicLongArrayAssertthen(AtomicLongArray actual) Deprecated.Create assertion forAtomicLongArray.static <OBJECT> AtomicLongFieldUpdaterAssert<OBJECT> then(AtomicLongFieldUpdater<OBJECT> actual) Deprecated.Create assertion forAtomicLongFieldUpdater.static <VALUE> AtomicMarkableReferenceAssert<VALUE> then(AtomicMarkableReference<VALUE> actual) Deprecated.Create assertion forAtomicMarkableReference.static <VALUE> AtomicReferenceAssert<VALUE> then(AtomicReference<VALUE> actual) Deprecated.Create assertion forAtomicReference.static <ELEMENT> AtomicReferenceArrayAssert<ELEMENT> then(AtomicReferenceArray<ELEMENT> actual) Deprecated.Create assertion forAtomicReferenceArray.static <FIELD,OBJECT>
AtomicReferenceFieldUpdaterAssert<FIELD, OBJECT> then(AtomicReferenceFieldUpdater<OBJECT, FIELD> actual) Deprecated.Create assertion forAtomicReferenceFieldUpdater.static <VALUE> AtomicStampedReferenceAssert<VALUE> then(AtomicStampedReference<VALUE> actual) Deprecated.Create assertion forAtomicStampedReference.static <RESULT> AbstractFutureAssert<?, ? extends Future<? extends RESULT>, RESULT> Deprecated.Creates a new instance of.FutureAssertstatic AbstractDateAssert<?> Deprecated.Creates a new instance of.DateAssertstatic <T> AbstractIteratorAssert<?, T> Deprecated.Creates a new instance of.IteratorAssertstatic <ELEMENT,ACTUAL extends List<? extends ELEMENT>, ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>>
ClassBasedNavigableListAssert<?, ACTUAL, ELEMENT, ELEMENT_ASSERT> Deprecated.This was added to help creating type-specific assertions for the elements of anListinstance.static <ACTUAL extends List<? extends ELEMENT>,ELEMENT, ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>>
FactoryBasedNavigableListAssert<?, ACTUAL, ELEMENT, ELEMENT_ASSERT> then(List<? extends ELEMENT> actual, AssertFactory<ELEMENT, ELEMENT_ASSERT> assertFactory) Deprecated.This was added to help creating type-specific assertions for the elements of anListinstance.static <T> AbstractListAssert<?, List<? extends T>, T, ObjectAssert<T>> Deprecated.Creates a new instance of.ListAssertstatic <K,V> MapAssert <K, V> Deprecated.Creates a new instance of.MapAssertstatic <T> Tthen(AssertProvider<T> component) Deprecated.Delegates the creation of theAssertto theAssertProvider.assertThat()of the given component.static <T extends Comparable<? super T>>
AbstractComparableAssert<?, T> then(T actual) Deprecated.Creates a new instance ofwith standard comparison semantics.GenericComparableAssertstatic <T> AbstractObjectArrayAssert<?, T> then(T[] actual) Deprecated.Creates a new instance of.ObjectArrayAssertstatic <T> Object2DArrayAssert<T> then(T[][] actual) Deprecated.Creates a new instance of.Object2DArrayAssertstatic AbstractCharSequenceAssert<?, ? extends CharSequence> thenCharSequence(CharSequence actual) Deprecated.Creates a new instance of.CharSequenceAssertAbstractThrowableAssert<?, ? extends Throwable> thenCode(ThrowableAssert.ThrowingCallable shouldRaiseOrNotThrowable) Deprecated.Allows to capture and then assert on aThrowablemore easily when used with Java 8 lambdas.static <T> AbstractObjectAssert<?, T> thenObject(T actual) Deprecated.Creates a new instance offor any object.ObjectAssertstatic AbstractThrowableAssert<?, ? extends Throwable> thenThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable) Deprecated.Allows to capture and then assert on aThrowablemore easily when used with Java 8 lambdas.static AbstractThrowableAssert<?, ? extends Throwable> thenThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable, String description, Object... args) Deprecated.Allows to capture and then assert on aThrowablelikethenThrownBy(ThrowingCallable)but this method let you set the assertion description the same way you do withas(String, Object...).
-
Constructor Details
-
Java6BDDAssertions
protected Java6BDDAssertions()Deprecated.Creates a new.BDDAssertions
-
-
Method Details
-
then
Deprecated.Create assertion forAtomicBoolean.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Create assertion forAtomicInteger.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Create int[] assertion forAtomicIntegerArray.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <OBJECT> AtomicIntegerFieldUpdaterAssert<OBJECT> then(AtomicIntegerFieldUpdater<OBJECT> actual) Deprecated.Create assertion forAtomicIntegerFieldUpdater.- Type Parameters:
OBJECT- the type of the object holding the updatable field.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Create assertion forAtomicLong.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Create assertion forAtomicLongArray.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <OBJECT> AtomicLongFieldUpdaterAssert<OBJECT> then(AtomicLongFieldUpdater<OBJECT> actual) Deprecated.Create assertion forAtomicLongFieldUpdater.- Type Parameters:
OBJECT- the type of the object holding the updatable field.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Create assertion forAtomicReference.- Type Parameters:
VALUE- the type of the value contained in theAtomicReference.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <ELEMENT> AtomicReferenceArrayAssert<ELEMENT> then(AtomicReferenceArray<ELEMENT> actual) Deprecated.Create assertion forAtomicReferenceArray.- Type Parameters:
ELEMENT- the type of the value contained in theAtomicReferenceArray.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <FIELD,OBJECT> AtomicReferenceFieldUpdaterAssert<FIELD,OBJECT> then(AtomicReferenceFieldUpdater<OBJECT, FIELD> actual) Deprecated.Create assertion forAtomicReferenceFieldUpdater.- Type Parameters:
FIELD- the type of the field which gets updated by theAtomicReferenceFieldUpdater.OBJECT- the type of the object holding the updatable field.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <VALUE> AtomicMarkableReferenceAssert<VALUE> then(AtomicMarkableReference<VALUE> actual) Deprecated.Create assertion forAtomicMarkableReference.- Type Parameters:
VALUE- the type of the value contained in theAtomicMarkableReference.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
public static <VALUE> AtomicStampedReferenceAssert<VALUE> then(AtomicStampedReference<VALUE> actual) Deprecated.Create assertion forAtomicStampedReference.- Type Parameters:
VALUE- the type of the value contained in theAtomicStampedReference.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Creates a new instance of.BigDecimalAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.BigIntegerAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Creates a new instance of.BooleanAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.BooleanAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.BooleanArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Boolean2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.ByteAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ByteAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ByteArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Byte2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.CharacterAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.CharArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Char2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.CharacterAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance ofClassAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
public static <T> AbstractCollectionAssert<?,Collection<? extends T>, thenT, ObjectAssert<T>> (Collection<? extends T> actual) Deprecated.Creates a new instance of.CollectionAssert- Type Parameters:
T- the actual elements type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.21.0
-
then
Deprecated.Creates a new instance ofwith standard comparison semantics.GenericComparableAssert- Type Parameters:
T- the actual type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
public static <T> AbstractIterableAssert<?,Iterable<? extends T>, thenT, ObjectAssert<T>> (Iterable<? extends T> actual) Deprecated.Creates a new instance of.IterableAssert- Type Parameters:
T- the actual elements type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.IteratorAssertBreaking change in version 3.12.0: this method does not return anymore an
IterableAssertbut anIteratorAssert.
In order to access assertions fromIterableAssert, useAbstractIteratorAssert.toIterable().IteratorAssertinstances have limited assertions because it does not consume iterator's elements.Examples:
Iterator<String> bestBasketBallPlayers = getBestBasketBallPlayers(); then(bestBasketBallPlayers).hasNext() // Iterator assertion .toIterable() // switch to Iterable assertions .contains("Jordan", "Magic", "Lebron"); // Iterable assertion- Type Parameters:
T- the actual elements type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
@Deprecated public static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT, FactoryBasedNavigableIterableAssert<?,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>> ACTUAL, thenELEMENT, ELEMENT_ASSERT> (Iterable<? extends ELEMENT> actual, AssertFactory<ELEMENT, ELEMENT_ASSERT> assertFactory) Deprecated.This was added to help creating type-specific assertions for the elements of anIterableinstance.Deprecated way:
However, there is a better way withIterable<String> hobbits = Set.of("frodo", "sam", "Pippin"); then(hobbits, StringAssert::new).first() .startsWith("fro") .endsWith("do");InstanceOfAssertFactoryand the correspondingfirst(InstanceOfAssertFactory).New way:
The main advantage of the latter is easier discoverability and the use of InstanceOfAssertFactory which is the preferred way to create type-specific assertions in AssertJ API.then(hobbits).first(STRING) // static import of InstanceOfAssertFactories.STRING .startsWith("fro") .endsWith("do");Creates a new instance ofallowing to navigate to anyFactoryBasedNavigableIterableAssertIterableelement in order to perform assertions on it.Navigational methods provided:
The available assertions after navigating to an element depend on the
ELEMENT_ASSERTparameter of the givenAssertFactory<ELEMENT, ELEMENT_ASSERT>(AssertJ can't figure it out because of Java type erasure).Example with
Stringelement assertions:Iterable<String> hobbits = newHashSet("frodo", "sam", "pippin"); // build an AssertFactory for StringAssert (much nicer with Java 8 lambdas) AssertFactory<String, StringAssert> stringAssertFactory = new AssertFactory<String, StringAssert>() { @Override public StringAssert createAssert(String string) { return new StringAssert(string); } }; // assertion succeeds with String assertions chained after first() then(hobbits, stringAssertFactory).first() .startsWith("fro") .endsWith("do");- Type Parameters:
ACTUAL- The actual typeELEMENT- The actual elements typeELEMENT_ASSERT- The actual elements AbstractAssert type- Parameters:
actual- the actual value.assertFactory- the factory used to create the elements assert instance.- Returns:
- the created assertion object.
-
then
@Deprecated public static <ACTUAL extends Iterable<? extends ELEMENT>,ELEMENT, ClassBasedNavigableIterableAssert<?,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>> ACTUAL, thenELEMENT, ELEMENT_ASSERT> (ACTUAL actual, Class<ELEMENT_ASSERT> assertClass) Deprecated.This was added to help creating type-specific assertions for the elements of anIterableinstance.Deprecated way:
However, there is a better way withIterable<String> hobbits = Set.of("frodo", "sam", "Pippin"); then(hobbits, StringAssert.class).first() .startsWith("fro") .endsWith("do");InstanceOfAssertFactoryand the correspondingfirst(InstanceOfAssertFactory).New way:
The main advantage of the latter is easier discoverability and the use of InstanceOfAssertFactory which is the preferred way to create type-specific assertions in AssertJ API.then(hobbits).first(STRING) // static import of InstanceOfAssertFactories.STRING .startsWith("fro") .endsWith("do");Creates a new instance ofallowing to navigate to anyClassBasedNavigableIterableAssertIterableelement in order to perform assertions on it.Navigational methods provided:
The available assertions after navigating to an element depend on the given
assertClass(AssertJ can't find the element assert type by itself because of Java type erasure).Example with
Stringelement assertions:Iterable<String> hobbits = newHashSet("frodo", "sam", "pippin"); // assertion succeeds with String assertions chained after first() then(hobbits, StringAssert.class).first() .startsWith("fro") .endsWith("do");- Type Parameters:
ACTUAL- The actual typeELEMENT- The actual elements typeELEMENT_ASSERT- The actual elements AbstractAssert type- Parameters:
actual- the actual value.assertClass- the class used to create the elements assert instance.- Returns:
- the created assertion object.
-
then
@Deprecated public static <ACTUAL extends List<? extends ELEMENT>,ELEMENT, FactoryBasedNavigableListAssert<?,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>> ACTUAL, thenELEMENT, ELEMENT_ASSERT> (List<? extends ELEMENT> actual, AssertFactory<ELEMENT, ELEMENT_ASSERT> assertFactory) Deprecated.This was added to help creating type-specific assertions for the elements of anListinstance.Deprecated way:
However, there is a better way withList<String> hobbits = List.of("frodo", "sam", "Pippin"); then(hobbits, StringAssert::new).first() .startsWith("fro") .endsWith("do");InstanceOfAssertFactoryand the correspondingfirst(InstanceOfAssertFactory).New way:
The main advantage of the latter is easier discoverability and the use of InstanceOfAssertFactory which is the preferred way to create type-specific assertions in AssertJ API.then(hobbits).first(STRING) // static import of InstanceOfAssertFactories.STRING .startsWith("fro") .endsWith("do");Creates a new instance ofallowing to navigate to anyFactoryBasedNavigableListAssertListelement in order to perform assertions on it.Navigational methods provided:
The available assertions after navigating to an element depend on the
ELEMENT_ASSERTparameter of the givenAssertFactory<ELEMENT, ELEMENT_ASSERT>(AssertJ can't figure it out because of Java type erasure).Example with
Stringelement assertions:List<String> hobbits = newArrayList("frodo", "sam", "pippin"); // build an AssertFactory for StringAssert (much nicer with Java 8 lambdas) AssertFactory<String, StringAssert> stringAssertFactory = new AssertFactory<String, StringAssert>() { @Override public StringAssert createAssert(String string) { return new StringAssert(string); } }; // assertion succeeds with String assertions chained after first() then(hobbits, stringAssertFactory).first() .startsWith("fro") .endsWith("do");- Type Parameters:
ACTUAL- The actual typeELEMENT- The actual elements typeELEMENT_ASSERT- The actual elements AbstractAssert type- Parameters:
actual- the actual value.assertFactory- the factory used to create the elements assert instance.- Returns:
- the created assertion object.
-
then
@Deprecated public static <ELEMENT,ACTUAL extends List<? extends ELEMENT>, ClassBasedNavigableListAssert<?,ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT, ELEMENT>> ACTUAL, thenELEMENT, ELEMENT_ASSERT> (List<? extends ELEMENT> actual, Class<ELEMENT_ASSERT> assertClass) Deprecated.This was added to help creating type-specific assertions for the elements of anListinstance.Deprecated way:
However, there is a better way withList<String> hobbits = List.of("frodo", "sam", "Pippin"); then(hobbits, StringAssert.class).first() .startsWith("fro") .endsWith("do");InstanceOfAssertFactoryand the correspondingfirst(InstanceOfAssertFactory).New way:
The main advantage of the latter is easier discoverability and the use of InstanceOfAssertFactory which is the preferred way to create type-specific assertions in AssertJ API.then(hobbits).first(STRING) // static import of InstanceOfAssertFactories.STRING .startsWith("fro") .endsWith("do");Creates a new instance ofallowing to navigate to anyClassBasedNavigableListAssertListelement in order to perform assertions on it.Navigational methods provided:
The available assertions after navigating to an element depend on the given
assertClass(AssertJ can't find the element assert type by itself because of Java type erasure).Example with
Stringelement assertions:List<String> hobbits = newArrayList("frodo", "sam", "pippin"); // assertion succeeds with String assertions chained after first() then(hobbits, StringAssert.class).first() .startsWith("fro") .endsWith("do");- Type Parameters:
ELEMENT- The actual elements typeACTUAL- The actual typeELEMENT_ASSERT- The actual elements AbstractAssert type- Parameters:
actual- the actual value.assertClass- the class used to create the elements assert instance.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.DoubleAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.DoubleAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.DoubleArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Double2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.FileAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
public static <RESULT> AbstractFutureAssert<?,? extends Future<? extends RESULT>, thenRESULT> (Future<RESULT> actual) Deprecated.Creates a new instance of.FutureAssert- Type Parameters:
RESULT- the type of the value contained in theFuture.- Parameters:
actual- the future to test- Returns:
- the created assertion object
- Since:
- 2.7.0 / 3.7.0
-
then
Deprecated.Creates a new instance of.InputStreamAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.FloatAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.FloatAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.FloatArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.IntegerAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.IntArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Int2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Float2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.IntegerAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
public static <T> AbstractListAssert<?,List<? extends T>, thenT, ObjectAssert<T>> (List<? extends T> actual) Deprecated.Creates a new instance of.ListAssert- Type Parameters:
T- the actual elements type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.LongAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.LongAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.LongArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Long2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.ObjectAssert- Type Parameters:
T- the actual type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ObjectArrayAssert- Type Parameters:
T- the actual elements type- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.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
-
then
Deprecated.Creates a new instance of.MapAssert- Type Parameters:
K- the type of keys in the map.V- the type of values in the map.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ShortAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ShortAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ShortArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.Short2DArrayAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.17.0
-
then
Deprecated.Creates a new instance of.CharSequenceAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
thenCharSequence
public static AbstractCharSequenceAssert<?,? extends CharSequence> thenCharSequence(CharSequence actual) Deprecated.Creates a new instance of.CharSequenceAssertUse this over
then(CharSequence)in case of ambiguous method resolution when the object under test implements several interfaces Assertj providesthenfor.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.25.0
-
then
Deprecated.Creates a new instance offrom aCharSequenceAssertStringBuilder.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.11.0
-
then
Deprecated.Creates a new instance offrom aCharSequenceAssertStringBuffer.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.11.0
-
then
Deprecated.Creates a new instance of.StringAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.DateAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.ThrowableAssert- Type Parameters:
T- the type of the actual throwable.- Parameters:
actual- the actual value.- Returns:
- the created assertion Throwable.
-
thenThrownBy
public static AbstractThrowableAssert<?,? extends Throwable> thenThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable) Deprecated.Allows to capture and then assert on aThrowablemore easily when used with Java 8 lambdas.Java 8 example :
Java 7 example :@Test public void testException() { thenThrownBy(() -> { throw new Exception("boom!") }).isInstanceOf(Exception.class) .hasMessageContaining("boom"); }
If the providedthenThrownBy(new ThrowingCallable() { @Override public Void call() throws Exception { throw new Exception("boom!"); } }).isInstanceOf(Exception.class) .hasMessageContaining("boom");ThrowableAssert.ThrowingCallabledoes not raise an exception, an error is immediately thrown, in that case the test description provided withas(String, Object...)is not honored.
To use a test description, useAssertions.catchThrowable(ThrowableAssert.ThrowingCallable)as shown below:
Alternatively you can also use// assertion will fail but "display me" won't appear in the error thenThrownBy(() -> {}).as("display me") .isInstanceOf(Exception.class); // assertion will fail AND "display me" will appear in the error Throwable thrown = catchThrowable(() -> {}); then(thrown).as("display me") .isInstanceOf(Exception.class);thenCode(ThrowingCallable)for the test description provided withas(String, Object...)to always be honored.- Parameters:
shouldRaiseThrowable- TheThrowableAssert.ThrowingCallableor lambda with the code that should raise the throwable.- Returns:
- The captured exception or
nullif none was raised by the callable.
-
thenThrownBy
public static AbstractThrowableAssert<?,? extends Throwable> thenThrownBy(ThrowableAssert.ThrowingCallable shouldRaiseThrowable, String description, Object... args) Deprecated.Allows to capture and then assert on aThrowablelikethenThrownBy(ThrowingCallable)but this method let you set the assertion description the same way you do withas(String, Object...).Example:
If the provided@Test public void testException() { // if this assertion failed (but it doesn't), the error message would start with [Test explosive code] thenThrownBy(() -> { throw new IOException("boom!") }, "Test explosive code") .isInstanceOf(IOException.class) .hasMessageContaining("boom"); }ThrowingCallabledoes 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 thenThrownBy(() -> {}).as("display me") .isInstanceOf(Exception.class); // assertion will fail AND "display me" will appear in the error message thenThrownBy(() -> {}, "display me") .isInstanceOf(Exception.class);- Parameters:
shouldRaiseThrowable- TheThrowableAssert.ThrowingCallableor 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
-
thenCode
public AbstractThrowableAssert<?,? extends Throwable> thenCode(ThrowableAssert.ThrowingCallable shouldRaiseOrNotThrowable) Deprecated.Allows to capture and then assert on aThrowablemore easily when used with Java 8 lambdas.Example :
Contrary toThrowingCallable callable = () -> { throw new Exception("boom!"); }; // assertion succeeds thenCode(callable).isInstanceOf(Exception.class) .hasMessageContaining("boom"); // assertion fails thenCode(callable).doesNotThrowAnyException();thenThrownBy(ThrowingCallable)the test description provided withas(String, Object...)is always honored as shown below.ThrowingCallable doNothing = () -> { // do nothing }; // assertion fails and "display me" appears in the assertion error thenCode(doNothing).as("display me") .isInstanceOf(Exception.class);This method was not named
thenbecause the java compiler reported it ambiguous when used directly with a lambda :(- Parameters:
shouldRaiseOrNotThrowable- TheThrowableAssert.ThrowingCallableor lambda with the code that should raise the throwable.- Returns:
- The captured exception or
nullif none was raised by the callable. - Since:
- 3.7.0
-
then
Deprecated.Creates a new instance of.UriAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Creates a new instance of.UrlAssert- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
-
then
Deprecated.Returns the given assertion. This method improves code readability by surrounding the given assertion withthen.Consider for example the following MyButton and MyButtonAssert classes:
As MyButtonAssert implements AssertDelegateTarget, you can usepublic class MyButton extends JButton { private boolean blinking; public boolean isBlinking() { return this.blinking; } public void setBlinking(boolean blink) { this.blinking = blink; } } private static class MyButtonAssert implements AssertDelegateTarget { private MyButton button; MyButtonAssert(MyButton button) { this.button = button; } void isBlinking() { // standard assertion from core Assertions.then then(button.isBlinking()).isTrue(); } void isNotBlinking() { // standard assertion from core Assertions.then then(button.isBlinking()).isFalse(); } }then(buttonAssert).isBlinking();instead ofbuttonAssert.isBlinking();to have easier to read assertions:@Test public void AssertDelegateTarget_example() { MyButton button = new MyButton(); MyButtonAssert buttonAssert = new MyButtonAssert(button); // you can encapsulate MyButtonAssert assertions methods within then then(buttonAssert).isNotBlinking(); // same as : buttonAssert.isNotBlinking(); button.setBlinking(true); then(buttonAssert).isBlinking(); // same as : buttonAssert.isBlinking(); }- Type Parameters:
T- the generic type of the user-defined assert.- Parameters:
assertion- the assertion to return.- Returns:
- the given assertion.
-
then
Deprecated.Delegates the creation of theAssertto theAssertProvider.assertThat()of the given component.Read the comments on
AssertProviderfor an example of its usage.- Type Parameters:
T- the AssertProvider wrapped type.- Parameters:
component- the component that creates its own assert- Returns:
- the associated
Assertof the given component
-
thenObject
Deprecated.Creates a new instance offor any object.ObjectAssertThis overload is useful, when an overloaded method of then(...) takes precedence over the generic
then(Object). Example:Cast necessary because
then(List)"forgets" actual type:
No cast needed, but also no additional list assertions:then(new LinkedList<>(asList("abc"))).matches(list -> ((Deque<String>) list).getFirst().equals("abc"));thenObject(new LinkedList<>(asList("abc"))).matches(list -> list.getFirst().equals("abc"));- Type Parameters:
T- the type of the actual value.- Parameters:
actual- the actual value.- Returns:
- the created assertion object.
- Since:
- 3.12.0
-
Android-compatible BDD-style assertions duplicated from
BDDAssertions.