spring-boot-extend.md

easyj-maven-plugin : spring-boot-extend

说明：

必须与 spring-boot-maven-plugin 插件一起使用，提供一些 spring-boot 应用所需的功能。

1. 主要 spring-boot-maven-plugin 官方竟然不给支持 includeGroupIds，无奈之下，只好自己开发该功能。
2. 外置 lib 打包成 lib.zip 功能，同时提供共用lib分离到 lib-common\ 目录下的功能。

关联spring-boot官方issue和PR：

1. spring-boot.issue#12794（Closed）：The spring-boot-maven-plugin not provide includeGroupIds.
2. spring-boot.pr#12813（Closed）：Add support for includeGroupIds.

起始版本：

v0.6.8 版本新增的插件。

最新版本：

使用方法：

暂无！请根据下面的plugin配置说明，直接去尝试吧。

plugin配置：

<build>
    <plugins>
        <plugin>
            <groupId>icu.easyj.maven.plugins</groupId>
            <artifactId>easyj-maven-plugin</artifactId>
            <version>${easyj-maven-plugin.version}</version>
            <configuration>
                <!-- 是否跳过install插件，默认：false -->
                <skipInstall>false</skipInstall>
                <!-- 是否跳过deploy插件，默认：false -->
                <skipDeploy>false</skipDeploy>

                <!-- 以下groupId的JARs，会打包在spring-boot的fatJar中。 -->
                <includeGroupIds>${project.groupIds}, com.aaa, com.bbb</includeGroupIds>
                <!-- 增量的includeGroupIds，用于单个项目配置，includeGroupIds可在公司框架中统一配置。（v1.0.4 新特性） -->
                <additionalIncludeGroupIds>com.ccc, com.ddd</additionalIncludeGroupIds>
                <!--
                   通用依赖的匹配串，支持配置完整groupId:artifactId、通配符、正则表达式。
                   匹配到的依赖，会被复制到 /target/lib-common/ 目录下，并打包进 lib-common.zip 中。
                -->
                <commonDependencyPatternSet>
                    <pattern>icu.easyj:easyj-all</pattern>
                    <pattern>icu.easyj:*</pattern>
                    <pattern>^icu\.easyj\:easyj\-.*$</pattern>
                </commonDependencyPatternSet>
                <!-- 是否打包外置lib到 /target/lib.zip 中，默认：true -->
                <zipLib>true</zipLib>
                <!-- 是否创建lib.history.md文件，记录外置lib历史信息，用于在每次打包时，如果外置lib有变更，提醒开发人员此次需要更新外置lib。（默认：true） -->
                <createLibHistory>true</createLibHistory>

                <!-- 是否创建 startup.bat 和 startup.sh 文件 -->
                <needCreateStartupFile>true</needCreateStartupFile>
                <!-- startup脚本，可用变量：{loaderPath}、{finalName}、{artifactId}，注意变量前面没有 '$'. （以下为默认值） -->
                <startupScript>
                    java -Xms64m -Xmx128m ^
                         -jar ^
                         {loaderPath} ^
                         -Dspring.profiles.active={activeProfile} ^
                         -Dspring.config.location=application.yml ^
                         -Dspring.config.additional-location=application-{activeProfile}.yml ^
                         {startupScriptAdditionalParameter} ^
                         {finalName}.jar
                </startupScript>
                <!-- 启动脚本补充参数，用于替换startupScript中的占位符 {startupScriptAdditionalParameter}。（默认为空） -->
                <startupScriptAdditionalParameter>
                    -Dxxxxxxx.xxxxx=a ^
                    -Dyyyyyyy.yyyyy=b
                </startupScriptAdditionalParameter>
                <!-- 激活环境名，用于替换startupScript中的占位符 {activeProfile}（默认：prod） -->
                <activeProfile>prod</activeProfile>
            </configuration>
            <executions>
                <execution>
                    <id>spring-boot-extend</id>
                    <!-- 或 `<phase>package</phase>`，如果晚于 `spring-boot-maven-plugin:repackage`，则使用prepare-package -->
                    <phase>prepare-package</phase>
                    <goals>
                        <goal>spring-boot-extend</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <!-- 必须与spring-boot-maven-plugin一起使用，建议easyj插件配置在前面 -->
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>${spring-boot.version}</version>
            <configuration>
                <skip>${maven.boot.skip}</skip>
                <attach>false</attach>
                <layout>ZIP</layout> <!-- 要想使用-Dloader.path引用外置lib目录，必须将此配置设置为ZIP -->
                <mainClass>${start-class}</mainClass>
            </configuration>
            <executions>
                <execution>
                    <id>repackage</id>
                    <phase>package</phase>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>