手順

1. mvn コマンドを使用して Maven プロジェクトをセットアップします。このコマンドは、プロジェクトのディレクトリー構造と pom.xml 設定ファイルを作成します。

   $ mvn archetype:generate                          \
   -DgroupId=org.jboss.as.quickstarts                \1
   -DartifactId=helloworld                           \2
   -DarchetypeGroupId=org.apache.maven.archetypes    \3
   -DarchetypeArtifactId=maven-archetype-webapp      \4
   -DinteractiveMode=false                            5

   1

   groupID はプロジェクトを一意に識別するものです。

   2

   artifactID は生成された jar アーカイブの名前です。

   3

   maven-archetype-webapp の groupID。

   4

   maven-archetype-webapp の artifactID。

   5

   対話モードを開始するのではなく、指定されたパラメーターを使用するように Maven に指示します。

2. 生成されたディレクトリーに移動します。

   $ cd helloworld

3. 生成された pom.xml 設定ファイルをテキストエディターで開きます。

4. pom.xml 設定ファイルの <project> セクション内にある <name>helloworld Maven Webapp</name> 行の後ろの内容を削除します。

   ファイルが次のようになっていることを確認します。

   <?xml version="1.0" encoding="UTF-8"?>
   
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
   
       <groupId>org.jboss.as.quickstarts</groupId>
       <artifactId>helloworld</artifactId>
       <version>1.0-SNAPSHOT</version>
       <packaging>war</packaging>
       <name>helloworld Maven Webapp</name>
   
   </project>

   内容を削除したのは、アプリケーションには不要なためです。

手順

1. アーティファクトリポジトリーを定義します。

   <project>
       ...
       <repositories>
           <repository>                                                                1
               <id>jboss-public-maven-repository</id>
               <name>JBoss Public Maven Repository</name>
               <url>https://repository.jboss.org/nexus/content/groups/public/</url>
               <releases>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </snapshots>
               <layout>default</layout>
           </repository>
           <repository>                                                                2
               <id>redhat-ga-maven-repository</id>
               <name>Red Hat GA Maven Repository</name>
               <url>https://maven.repository.redhat.com/ga/</url>
               <releases>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
                   <updatePolicy>never</updatePolicy>
               </snapshots>
               <layout>default</layout>
           </repository>
       </repositories>
   </project>

   1

   Red Hat GA Maven リポジトリーは、製品化されたすべての JBoss EAP アーティファクトとその他の Red Hat アーティファクトを提供します。

   2

   JBoss Public Maven リポジトリーは、WildFly Maven プラグインなどのアーティファクトを提供します。

2. プラグインリポジトリーを定義します。

   <project>
       ...
       <pluginRepositories>
           <pluginRepository>
               <id>jboss-public-maven-repository</id>
               <name>JBoss Public Maven Repository</name>
               <url>https://repository.jboss.org/nexus/content/groups/public/</url>
               <releases>
                  <enabled>true</enabled>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
           </pluginRepository>
           <pluginRepository>
               <id>redhat-ga-maven-repository</id>
               <name>Red Hat GA Maven Repository</name>
               <url>https://maven.repository.redhat.com/ga/</url>
               <releases>
                   <enabled>true</enabled>
               </releases>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
           </pluginRepository>
       </pluginRepositories>
   </project>

手順

1. pom.xml 設定ファイルの properties セクションに BOM バージョンのプロパティーを追加します。

   <properties>
       ....
       <version.bom.ee>${version.server}</version.bom.ee>
   </properties>

   プロパティー <version.server> で定義した値が、BOM バージョンの値として使用されます。

2. JBoss EAP BOM の依存関係管理をインポートします。

   <project>
       ...
       <dependencyManagement>
           <dependencies>
               <dependency>
                   <groupId>org.jboss.bom</groupId>                 1
                   <artifactId>jboss-eap-ee-with-tools</artifactId> 2
                   <version>${version.bom.ee}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
           </dependencies>
       </dependencyManagement>
   </project>

   1

   JBoss EAP が提供する BOM の GroupID。

   2

   JBoss EAP が提供する BOM の ArtifactID。この BOM は、サポートされている JBoss EAP Java EE API に加えて、追加の JBoss EAP API JAR およびクライアント BOM、および Arquillian などの開発ツールを提供します。

手順

1. <properties> セクションで、wildfly-maven-plugin および maven-war-plugin のバージョンを定義します。

   <properties>
       ...
       <version.plugin.wildfly>4.1.1.Final</version.plugin.wildfly>
       <version.plugin.war>3.3.2</version.plugin.war>
   </properties>

2. <project> セクション内の <build> セクションに <pluginManagement> を追加します。

   <project>
       ...
       <build>
           <pluginManagement>
               <plugins>
                   <plugin>    1
                       <groupId>org.wildfly.plugins</groupId>
                       <artifactId>wildfly-maven-plugin</artifactId>
                       <version>${version.plugin.wildfly}</version>
                   </plugin>
                   <plugin>                                  2
                       <groupId>org.apache.maven.plugins</groupId>
                       <artifactId>maven-war-plugin</artifactId>
                       <version>${version.plugin.war}</version>
                   </plugin>
               </plugins>
           </pluginManagement>
       </build>
   </project>

   1

   wildfly-maven-plugin を使用すると、wildfly:deploy コマンドを使用してアプリケーションを JBoss EAP にデプロイできます。

   2

   JDK17+ との互換性を確保するには、war プラグインのバージョンを管理する必要があります。

手順

1. アプリケーションのルートディレクトリーに移動します。

   アプリケーションのルートディレクトリーには、pom.xml 設定ファイルが含まれています。

