关于java:使用SOFABootSOFAArk进行模块化开发

Demo地址

SOFAArk相干

Ark包 = Ark容器 + Ark插件 + Biz包
Ark包：能够了解为宿主利用，打包后生成的可执行Jar包，jar包后缀为-ark-executable.jar
Biz包：每个模块都是一个biz包，biz包的后缀为-ark-biz.jar，biz包能够间接在已有的Ark容器中装置（当初通过API的形式）

API：ArkClient蕴含的针对Biz包的装置、卸载、切换版本性能，demo中提供了三个接口对其进行操作。

@RequestMapping(value = "/installBiz", method = RequestMethod.POST)
public void installBiz(String url) throws Throwable {
    ArkClient.installBiz(new File(url));
}

@RequestMapping(value = "/uninstallBiz", method = RequestMethod.POST)
public void uninstallBiz(String bizName, String bizVersion) throws Throwable {
    ArkClient.uninstallBiz(bizName, bizVersion);
}

@RequestMapping(value = "/switchBiz", method = RequestMethod.POST)
public void switchBiz(String bizName, String bizVersion) {
    ArkClient.switchBiz(bizName, bizVersion);
}

如果是Controller层为一个Biz包，那么如果须要公布更新，则须要进行该Biz包的Spring服务后再调用installBiz办法。

SOFAArk配置：
- 在我的项目的整体目录下须要创立conf/ark文件夹
- conf/ark/bootstrap.properties 是 SOFAArk 容器默认启动配置文件（官网文档）
- 多模块开发中配置文件中必须指定宿主利用
```
com.alipay.sofa.ark.master.biz=master-module
```
模块化开发相干文档：
- JVM 服务公布与援用：模块隔离后如何相干调用
- 蚂蚁金服的业务零碎模块化之模块化隔离计划
- 基于 SOFABoot 进行模块化开发

Maven配置

在工程主pom.xml中，批改parent为

<parent>
   <groupId>com.alipay.sofa</groupId>
   <artifactId>sofaboot-dependencies</artifactId>
   <version>3.2.2</version>
   <relativePath/> <!-- lookup parent from repository -->
</parent>

宿主利用pom.xml中，增加依赖

<dependency>
    <groupId>com.alipay.sofa</groupId>
    <artifactId>runtime-sofa-boot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.alipay.sofa</groupId>
    <artifactId>sofa-ark-springboot-starter</artifactId>
</dependency>
<dependency>
    <groupId>com.alipay.sofa</groupId>
    <artifactId>web-ark-plugin</artifactId>
</dependency>

增加打包插件

<build>
    <plugins>
        <!-- 这里配置动静模块打包插件 -->
        <plugin>
            <groupId>com.alipay.sofa</groupId>
            <artifactId>sofa-ark-maven-plugin</artifactId>
            <executions>
                <execution>
                    <id>default-cli</id>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <priority>100</priority>
                <baseDir>../</baseDir>
                <bizName>demo</bizName>
            </configuration>
        </plugin>
    </plugins>
</build>

业务模块pom.xml中，增加依赖

<dependency>
    <groupId>com.alipay.sofa</groupId>
    <artifactId>sofa-ark-springboot-starter</artifactId>
</dependency>

增加打包插件（如果是Controller层的模块，须要指定webContextPath）

<build>
    <plugins>
        <!--这里增加ark 打包插件-->
        <plugin>
            <groupId>com.alipay.sofa</groupId>
            <artifactId>sofa-ark-maven-plugin</artifactId>
            <executions>
                <execution>
                    <!--goal executed to generate executable-ark-jar -->
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                    <!--ark-biz 包的打包配置  -->
                    <configuration>
                        <!--是否打包、装置和公布 ark biz，具体参考 Ark Biz 文档，默认为false-->
                        <attach>true</attach>
                        <!--ark 包和 ark biz 的打包寄存目录，默认为工程 build 目录-->
                        <outputDirectory>target</outputDirectory>
                        <!--default none-->
                        <arkClassifier>executable-ark</arkClassifier>
                        <!-- ark-biz 包的启动优先级，值越小，优先级越高-->
                        <priority>200</priority>
                        <!--设置利用的根目录，用于读取 ${base.dir}/conf/ark/bootstrap.application 配置文件，默认为 ${project.basedir}-->
                        <baseDir>../</baseDir><!--针对 Web 利用，设置 context path，默认为 /-->
                        <webContextPath>/one</webContextPath>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

