Java & Spring Weekly

AssertJ Shorts №1

Как и обещал, пост про мою любимую библиотеку для тестов - AssertJ. У проекта есть официальный веб-сайт https://assertj.github.io/doc/, он большой, красивый и там есть масса примеров, как круто можно использовать AssertJ.

Вообще, в JUnit есть и своя библиотека assertion-ов, которая неплохо расширяется, например, Hamcrest-ом. Из плюсов - это просто и доступно из коробки, из минусов - недостаточно выразительно. Что доступно в JUnit:


String name = "assertJ”;

assertEquals(“assertJ”, name);

В билиотеке JUnit есть еще несколько assert-ов, но все они вида assertEqual/assertNotEqual/assertTrue. В AssertJ выбор гораздо больше и все начинается с метода assertThat:


import static org.assertj.core.api.Assertions.*;

@Test
void basic_assertions() {
    String name = "assertj";

    assertThat(name)
        .startsWith("asser”)
        .endsWith("tj")
        .isEqualToIgnoringCase("ASSERTJ")
        .doesNotContain("mockito");
}

И дальше уже можно по цепочке добавлять проверки. В зависимости от типа параметра доступны различные вспомогательные методы, например, для целых чисел проверки уже другие:


@Test
void number_example() {
    assertThat(42)
        .isGreaterThan(10)
        .isLessThanOrEqualTo(100)
        .isNotZero();
}

Есть удобная поддержка Optional-ов:


@Test
void optional_example() {
    Optional<String> value = Optional.of("hello");

    assertThat(value)
        .isPresent()
        .contains("hello");
}

@Test
void optional_empty() {
    Optional<String> value = Optional.empty();

    assertThat(value)
        .isEmpty();
}

@Test
void optional_value() {
    Object content = new Object();
    Optional<Object> value = Optional.of(content);

    assertThat(value)
        .hasValue(content);
}

Проверка сложных объектов с AssertJ - это песня! Например, нужно сделать несколько проверок сразу и только если все проходят, только тогда объект удовлетворяет условиям:


@Test
void custom_check() {
    User user = new User("Alex", 30);

    assertThat(user).satisfies(u -> {
        assertThat(u.name).startsWith("A");
        assertThat(u.age).isBetween(18, 60);
    });
}

Работа с исключениями в AssertJ - просто песня:


@Test
void exception_example() {
    assertThatThrownBy(() -> {
        throw new IllegalArgumentException("bad input");
    })
    .isInstanceOf(IllegalArgumentException.class)
    .hasMessageContaining("bad");
}

А какую библиотеку используете вы в своих проектах?

🔥11👍2❤1

280 views10:48