流程

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. 在 <name& gt; helloworld Maven Webapp</name> 行后，删除 pom.xml 配置文件的 <project > 部分的内容。

   确保文件类似如下：

   <?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 和其他红帽工件。

   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&gt; 中定义的值用作 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，它提供受支持的 JBoss EAP Java EE API，以及额外的 JBoss EAP API JAR 和客户端 BOM 以及 JAAS 等开发工具。

流程

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. 在 & lt; project> 部分的 <build& gt; 部分添加 <pluginManagement & gt;。

   <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 将应用程序部署到 JBoss EAP，使用 wildfly:deploy 命令。

   2

   您需要管理 war 插件版本，以确保与 JDK17+ 兼容。

流程

1. 导航到应用程序根目录。

   应用根目录包含 pom.xml 配置文件。

2. 将以下构建配置添加到 < project > 部分中的 pom.xml 配置文件，以定义应用程序存档文件名。

   <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. 使用带有 integration-testing 配置集的 verify 命令运行集成测试。

   $ 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 信任存储中。

   Example

   $ 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] ------------------------------------------------------------------------