Логотип Хекслета

Java: Продвинутое использование

Теория: Testcontainers

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

  • Несоответствие окружений. Разработчики могут использовать разные версии базы данных на своих локальных машинах, что приводит к проблемам с совместимостью и ошибкам, которые сложно воспроизвести. У одного разработчика может работать, а у другого - нет.
  • Сложность настройки. Установка базы данных локально на свой компьютер и ее настройка ее может быть сложной и занимать много времени. Это может привести к тому, что тесты будут запускаться не регулярно или вообще игнорироваться.
  • Изоляция тестов. Тесты могут влиять друг на друга, если они используют одну и ту же базу данных, что может привести к ложным срабатываниям и затруднить отладку.

Для решения этих проблем существует библиотека TestContainers. Она предоставляет простой и удобный способ работы с Docker контейнерами в тестах

TestContainers — это библиотека для Java, которая позволяет разработчикам создавать и управлять Docker контейнерами прямо в коде тестов. Она особенно полезна для интеграционного тестирования, когда необходимо взаимодействовать с внешними сервисами, такими как базы данных или очереди сообщений.

TestContainers позволяет автоматически загружать, настраивать и запускать контейнеры в тестах. При помощи аннотаций можно создать контейнер с PostgreSQL, который будет автоматически запущен перед выполнением тестов и остановлен после их завершения. Это значительно экономит время и ресурсы

Каждый тест в такой ситуации может запускать свой собственный контейнер с нужной версией базы данных. Это гарантирует, что все тесты у всех разработчиков выполняются в одинаковых условиях, что устраняет проблемы с несовместимостью.

Чтобы начать пользоваться библиотекой, нужно добавить зависимости в файл build.gradle.kts

// Эта зависимость необходима для интеграции TestContainer с JUnit 5
testImplementation("org.testcontainers:junit-jupiter:1.20.6")
// Основная зависимость библиотеки
testImplementation("org.testcontainers:testcontainers:1.20.6")
// Эта зависимость предоставляет поддержку для создания контейнеров PostgreSQL и настройки базы
testImplementation("org.testcontainers:postgresql:1.20.6")

Напишем простой тест для приложения, которое использует базу данных PostgreSQL, и на этом примере разберемся подобнее, как работать с TestContainers

@SpringBootTest
@AutoConfigureMockMvc

// Аннотация позволяет автоматически запускать и останавливать в тестах все контейнеры
@Testcontainers
public class AppTest {

    @Autowired
    private MockMvc mockMvc;

    @Autowired
    private PersonRepository personRepository;

    // Аннотация отмечает контейнер, который будет автоматически запущен
    @Container
    // Создаём контейнер с СУБД PostgreSQL
    // В конструктор передаём имя образа, который будет скачан с Dockerhub
    // Если не указать версию, будет скачана последняя версия образа
    private static PostgreSQLContainer<?> database = new PostgreSQLContainer<>("postgres")
        // Создаём базу данных с указанным именем
        .withDatabaseName("dbname")
        // Указываем имя пользователя и пароль
        .withUsername("sa")
        .withPassword("sa")
        // Скрипт, который будет выполнен при запуске контейнера, если вдруг нужно создать схему или наполнить базу
        .withInitScript("script.sql");

    // Так как мы не можем знать заранее, какой URL будет у базы данных в контейнере
    // Нам потребуется установить это свойство динамически
    @DynamicPropertySource
    public static void properties(DynamicPropertyRegistry registry) {
        // Устанавливаем URL базы данных
        registry.add("spring.datasource.url", database::getJdbcUrl);
        // Имя пользователя и пароль для подключения
        registry.add("spring.datasource.username", database::getUsername);
        registry.add("spring.datasource.password", database::getPassword);
        // Эти значения приложение будет использовать при подключении к базе данных
    }

    @BeforeEach
    public void setUp() {
        // Очищаем базу перед каждым тестом
    }

    // Тестируем приложение
    @Test
    void testCreatePerson() throws Exception {
        // Добавляем нового пользователя
        MockHttpServletResponse responsePost = mockMvc
            .perform(
                post("/people")
                    .contentType(MediaType.APPLICATION_JSON)
                    .content("{\"name\": \"\", \"email\": \"jackson@mail.com\"}")
            )
            .andReturn()
            .getResponse();

        assertThat(responsePost.getStatus()).isEqualTo(201);

        // И проверяем, что пользователь добавился в базу
        var person = personRepository.findByEmail("jackson@mail.com").orElse(null);
        assertThat(person).isNotNull();
        assertThat(person.getName()).isEqualTo("Jackson");
    }

    // Остальные тесты
}
Навигация
Теория
Тесты