1.7. Quarkus アプリケーションのテスト

手順

1. 生成された pom.xml ファイルを開き、コンテンツを確認します。

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

   次のプロパティーの値に注意してください。

   • アプリケーションがテストで必ず正しいログマネージャーを使用するように、java.util.logging.manager システムプロパティーが設定されます。
   • maven.home プロパティーは、プロジェクトに適用するカスタム Maven 設定を保存できる settings.xml ファイルの場所を参照します。

2. 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 にアプリケーションを起動するよう指示します。

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

   ./mvnw test

   注記

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

   デフォルトでは、テストはポート 8081 で実行されるため、実行中のアプリケーションと競合しません。Quarkus では、RestAssured 依存関係はこのポートを使用するように設定されています。

   注記

   別のクライアントを使用する場合は、@TestHTTPResource アノテーションを使用して、テスト済みアプリケーションの URL を Test クラスのフィールドに直接注入します。このフィールドには、String、URL、または URI の型を使用できます。@TestHTTPResource アノテーションにテストパスを入力することもできます。たとえば、/myservlet にマップされたサーブレットをテストするには、以下の行をテストに追加します。

   @TestHTTPResource("/myservlet")
   URL testUrl;

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