工程地址

简介

Spring Boot 和 SOFABoot 都可以使用 Jarslink2.0，只需要添加指定依赖即可。为了使用便利，推荐以 SOFABoot 工程形式使用 Jarslink2.0。本样例工程意在演示如何快速的将 Spring Boot 工程改造成 SOFABoot 工程。

改造

在 Spring Boot 官网创建好一个 Spring Boot 的工程之后，接下来只需要引入 SOFABoot 的依赖，首先修改 maven 项目的配置文件 pom.xml，将

  1. <parent>
  2.     <groupId>org.springframework.boot</groupId>
  3.     <artifactId>spring-boot-starter-parent</artifactId>
  4.     <version>${spring.boot.version}</version>
  5.     <relativePath/> 
  6. </parent>

替换为

  1. <parent>
  2.     <groupId>com.alipay.sofa</groupId>
  3.     <artifactId>sofaboot-dependencies</artifactId>
  4.     <version>2.5.0-SNAPSHOT</version>
  5. </parent>

注意: 目前 Jarslink 2.0.0 还处于快照版本，它依赖的 SOFABoot 2.5.0 版本也将近期发布，目前需要引入 SOFABoot 2.5.0-SNAPSHOT 版本依赖。SNAPSHOT 包拉取需要特殊的配置，详细请参考FAQ: 如何配置拉取 SNAPSHOT 依赖包

然后，添加一个 Spring Boot 官方或者 SOFABoot 官方的 Starter,如：

  1. <dependencies>
  2.     <!-- Jarslink2.0 -->
  3.     <dependency>
  4.         <groupId>com.alipay.sofa</groupId>
  5.         <artifactId>sofa-jarslink-ark-starter</artifactId>
  6.         <classifier>ark-plugin</classifier>
  7.         <version>2.0.0-SNAPSHOT</version>
  8.     </dependency>
  10.     <!-- Web -->
  11.     <dependency>
  12.         <groupId>org.springframework.boot</groupId>
  13.         <artifactId>spring-boot-starter-web</artifactId>
  14.     </dependency>
  15. </dependencies>

为了将应用打包成 Ark 包或者 Biz 包，需要在主 pom.xml 文件中，配置 sofa-ark-maven-plugin 打包插件，注意请删除 Spring Boot 原生的打包插件配置:

  1. <build>
  2.     <plugins>
  3.         <plugin>
  4.             <groupId>com.alipay.sofa</groupId>
  5.             <artifactId>sofa-ark-maven-plugin</artifactId>
  6.             <executions>
  7.                 <execution>
  8.                     <!--goal executed to generate executable-ark-jar -->
  9.                     <goals>
  10.                         <goal>repackage</goal>
  11.                     </goals>
  13.                     <configuration>
  14.                         <!--specify destination where executable-ark-jar will be saved, default saved to ${project.build.directory}-->
  15.                         <outputDirectory>./target</outputDirectory>
  17.                         <!--default none-->
  18.                         <arkClassifier>executable-ark</arkClassifier>
  19.                     </configuration>
  20.                 </execution>
  21.             </executions>
  22.         </plugin>
  23.     </plugins>
  24. </build>

最后，在工程的 application.properties 文件下添加一个 SOFABoot 必须要使用的参数，包括spring.application.name 用于标示当前应用的名称；logging path 用于指定日志的输出目录。

  1. # Application Name
  2. spring.application.name=spring-boot-transform-sample
  4. # logging path
  5. logging.path=./logs

如此，即将一个普通的 Spring Boot 工程改造成了一个 SOFABoot 工程，并集成了 Jarslink2.0 组件。

运行

由于在打包插件配置了输出目录为 ./target，因此在应用根目录执行 mvn clean install 命令之后，会发现在 ./target 目录中生成了应用打包后的 Ark 包和 Biz包，形如：

  • spring-boot-transform-sample-${version}-executable-ark.jar 这是 Ark 包
  • spring-boot-transform-sample-${version}-ark-biz.jar 这是 Biz 包

使用 java -jar 即可启动该 Ark 包。更多关于打包信息请查看应用打包。