# Java TestcontainersでMariaDBコンテナを使う方法

## 目次

1. はじめに

   1. Java Testcontainersとは

   2. MariaDBとは

2. 環境の準備

   1. 必要なツール

   2. プロジェクトのセットアップ

3. MariaDBコンテナの起動

   1. Testcontainersの依存関係

   2. MariaDBコンテナのコード例

4. MariaDBへの接続と操作

   1. 接続方法

   2. テーブルの作成とデータの操作

5. 実践的な使用例

   1. 単体テストでの利用

   2. CI/CDパイプラインでの活用

6. トラブルシューティング

   1. よくある問題

   2. デバッグの手法

7. まとめ

## 1. はじめに

### 1-1. Java Testcontainersとは

Java Testcontainersは、JVM開発者向けのライブラリで、Dockerコンテナを利用したテスト環境を簡単に構築できます。これにより、外部のデータベースやサービスをモックすることが容易になり、テストの信頼性と柔軟性が向上します。

### 1-2. MariaDBとは

MariaDBは、高性能で、安全かつ多用途なデータベース管理システムであり、MySQLの代替品として広く利用されています。オープンソースであり、豊富な機能を備えていることから、多くのプロジェクトで採用されています。

## 2. 環境の準備

### 2-1. 必要なツール

まず、Java（バージョン11以上）、Maven、Dockerが必要です。これらが既にインストールされていることを確認してください。

### 2-2. プロジェクトのセットアップ

以下のように、Mavenプロジェクトを作成します。

```bash

mvn archetype:generate -DgroupId=com.example -DartifactId=testcontainers-mariadb -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

```

次に、`pom.xml`に依存関係を追加します。

```xml

<dependencies>

    

    <dependency>

        <groupId>org.testcontainers</groupId>

        <artifactId>testcontainers</artifactId>

        <version>1.17.3</version>

    </dependency>

    <dependency>

        <groupId>org.testcontainers</groupId>

        <artifactId>mariadb</artifactId>

        <version>1.17.3</version>

    </dependency>

    

    <dependency>

        <groupId>junit</groupId>

        <artifactId>junit</artifactId>

        <version>4.13.2</version>

        <scope>test</scope>

    </dependency>

    

    <dependency>

        <groupId>org.mariadb.jdbc</groupId>

        <artifactId>mariadb-java-client</artifactId>

        <version>3.0.5</version>

    </dependency>

</dependencies>

```

## 3. MariaDBコンテナの起動

### 3-1. Testcontainersの依存関係

MariaDB用のTestcontainersモジュールを使用して、MariaDBコンテナの設定を行います。

### 3-2. MariaDBコンテナのコード例

以下のコードでMariaDBコンテナを起動します。

```java

import org.testcontainers.containers.MariaDBContainer;

import org.junit.After;

import org.junit.Before;

import org.junit.Test;

import static org.junit.Assert.*;

public class MariaDBTest {

    private MariaDBContainer<?> mariaDBContainer;

    @Before

    public void setUp() {

        mariaDBContainer = new MariaDBContainer<>("mariadb:10.6.4")

                              .withDatabaseName("testDB")

                              .withUsername("user")

                              .withPassword("password");

        mariaDBContainer.start();

    }

    @Test

    public void testConnection() {

        assertTrue(mariaDBContainer.isRunning());

    }

    @After

    public void tearDown() {

        mariaDBContainer.stop();

    }

}

```

このコードにより、`mariadb:10.6.4`のイメージを使用してコンテナが起動され、テスト用のデータベースが作成されます。

## 4. MariaDBへの接続と操作

### 4-1. 接続方法

MariaDBコンテナの起動後、JDBC接続URLを取得してデータベースに接続します。

```java

String jdbcUrl = mariaDBContainer.getJdbcUrl();

```

### 4-2. テーブルの作成とデータの操作

JDBCを使用してデータベース操作を行います。

```java

import java.sql.Connection;

import java.sql.DriverManager;

import java.sql.Statement;

public class MariaDBOperations {

    public static void main(String[] args) throws Exception {

        MariaDBContainer<?> mariaDBContainer = new MariaDBContainer<>("mariadb:10.6.4")

                .withDatabaseName("testDB")

                .withUsername("user")

                .withPassword("password");

        mariaDBContainer.start();

        Connection conn = DriverManager.getConnection(

                mariaDBContainer.getJdbcUrl(),

                mariaDBContainer.getUsername(),

                mariaDBContainer.getPassword());

        Statement stmt = conn.createStatement();

        stmt.execute("CREATE TABLE users (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50), email VARCHAR(50))");

        

        stmt.execute("INSERT INTO users (name, email) VALUES ('John Doe', 'john@example.com')");

        

        conn.close();

        mariaDBContainer.stop();

    }

}

```

このプログラムは、`users`テーブルを作成し、サンプルデータを挿入します。

## 5. 実践的な使用例

### 5-1. 単体テストでの利用

Testcontainersは、テストごとにクリーンなデータベース環境を提供できるため、単体テストで特に威力を発揮します。

### 5-2. CI/CDパイプラインでの活用

Testcontainersは、CICD環境で使うことで環境設定が不要になるため、テストステージの効率化が進みます。

## 6. トラブルシューティング

### 6-1. よくある問題

- コンテナが起動しない場合、Dockerサービスが実行中であることを確認してください。

- ポートの競合がある場合、ポートを指定して回避します。

### 6-2. デバッグの手法

コンテナのログを確認することで問題の原因を特定できます。

```java

System.out.println(mariaDBContainer.getLogs());

```

## 7. まとめ

今回、Testcontainersを使用してJavaでMariaDBコンテナをセットアップする手順を解説しました。この方法を用いることで、開発環境をよりクリーンかつ簡潔にし、テストプロセスを効率化できます。特に、迅速かつ正確なテストを求める現代の開発環境において、この実践的なアプローチは非常に役立ちます。

Java TestcontainersでMariaDBコンテナを使う方法

目次

続きを読むには単価診断を受けてください（30秒）