3장. Thorntail 애플리케이션 Maven 프로젝트 마이그레이션

절차

1. 모든 Thorntailoctets 가져오기를 제거합니다.

   pom.xml 파일에서 io.thorntail Thorntail RuntimeClass 가져오기를 제거하는 예.

   <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 XPoctetss를 사용하여 지원되는 아티팩트를 JBoss EAP XP 종속성 관리로 가져옵니다.

   jboss-eap-jakartaee8-with-tools octets를 사용하여 지원되는 아티팩트를 프로젝트로 가져오는 예.

   <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 1.8.0을 가져옵니다.

3. Thorntail Maven 플러그인을 JBoss EAP XP 부팅 가능한 JAR Maven 플러그인으로 교체합니다.

   JBoss EAP XP 부팅 가능한 JAR Maven 플러그인과 Thorntail 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 플러그인은 기본적으로berJAR를 빌드하므로 배포된 애플리케이션과 함께 JBoss EAP XP 런타임을 패키지화합니다. hollow JAR을 빌드하려면 <hollow-jar>true</hollow-jar> 를 플러그인 구성에 추가합니다.

4. Maven 프로젝트에서 Thorntail 부분 부분을 다음과 같이 변경합니다.

   1. Thorntail fraction 종속성을 제거합니다.

      Maven 프로젝트에서 io.thorntail Thorntail 분수의 제거를 보여주는 예.

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

   2. Maven 종속 항목을 구성합니다.

      XML 스니펫을 사용하여 Jakarta EE 8 rsh-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 레이어를 구성합니다.

      rsh-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>