第6章 JUnit を使用した Quarkus アプリケーションのテスト

手順

1. Surefire Maven プラグインのバージョンを設定します。

   <plugin>
       <artifactId>maven-surefire-plugin</artifactId>
       <version>${surefire-plugin.version}</version>
       <configuration>
          <systemProperties>
            <java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
          </systemProperties>
       </configuration>
   </plugin>

   デフォルトの Surefire Maven プラグインバージョンは、JUnit 5 をサポートしません。

2. java.util.logging システムプロパティーを設定して、テストが適切なログマネージャーを使用するようにします。

3. src/test/java/org/acme/quickstart/GreetingResourceTest.java ファイルを以下の内容に一致するように編集します。

   package org.acme.quickstart;
   
   import io.quarkus.test.junit.QuarkusTest;
   import org.junit.jupiter.api.Test;
   
   import java.util.UUID;
   
   import static io.restassured.RestAssured.given;
   import static org.hamcrest.CoreMatchers.is;
   
   @QuarkusTest
   public class GreetingResourceTest {
   
       @Test
       public void testHelloEndpoint() {
           given()
             .when().get("/hello")
             .then()
                .statusCode(200)
                .body(is("hello"));
       }
   
       @Test
       public void testGreetingEndpoint() {
           String uuid = UUID.randomUUID().toString();
           given()
             .pathParam("name", uuid)
             .when().get("/hello/greeting/{name}")
             .then()
               .statusCode(200)
               .body(is("hello " + uuid));
       }
   
   }

   注記

   QuarkusTest ランナーを使用することで、テストを開始する前に JUnit にアプリケーションを起動するよう指示します。

4. Maven からこれらのテストを実行するには、以下のコマンドを入力します。

   ./mvnw test

   注記

   IDE からテストを実行することもできます。その場合は、最初にアプリケーションを停止してください。

   デフォルトでは、テストはポート 8081 で実行されるため、実行中のアプリケーションと競合しません。Quarkus では、RestAssured 依存関係はこのポートを使用するように設定されています。別のクライアントを使用する場合は、@TestHTTPResource アノテーションを使用して、テスト済みアプリケーションの URL を Test クラスのフィールドに直接インジェクトします。このフィールドには、タイプ string、URL、または URI を使用できます。このアノテーションにテストパスを指定することもできます。たとえば、/myservlet にマップされたサーブレットをテストするには、以下の行をテストに追加します。

   @TestHTTPResource("/myservlet")
   URL testUrl;

5. 必要な場合は、quarkus.http.test-port 設定プロパティーにテストポートを指定します。