公共Service实现类的模块，须要配置如下打包插件

<build>
    <plugins>
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
        <!--这里增加ark 打包插件-->
        <plugin>
            <groupId>com.alipay.sofa</groupId>
            <artifactId>sofa-ark-maven-plugin</artifactId>
            <executions>
                <execution>
                    <!--goal executed to generate executable-ark-jar -->
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                    <!--ark-biz 包的打包配置  -->
                    <configuration>
                        <!--是否打包、装置和公布 ark biz，具体参考 Ark Biz 文档，默认为false-->
                        <attach>true</attach>
                        <!--ark 包和 ark biz 的打包寄存目录，默认为工程 build 目录-->
                        <outputDirectory>target</outputDirectory>
                        <!--default none-->
                        <arkClassifier>executable-ark</arkClassifier>
                        <!-- ark-biz 包的启动优先级，值越小，优先级越高-->
                        <priority>200</priority>
                        <!--设置利用的根目录，用于读取 ${base.dir}/conf/ark/bootstrap.application 配置文件，默认为 ${project.basedir}-->
                        <baseDir>../</baseDir>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

如何开发？

通过SOFA容器注入Service
- 接口实现类上必须增加@SofaService注解
- 在注入时须要应用@SofaReference注解注入，而不是应用@Autowired或[@Resource](https://my.oschina.net/u/929718)
- 业务模块（mng）须要引入Service接口模块，不须要在pom中引入Service实现模块，Service实现类所在模块须要在SOFA容器中启动
- Service实现模块（provider）和业务模块（mng）的包名统一（如果配置spring扫描包的地位可能不须要统一，但我没尝试胜利）
业务模块本身的逻辑依照失常的开发即可
在IDE中开发时，须要在业务模块（mng）的pom.xml中引入Service实现模块（provider）后，即可间接启动mng模块进行开发。
```
<dependency>
    <groupId>io.sofastack</groupId>
    <artifactId>dynamic-provider</artifactId>
    <version>2.0.0</version>
</dependency>
```

如何发版？

宿主利用的pom.xml中引入公共Service实现类模块，该模块能够在不重启宿主利用的状况下更新代码。例如：

<dependency>
    <groupId>io.sofastack</groupId>
    <artifactId>dynamic-provider</artifactId>
    <version>2.0.0</version>
    <classifier>ark-biz</classifier>
</dependency>

Service实现类模块发版
- pom.xml中批改version版本，例如：1.0.0批改为2.0.0
- 应用maven的clean package打包，打包后的...biz.jar文件即为Biz包
- 调用installBiz接口装置此2.0.0的biz包
- 装置胜利后，调用switchBiz接口切换至2.0.0版本即可
- 如果旧版本不须要应用，则能够调用uninstallBiz接口卸载对应版本
Controller模块发版
- 应用maven的clean package打包，打包后的...biz.jar文件即为Biz包
- 调用进行Spring Boot服务的办法，进行以后模块的服务
- 调用installBiz接口装置新的biz包

关于java:使用SOFABootSOFAArk进行模块化开发

Demo地址

SOFAArk相干

Maven配置

如何开发？

如何发版？

评论

发表回复取消回复

更多文章

DDN HPC 存储硬件架构设计深度分析

探秘IO500：从Lustre并行文件系统出发，开启HPC存储性能新征程

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

关于java:使用SOFABootSOFAArk进行模块化开发

Demo地址

SOFAArk相干

Maven配置

如何开发？

如何发版？

评论

发表回复 取消回复

更多文章

DDN HPC 存储硬件架构设计深度分析

探秘IO500：从Lustre并行文件系统出发，开启HPC存储性能新征程

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

发表回复取消回复