Class Java6Assertions


  • @Deprecated
    public class Java6Assertions
    extends Object
    Deprecated.
    For Android compatible assertions use the latest assertj 2.x version which is based on Java 7 only.

    Assertions compatible with Android. Duplicated from Assertions.

    See Also:
    Assertions
    • Constructor Detail

      • Java6Assertions

        protected Java6Assertions()
        Deprecated.
    • Method Detail

      • assertThat

        public static AtomicBooleanAssert assertThat​(AtomicBoolean actual)
        Deprecated.
        Create assertion for AtomicBoolean.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
        Since:
        2.7.0 / 3.7.0
      • assertThat

        public static AtomicIntegerAssert assertThat​(AtomicInteger actual)
        Deprecated.
        Create assertion for AtomicInteger.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
        Since:
        2.7.0 / 3.7.0
      • assertThat

        public static AtomicLongAssert assertThat​(AtomicLong actual)
        Deprecated.
        Create assertion for AtomicLong.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
        Since:
        2.7.0 / 3.7.0
      • assertThat

        public static <OBJECT> AtomicLongFieldUpdaterAssert<OBJECT> assertThat​(AtomicLongFieldUpdater<OBJECT> actual)
        Deprecated.
        Create assertion for AtomicLongFieldUpdater.
        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
      • assertThat

        public static <VALUE> AtomicReferenceAssert<VALUE> assertThat​(AtomicReference<VALUE> actual)
        Deprecated.
        Create assertion for AtomicReference.
        Type Parameters:
        VALUE - the type of the value contained in the AtomicReference.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
        Since:
        2.7.0 / 3.7.0
      • assertThat

        public static AbstractUriAssert<?> assertThat​(URI actual)
        Deprecated.
        Creates a new instance of UriAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractUrlAssert<?> assertThat​(URL actual)
        Deprecated.
        Creates a new instance of UrlAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractBooleanAssert<?> assertThat​(boolean actual)
        Deprecated.
        Creates a new instance of BooleanAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractBooleanAssert<?> assertThat​(Boolean actual)
        Deprecated.
        Creates a new instance of BooleanAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractBooleanArrayAssert<?> assertThat​(boolean[] actual)
        Deprecated.
        Creates a new instance of BooleanArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractByteAssert<?> assertThat​(byte actual)
        Deprecated.
        Creates a new instance of ByteAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractByteAssert<?> assertThat​(Byte actual)
        Deprecated.
        Creates a new instance of ByteAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractByteArrayAssert<?> assertThat​(byte[] actual)
        Deprecated.
        Creates a new instance of ByteArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractCharacterAssert<?> assertThat​(char actual)
        Deprecated.
        Creates a new instance of CharacterAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractCharArrayAssert<?> assertThat​(char[] actual)
        Deprecated.
        Creates a new instance of CharArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractClassAssert<?> assertThat​(Class<?> actual)
        Deprecated.
        Creates a new instance of ClassAssert
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <T extends Comparable<? super T>> AbstractComparableAssert<?,​T> assertThat​(T actual)
        Deprecated.
        Creates a new instance of GenericComparableAssert with standard comparison semantics.
        Type Parameters:
        T - the type of the actual value.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <T> AbstractIterableAssert<?,​Iterable<? extends T>,​T,​ObjectAssert<T>> assertThat​(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.
      • assertThat

        public static <T> AbstractIteratorAssert<?,​T> assertThat​(Iterator<? extends T> actual)
        Deprecated.
        Creates a new instance of IteratorAssert.

        Breaking change in version 3.12.0: this method does not return anymore an IterableAssert but an IteratorAssert.
        In order to access assertions from IterableAssert, use AbstractIteratorAssert.toIterable().

        IteratorAssert instances have limited assertions because it does not consume iterator's elements.

        Examples:

         Iterator<String> bestBasketBallPlayers = getBestBasketBallPlayers();
        
         assertThat(bestBasketBallPlayers).hasNext() // Iterator assertion
                                          .toIterable() // switch to Iterable assertions
                                          .contains("Jordan", "Magic", "Lebron"); // Iterable assertion 
        Type Parameters:
        T - the type of elements.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractDoubleAssert<?> assertThat​(double actual)
        Deprecated.
        Creates a new instance of DoubleAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractDoubleAssert<?> assertThat​(Double actual)
        Deprecated.
        Creates a new instance of DoubleAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractDoubleArrayAssert<?> assertThat​(double[] actual)
        Deprecated.
        Creates a new instance of DoubleArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractFileAssert<?> assertThat​(File actual)
        Deprecated.
        Creates a new instance of FileAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <RESULT> AbstractFutureAssert<?,​? extends Future<? extends RESULT>,​RESULT> assertThat​(Future<RESULT> actual)
        Deprecated.
        Create assertion for Future.
        Type Parameters:
        RESULT - the type of the value contained in the Future.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
        Since:
        2.7.0 / 3.7.0
      • assertThat

        public static AbstractFloatAssert<?> assertThat​(float actual)
        Deprecated.
        Creates a new instance of FloatAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractFloatAssert<?> assertThat​(Float actual)
        Deprecated.
        Creates a new instance of FloatAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractFloatArrayAssert<?> assertThat​(float[] actual)
        Deprecated.
        Creates a new instance of FloatArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractIntegerAssert<?> assertThat​(int actual)
        Deprecated.
        Creates a new instance of IntegerAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractIntArrayAssert<?> assertThat​(int[] actual)
        Deprecated.
        Creates a new instance of IntArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractIntegerAssert<?> assertThat​(Integer actual)
        Deprecated.
        Creates a new instance of IntegerAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <T> AbstractListAssert<?,​List<? extends T>,​T,​ObjectAssert<T>> assertThat​(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.
      • assertThat

        public static <ACTUAL extends Iterable<? extends ELEMENT>,​ELEMENT,​ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,​ELEMENT>> FactoryBasedNavigableIterableAssert<?,​ACTUAL,​ELEMENT,​ELEMENT_ASSERT> assertThat​(Iterable<? extends ELEMENT> actual,
                                                                                                                                                                                                                                                             AssertFactory<ELEMENT,​ELEMENT_ASSERT> assertFactory)
        Deprecated.
        Creates a new instance of FactoryBasedNavigableIterableAssert allowing to navigate to any Iterable element in order to perform assertions on it.

        Navigational methods provided:

        The available assertions after navigating to an element depend on the ELEMENT_ASSERT parameter of the given AssertFactory<ELEMENT, ELEMENT_ASSERT> (AssertJ can't figure it out because of Java type erasure).

        Example with String element 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()
         assertThat(hobbits, stringAssertFactory).first()
                                                 .startsWith("fro")
                                                 .endsWith("do");
        Type Parameters:
        ACTUAL - The actual type
        ELEMENT - The actual elements type
        ELEMENT_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.
      • assertThat

        public static <ACTUAL extends Iterable<? extends ELEMENT>,​ELEMENT,​ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,​ELEMENT>> ClassBasedNavigableIterableAssert<?,​ACTUAL,​ELEMENT,​ELEMENT_ASSERT> assertThat​(ACTUAL actual,
                                                                                                                                                                                                                                                           Class<ELEMENT_ASSERT> assertClass)
        Deprecated.
        Creates a new instance of ClassBasedNavigableIterableAssert allowing to navigate to any Iterable element 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 String element assertions:

         Iterable<String> hobbits = newHashSet("frodo", "sam", "pippin");
        
         // assertion succeeds with String assertions chained after first()
         assertThat(hobbits, StringAssert.class).first()
                                                .startsWith("fro")
                                                .endsWith("do");
        Type Parameters:
        ACTUAL - The actual type
        ELEMENT - The actual elements type
        ELEMENT_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.
      • assertThat

        public static <ACTUAL extends List<? extends ELEMENT>,​ELEMENT,​ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,​ELEMENT>> FactoryBasedNavigableListAssert<?,​ACTUAL,​ELEMENT,​ELEMENT_ASSERT> assertThat​(List<? extends ELEMENT> actual,
                                                                                                                                                                                                                                                     AssertFactory<ELEMENT,​ELEMENT_ASSERT> assertFactory)
        Deprecated.
        Creates a new instance of FactoryBasedNavigableListAssert allowing to navigate to any List element in order to perform assertions on it.

        Navigational methods provided:

        The available assertions after navigating to an element depend on the ELEMENT_ASSERT parameter of the given AssertFactory<ELEMENT, ELEMENT_ASSERT> (AssertJ can't figure it out because of Java type erasure).

        Example with String element 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()
         assertThat(hobbits, stringAssertFactory).first()
                                                 .startsWith("fro")
                                                 .endsWith("do");
        Type Parameters:
        ACTUAL - The actual type
        ELEMENT - The actual elements type
        ELEMENT_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.
      • assertThat

        public static <ELEMENT,​ACTUAL extends List<? extends ELEMENT>,​ELEMENT_ASSERT extends AbstractAssert<ELEMENT_ASSERT,​ELEMENT>> ClassBasedNavigableListAssert<?,​ACTUAL,​ELEMENT,​ELEMENT_ASSERT> assertThat​(List<? extends ELEMENT> actual,
                                                                                                                                                                                                                                                   Class<ELEMENT_ASSERT> assertClass)
        Deprecated.
        Creates a new instance of ClassBasedNavigableListAssert allowing to navigate to any List element 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 String element assertions:

         List<String> hobbits = newArrayList("frodo", "sam", "pippin");
        
         // assertion succeeds with String assertions chained after first()
         assertThat(hobbits, StringAssert.class).first()
                                                .startsWith("fro")
                                                .endsWith("do");
        Type Parameters:
        ACTUAL - The actual type
        ELEMENT - The actual elements type
        ELEMENT_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.
      • assertThat

        public static AbstractLongAssert<?> assertThat​(long actual)
        Deprecated.
        Creates a new instance of LongAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractLongAssert<?> assertThat​(Long actual)
        Deprecated.
        Creates a new instance of LongAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractLongArrayAssert<?> assertThat​(long[] actual)
        Deprecated.
        Creates a new instance of LongArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <T> AbstractObjectAssert<?,​T> assertThat​(T actual)
        Deprecated.
        Creates a new instance of ObjectAssert.
        Type Parameters:
        T - the actual type
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static <T extends AssertDelegateTarget> T assertThat​(T assertion)
        Deprecated.
        Returns the given assertion. This method improves code readability by surrounding the given assertion with assertThat.

        Consider for example the following MyButton and MyButtonAssert classes:

         public 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.assertThat
             assertThat(button.isBlinking()).isTrue();
           }
        
           void isNotBlinking() {
             // standard assertion from core Assertions.assertThat
             assertThat(button.isBlinking()).isFalse();
           }
         }
        As MyButtonAssert implements AssertDelegateTarget, you can use assertThat(buttonAssert).isBlinking(); instead of buttonAssert.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 assertThat
           assertThat(buttonAssert).isNotBlinking(); // same as : buttonAssert.isNotBlinking();
        
           button.setBlinking(true);
        
           assertThat(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.
      • assertThat

        public static <T> T assertThat​(AssertProvider<T> component)
        Deprecated.
        Delegates the creation of the Assert to the AssertProvider.assertThat() of the given component.

        Read the comments on AssertProvider for an example of its usage.

        Type Parameters:
        T - the generic type of the assert provided by the component.
        Parameters:
        component - the component that creates its own assert
        Returns:
        the associated Assert of the given component
      • assertThat

        public static <T> AbstractObjectArrayAssert<?,​T> assertThat​(T[] actual)
        Deprecated.
        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 <K,​V> MapAssert<K,​V> assertThat​(Map<K,​V> actual)
        Deprecated.
        Creates a new instance of MapAssert.

        Returned type is MapAssert as it overrides method to annotate them with SafeVarargs avoiding annoying warnings.

        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.
      • assertThat

        public static AbstractShortAssert<?> assertThat​(short actual)
        Deprecated.
        Creates a new instance of ShortAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractShortAssert<?> assertThat​(Short actual)
        Deprecated.
        Creates a new instance of ShortAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractShortArrayAssert<?> assertThat​(short[] actual)
        Deprecated.
        Creates a new instance of ShortArrayAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractStringAssert<?> assertThat​(String actual)
        Deprecated.
        Creates a new instance of StringAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThat

        public static AbstractDateAssert<?> assertThat​(Date actual)
        Deprecated.
        Creates a new instance of DateAssert.
        Parameters:
        actual - the actual value.
        Returns:
        the created assertion object.
      • assertThatThrownBy

        public static AbstractThrowableAssert<?,​? extends Throwable> assertThatThrownBy​(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)
        Deprecated.
        Allows to capture and then assert on a Throwable more easily when used with Java 8 lambdas.

        Java 8 example :

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

        Java 7 example :

         assertThatThrownBy(new ThrowingCallable() {
        
           @Override
           public void call() throws Exception {
             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); 
        Parameters:
        shouldRaiseThrowable - 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.
      • assertThatThrownBy

        public static AbstractThrowableAssert<?,​? extends Throwable> assertThatThrownBy​(ThrowableAssert.ThrowingCallable shouldRaiseThrowable,
                                                                                              String description,
                                                                                              Object... args)
        Deprecated.
        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
      • assertThatCode

        public static AbstractThrowableAssert<?,​? extends Throwable> assertThatCode​(ThrowableAssert.ThrowingCallable shouldRaiseOrNotThrowable)
        Deprecated.
        Allows to capture and then assert on a Throwable.

        Example :

         ThrowingCallable callable = new ThrowingCallable() {
           @Override
           public void call() throws Throwable {
             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 = new ThrowingCallable() {
           @Override
           public void call() throws Throwable {
             // 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
      • assertThatObject

        public <T> AbstractObjectAssert<?,​T> assertThatObject​(T actual)
        Deprecated.
        Creates a new instance of ObjectAssert for any object.

        This overload is useful, when an overloaded method of assertThat(...) takes precedence over the generic assertThat(Object).

        Example:

        Cast necessary because assertThat(List) "forgets" actual type:

        assertThat(new LinkedList<>(asList("abc"))).matches(list -> ((Deque<String>) list).getFirst().equals("abc")); 
        No cast needed, but also no additional list assertions:
        assertThatObject(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
      • catchThrowable

        public static Throwable catchThrowable​(ThrowableAssert.ThrowingCallable shouldRaiseThrowable)
        Deprecated.
        Allows to catch an Throwable more easily when used with Java 8 lambdas.

        This caught Throwable can then be asserted.

        Java 8 example:

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

        Java 7 example:

         @Test
         public void testException() {
           // when
           Throwable thrown = catchThrowable(new ThrowingCallable() {
        
             @Override
             public void call() throws Exception {
               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.
      • catchThrowableOfType

        public static <THROWABLE extends Throwable> THROWABLE catchThrowableOfType​(ThrowableAssert.ThrowingCallable shouldRaiseThrowable,
                                                                                   Class<THROWABLE> type)
        Deprecated.
        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)
      • fail

        public static void fail​(String failureMessage)
        Deprecated.
        Throws an AssertionError with the given message.
        Parameters:
        failureMessage - error message.
        Throws:
        AssertionError - with the given message.
      • fail

        public static void fail​(String failureMessage,
                                Throwable realCause)
        Deprecated.
        Throws an AssertionError with the given message and with the Throwable that caused the failure.
        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)
        Deprecated.
        Throws an AssertionError with a message explaining that a Throwable of given class was expected to be thrown but had not been.

        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)
        Deprecated.
        Throws an AssertionError with a message explaining that a Throwable of given class was expected to be thrown but had not been.
        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)
        Deprecated.
        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
      • setMaxElementsForPrinting

        public static void setMaxElementsForPrinting​(int maxElementsForPrinting)
        Deprecated.
        In error messages, sets the threshold for how many elements from one iterable/array/map will be included in the in the description. E.q. When this method is called with a value of 3.

        The following array will be formatted entirely as it's length is <= 3:

         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 only with it's first 3 elements, followed by ...:
         String[] greatBooks = array("A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice", "Guards! Guards!");
        
         // formatted as:
        
         ["A Game of Thrones", "The Lord of the Rings", "Assassin's Apprentice", ...]
        Parameters:
        maxElementsForPrinting - the maximum elements that would be printed from one iterable/array/map
        Since:
        2.6.0 / 3.6.0
      • extractProperty

        public static <T> Properties<T> extractProperty​(String propertyName,
                                                        Class<T> propertyType)
        Deprecated.
        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)
        Deprecated.
        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.
      • setAllowExtractingPrivateFields

        public static void setAllowExtractingPrivateFields​(boolean allowExtractingPrivateFields)
        Deprecated.
        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.
      • entry

        public static <K,​V> MapEntry<K,​V> entry​(K key,
                                                            V value)
        Deprecated.
        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 keys in the map.
        V - the type of values in the map.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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<BigInteger> within​(BigInteger value)
        Deprecated.
        Assertions entry point for BigInteger Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(BigInteger.TEN).isCloseTo(new BigInteger("11"), within(new BigInteger("2")));
        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.
        Since:
        2.7.0 / 3.7.0
      • within

        public static Offset<Byte> within​(Byte value)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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.
      • byLessThan

        public static Offset<Double> byLessThan​(Double value)
        Deprecated.
        Alias for offset(Double) to use with isCloseTo assertions.

        Typical usage :

         assertThat(8.1).isCloseTo(8.0, byLessThan(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.
      • byLessThan

        public static Offset<Float> byLessThan​(Float value)
        Deprecated.
        Alias for offset(Float) to use with isCloseTo assertions.

        Typical usage :

         assertThat(8.2f).isCloseTo(8.0f, byLessThan(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.
      • byLessThan

        public static Offset<BigDecimal> byLessThan​(BigDecimal value)
        Deprecated.
        Assertions entry point for BigDecimal Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(BigDecimal.TEN).isCloseTo(new BigDecimal("10.5"), byLessThan(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.
      • byLessThan

        public static Offset<BigInteger> byLessThan​(BigInteger value)
        Deprecated.
        Assertions entry point for BigInteger Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(BigInteger.TEN).isCloseTo(new BigInteger("11"), byLessThan(new BigInteger("2")));
        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.
        Since:
        2.7.0 / 3.7.0
      • byLessThan

        public static Offset<Byte> byLessThan​(Byte value)
        Deprecated.
        Assertions entry point for Byte Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat((byte) 10).isCloseTo((byte) 11, byLessThan((byte) 1));
        Parameters:
        value - the allowed offset
        Returns:
        the created Offset.
      • byLessThan

        public static Offset<Integer> byLessThan​(Integer value)
        Deprecated.
        Assertions entry point for Integer Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(10).isCloseTo(11, byLessThan(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.
      • byLessThan

        public static Offset<Short> byLessThan​(Short value)
        Deprecated.
        Assertions entry point for Short Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(10).isCloseTo(11, byLessThan(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.
      • byLessThan

        public static Offset<Long> byLessThan​(Long value)
        Deprecated.
        Assertions entry point for Long Offset to use with isCloseTo assertions.

        Typical usage :

         assertThat(5l).isCloseTo(7l, byLessThan(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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        Creates a new AllOf
        Type Parameters:
        T - the type of object the given condition accept.
        Parameters:
        conditions - the conditions to evaluate.
        Returns:
        the created AllOf.
        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)
        Deprecated.
        Creates a new AllOf
        Type Parameters:
        T - the type of object the given condition accept.
        Parameters:
        conditions - the conditions to evaluate.
        Returns:
        the created AllOf.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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 iterable is null.
      • in

        public static InFilter in​(Object... values)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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.
      • contentOf

        public static String contentOf​(URL url,
                                       Charset charset)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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)
        Deprecated.
        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 :

        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)
        Deprecated.
        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 :

        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()
        Deprecated.
        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