2. 次のビルド設定を pom.xml 設定ファイルの <project> セクションに追加して、アプリケーションアーカイブファイル名を定義します。

   <build>
       ...
       <finalName>${project.artifactId}</finalName>        1
   </build>

   1

   デプロイメントの名前をプロジェクトのアーティファクト ID に設定します。

3. JBoss EAP デプロイプラグインを使用してアプリケーションをビルドおよびデプロイします。

   $ mvn package wildfly:deploy

手順

1. pom.xml 設定ファイルで次のプロパティーを定義します。

   <properties>
       ...
       <version.plugin.failsafe>3.2.2</version.plugin.failsafe>
   </properties>

2. テストに必要な依存関係を追加します。

   <project>
       ...
       <dependencies>
           ...
           <dependency>
              <groupId>junit</groupId>
              <artifactId>junit</artifactId>
              <scope>test</scope>
           </dependency>
       </dependencies>
   </project>

3. プロファイルを定義して、統合テストに必要なプラグインを追加します。

   <project>
       ...
       <profiles>
       ...
           <profile>
               <id>integration-testing</id>
               <build>
                   <plugins>
                       <plugin>
                           <groupId>org.apache.maven.plugins</groupId>
                           <artifactId>maven-failsafe-plugin</artifactId> 1
                           <version>${version.plugin.failsafe}</version>
                           <configuration>
                               <includes>
                                   <include>**/HelloWorldServletIT</include>       2
                               </includes>
                           </configuration>
                           <executions>
                               <execution>
                                  <goals>
                                      <goal>integration-test</goal>
                                      <goal>verify</goal>
                                  </goals>
                               </execution>
                           </executions>
                       </plugin>
                   </plugins>
               </build>
           </profile>
       </profiles>
   </project>

   1

   統合テストを実行するための Maven プラグイン。

   2

   アプリケーションをテストする Java クラスの名前。

手順

1. <application_home> ディレクトリーに移動します。

2. テストクラスを格納するディレクトリーを作成します。

   $ mkdir -p src/test/java/org/jboss/as/quickstarts/helloworld

3. 新しいディレクトリーに移動します。

   $ cd src/test/java/org/jboss/as/quickstarts/helloworld

4. デプロイメントをテストする Java クラス HelloWorldServletIT.java を作成します。

   package org.jboss.as.quickstarts.helloworld;
   
   import org.junit.Test;
   import java.io.IOException;
   import java.net.URI;
   import java.net.URISyntaxException;
   import java.net.http.HttpClient;
   import java.net.http.HttpRequest;
   import java.net.http.HttpResponse;
   import java.time.Duration;
   import static org.junit.Assert.assertEquals;
   
   public class HelloWorldServletIT {
   
       private static final String DEFAULT_SERVER_HOST = "http://localhost:8080/helloworld";                1
   
       @Test
       public void testHTTPEndpointIsAvailable() throws IOException, InterruptedException, URISyntaxException {
           String serverHost = System.getProperty("server.host");
           if (serverHost == null) {
               serverHost = DEFAULT_SERVER_HOST;
           }
           final HttpRequest request = HttpRequest.newBuilder()
                   .uri(new URI(serverHost+"/HelloWorld"))
                   .GET()
                   .build();                                                                                 2
           final HttpClient client = HttpClient.newBuilder()
                   .followRedirects(HttpClient.Redirect.ALWAYS)
                   .connectTimeout(Duration.ofMinutes(1))
                   .build();                                                                                 3
           final HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); 4
           assertEquals(200, response.statusCode());                                                         5
       }
   }

   1

   アプリケーションが実行されている URL。この値は sever.host が定義されていない場合に使用されます。

   2

   アプリケーション URI の HttpRequest インスタンスを作成します。

   3

   アプリケーションに要求を送信し、アプリケーションからの応答を受信するための HttpClient を作成します。

   4

   アプリケーションから応答を取得します。

   5

   アプリケーションから返される応答が "200" であることをテストして、アプリケーションが到達可能であることを示します。

手順

1. <application_home> ディレクトリーに移動します。

2. verify コマンドを使用して integration-testing プロファイルを指定し、統合テストを実行します。

   $ mvn verify -Pintegration-testing

   出力例

   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  9.982 s
   [INFO] Finished at: 2023-11-22T14:53:54+05:30
   [INFO] ------------------------------------------------------------------------

手順

1. 変更を Git リポジトリーにプッシュします。
2. <application_home> ディレクトリーに移動します。

3. verify コマンドを使用して、integration-testing プロファイルをアクティブ化し、アプリケーションへの URL を指定してテストを実行します。

   $ mvn verify -Pintegration-testing -Dserver.host=https://$(oc get route helloworld --template='{{ .spec.host }}')

   注記

   このテストでは、SSL/TLS を使用して、デプロイされたアプリケーションに接続します。したがって、テストを実行するマシンによって証明書が信頼されている必要があります。

   証明書を信頼するには、証明書を Java トラストストアに追加する必要があります。

   例

   $ keytool -trustcacerts -keystore _<path-to-java-truststore>_ -storepass _<trust-store-password>_ -importcert -alias _<alias-for-the-certificate>_ -file _<path-to-certificate>_/_<certificate-name>_

   出力例

   [INFO] Running org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.345 s -- in org.jboss.as.quickstarts.helloworld.HelloWorldServletIT
   [INFO]
   [INFO] Results:
   [INFO]
   [INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
   [INFO]
   [INFO]
   [INFO] --- maven-failsafe-plugin:3.2.2:verify (default) @ helloworld ---
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  2.984 s
   [INFO] Finished at: 2023-11-30T15:51:22+05:30
   [INFO] ------------------------------------------------------------------------