流程

1. 删除任何 Thorntail BOM 导入。

   从 pom .xml 文件中删除 theio.thorntail Thorntail BOM 导入的示例：

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>io.thorntail</groupId>
         <artifactId>bom</artifactId>
         <version>${version.thorntail}</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>

2. 使用 JBoss EAP XP BOM 将受支持的构件导入到 JBoss EAP XP 依赖关系管理。

   使用 jboss-eap-jakartaee8-with-tools BOM 将支持的工件导入到项目中的示例。

   <dependencyManagement>
           <dependencies>
               <!-- importing the jakartaee8-with-tools BOM adds specs and other useful artifacts as managed dependencies -->
               <dependency>
                   <groupId>org.jboss.bom</groupId>
                   <artifactId>jboss-eap-jakartaee8-with-tools</artifactId>
                   <version>${version.server.bom}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
               <!-- importing the microprofile BOM adds MicroProfile specs -->
               <dependency>
                   <groupId>org.jboss.bom</groupId>
                   <artifactId>jboss-eap-xp-microprofile</artifactId>
                   <version>${version.microprofile.bom}</version>
                   <type>pom</type>
                   <scope>import</scope>
               </dependency>
           </dependencies>
       </dependencyManagement>

   注意

   仅当应用依赖于 MicroProfile 平台中未包含的 Jakarta EE 8 规范时，导入 jakartaee8-with-tools BOM。

3. 将 Thorntail Maven 插件替换为 JBoss EAP XP 可引导 JAR Maven 插件。

   演示如何将 Thorntail Maven 插件替换为 JBoss EAP XP 可引导 JAR Maven 插件。

   <plugin>
      <groupId>org.wildfly.plugins</groupId>
      <artifactId>wildfly-jar-maven-plugin</artifactId>
      <version>${bootable.jar.maven.plugin.version}</version>
      <configuration>
         <feature-pack-location>${org.jboss.eap:wildfly-galleon-pack:${jboss.xp.galleon.feature.pack.version}</feature-pack-location>
         <layers>
            <layer>microprofile-platform</layer>
         </layers>
      </configuration>
      <executions>
         <execution>
            <goals>
               <goal>package</goal>
            </goals>
         </execution>
      </executions>
   </plugin>

   注意

   上例为 Maven 插件版本指定以下属性：

   ${bootable.jar.maven.plugin.version}

   您必须将 Maven 插件版本设置为在项目中替换此属性。例如：

   <properties>
       <bootable.jar.maven.plugin.version>4.0.3.Final-redhat-00001</bootable.jar.maven.plugin.version>
   </properties>

   • 可引导 JAR 插件默认构建 UberJAR，这意味着它将 JBoss EAP XP 运行时与所部署的应用进行打包。要构建 hollow JAR，请在插件配置中添加 <hollow-jar>true</hollow-jar >。

4. 对 Maven 项目中的 Thorntail 部分进行以下更改：

   1. 删除 Thorntail 部分依赖项。

      显示从 Maven 项目删除 the io.thorntail Thorntail 部分的示例。

      <dependencies>
        <dependency>
          <groupId>io.thorntail</groupId>
          <artifactId>jaxrs</artifactId>
        </dependency>
      </dependencies>

   2. 配置 Maven 依赖项。

      使用 XML 代码段添加依赖项到 Jakarta EE 8 JAX-RS 和 MicroProfile Config API 的构件的示例。

      <dependencies>
          <!-- Import the MicroProfile Config API, we use provided scope as the API is included in the server -->
          <dependency>
            <groupId>org.eclipse.microprofile.config</groupId>
            <artifactId>microprofile-config-api</artifactId>
            <scope>provided</scope>
          </dependency>
          <!-- Import the Jakarta REST API, we use provided scope as the API is included in the server -->
          <dependency>
            <groupId>org.jboss.spec.javax.ws.rs</groupId>
            <artifactId>jboss-jaxrs-api_2.1_spec</artifactId>
            <scope>provided</scope>
          </dependency>
        </dependencies>

   3. 删除 Thorntail YAML 文件、系统属性和环境属性。

   4. 配置 Galleon 层.

      为需要 JAX-RS 的应用在可引导 JAR Maven 插件中配置 Galleon 层的示例：

      <plugin>
        <groupId>org.wildfly.plugins</groupId>               <artifactId>wildfly-jar-maven-plugin</artifactId>                  <configuration>
         ...
            <layers>
              <layer>jaxrs-server</layer>
              <layer>microprofile-platform</layer>
            </layers>
        </configuration>
         ...
      </plugin>