Spring Boot 多模块与 Maven 私有仓库
前言
系统复杂了，抽离单一职责的模块几乎是必须的；若需维护多个项目，抽离公用包上传私有仓库管理也几乎是必须的。其优点无需赘述，以下将记录操作过程。
1. 多模块拆分
在.NET 中由于其统一性，实现上更自然一点。Spring Boot 通过 Maven 构建多模块工程也不麻烦，假如我的项目中包含以下几个包：
我需要将他们分别拆分成独立模块，首先要修改的是根目录下的 pom.xml，packaging 类型改为 pom，并添加 modules 节点:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>com.youclk.multi-package<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>parent<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>0.0.1-SNAPSHOT<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">modules</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>api<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>service<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>dao<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"></<span class="hljs-name">modules</span>></span>
<span class="hljs-tag"><<span class="hljs-name">packaging</span>></span>pom<span class="hljs-tag"></<span class="hljs-name">packaging</span>></span>
<span class="hljs-tag"><<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-parent<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>1.5.10.RELEASE<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">relativePath</span>/></span> <span class="hljs-comment"><!-- lookup parent from repository --></span>
<span class="hljs-tag"></<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">properties</span>></span>
<span class="hljs-tag"><<span class="hljs-name">project.build.sourceEncoding</span>></span>UTF-8<span class="hljs-tag"></<span class="hljs-name">project.build.sourceEncoding</span>></span>
<span class="hljs-tag"><<span class="hljs-name">project.reporting.outputEncoding</span>></span>UTF-8<span class="hljs-tag"></<span class="hljs-name">project.reporting.outputEncoding</span>></span>
<span class="hljs-tag"><<span class="hljs-name">java.version</span>></span>1.8<span class="hljs-tag"></<span class="hljs-name">java.version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">lombok</span>></span>1.16.20<span class="hljs-tag"></<span class="hljs-name">lombok</span>></span>
<span class="hljs-tag"></<span class="hljs-name">properties</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependencies</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-test<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">scope</span>></span>test<span class="hljs-tag"></<span class="hljs-name">scope</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.projectlombok<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>lombok<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>${lombok}<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependencies</span>></span>
</project>
之后新建一个个 Module，将对应的代码移植过去：
需要注意的是在启动模块的 pom.xml 中需要指定启动类：
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<mainClass>com.youclk.multipackage.api.MultiApplication</mainClass>
<layout>ZIP</layout>
</configuration>
</plugin>
</plugins>
</build>
统一升级版本命令：mvn versions:set -DnewVersion=0.0.1-SNAPSHOT，到此差不多完成了，引用方式与普通的依赖包一致：
<dependency>
<groupId>com.youclk.multi-package</groupId>
<artifactId>service</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
补充
外层 pom ：
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>com.youclk<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>et2<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">packaging</span>></span>pom<span class="hljs-tag"></<span class="hljs-name">packaging</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>${own-project.version}<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-parent<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>2.1.0.RELEASE<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">relativePath</span>/></span> <span class="hljs-comment"><!-- lookup parent from repository --></span>
<span class="hljs-tag"></<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">modules</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>start<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>service<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"><<span class="hljs-name">module</span>></span>client<span class="hljs-tag"></<span class="hljs-name">module</span>></span>
<span class="hljs-tag"></<span class="hljs-name">modules</span>></span>
<span class="hljs-tag"><<span class="hljs-name">properties</span>></span>
<span class="hljs-tag"><<span class="hljs-name">project.build.sourceEncoding</span>></span>UTF-8<span class="hljs-tag"></<span class="hljs-name">project.build.sourceEncoding</span>></span>
<span class="hljs-tag"><<span class="hljs-name">project.reporting.outputEncoding</span>></span>UTF-8<span class="hljs-tag"></<span class="hljs-name">project.reporting.outputEncoding</span>></span>
<span class="hljs-tag"><<span class="hljs-name">java.version</span>></span>1.8<span class="hljs-tag"></<span class="hljs-name">java.version</span>></span>
<span class="hljs-tag"><<span class="hljs-name">own-project.version</span>></span>1.0.0<span class="hljs-tag"></<span class="hljs-name">own-project.version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">properties</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependencyManagement</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependencies</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>com.youclk<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>start<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>${own-project.version}<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>com.youclk<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>service<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>${own-project.version}<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependencies</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependencyManagement</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependencies</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-aop<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-test<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">scope</span>></span>test<span class="hljs-tag"></<span class="hljs-name">scope</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.springframework.boot<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>spring-boot-starter-web<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>org.projectlombok<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>lombok<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependency</span>></span>
<span class="hljs-tag"></<span class="hljs-name">dependencies</span>></span>
</project>
内层 pom
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<span class="hljs-tag"><<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">groupId</span>></span>com.youclk<span class="hljs-tag"></<span class="hljs-name">groupId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>et2<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>1.0.0<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
<span class="hljs-tag"></<span class="hljs-name">parent</span>></span>
<span class="hljs-tag"><<span class="hljs-name">artifactId</span>></span>service<span class="hljs-tag"></<span class="hljs-name">artifactId</span>></span>
<span class="hljs-tag"><<span class="hljs-name">packaging</span>></span>jar<span class="hljs-tag"></<span class="hljs-name">packaging</span>></span>
<span class="hljs-tag"><<span class="hljs-name">version</span>></span>${own-project.version}<span class="hljs-tag"></<span class="hljs-name">version</span>></span>
</project>
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.youclk</groupId>
<artifactId>et2</artifactId>
<version>1.0.0</version>
</parent>
<artifactId>start</artifactId>
<packaging>jar</packaging>
<version>${own-project.version}</version>
<dependencies>
<dependency>
<groupId>com.youclk</groupId>
<artifactId>service</artifactId>
</dependency>
</dependencies>
</project>
注意 start 模块下的包结构为根结构，不要加 .start，否则要指定需要扫描的包。
2. Nexus3 私有仓库搭建
Docker 时代一切都变得异常简单，Compose 配置如下：
version: '3.5'
services:
nexus:
image: sonatype/nexus3:3.10.0
networks:
- proxy
- youclk
volumes:
- /mnt/nas/db/nexus-data:/nexus-data
deploy:
mode: replicated
labels:
- com.df.notify=true
- com.df.port=8081
- com.df.serviceDomain=nexus.youclk.com
restart_policy:
condition: any
max_attempts: 3
update_config:
delay: 5s
order: start-first
resources:
limits:
cpus: '0.50'
memory: 1g
networks:
proxy:
external: true
youclk:
external: true
启动过程需要一分钟左右：
需要注意的是如果你的 ssl 是在负载均衡或者其他的反向代理之上，那么必须在 HTTP 头中指定 X-Forwarded-Proto 传输协议为 HTTPS，然后，就可以愉快地玩耍了。
3. 上传与引用
3.1 上传
首先需要在 Nexus 创建私有仓库，例如我的：
其次在本地 maven 设置中添加 server 节点，默认在 ~/.m2/settings.xml：
<servers>
<server>
<id>youclk</id>
<username>admin</username>
<password>youclk</password>
</server>
</servers>
pom.xml 中添加上传地址：
<distributionManagement>
<repository>
<id>nexus</id>
<name>Releases Repository</name>
<url>https://nexus.youclk.com/repository/youclk-releases/</url>
</repository>
<snapshotRepository>
<id>nexus</id>
<name>Snapshot Repository</name>
<url>https://nexus.youclk.com/repository/youclk-snapshots/</url>
</snapshotRepository>
</distributionManagement>
最后执行 mvn clean deploy 便会上传至私有仓库，单独传包命令如下：
mvn deploy:deploy-file -DgroupId=com.youclk -DartifactId=utils -Dversion=0.0.1-SNAPSHOT -Dpackaging=jar -Dfile=target/utils-0.0.1-SNAPSHOT.jar -Durl=https://nexus.youclk.com/repository/youclk/ -DrepositoryId=youclk
管理和查看：
3.1 引用
Finally，最后的最后就是怎么使用啦 ~ 如果需要全局引用的话需要在 settings.xml 添加和激活仓库：
<?xml version="1.0" encoding="UTF-8"?>
<settings>
<mirrors>
<mirror>
<id>aliyun</id>
<mirrorOf>central</mirrorOf>
<name>central mirror</name>
<url>http://maven.aliyun.com/mvn/repository</url>
</mirror>
<mirror>
<id>nexus</id>
<mirrorOf>maven-public</mirrorOf>
<name>private mirror</name>
<url>http://local-nexus.youclk.com/repository/maven-public/</url>
</mirror>
</mirrors>
<span class="hljs-tag"><<span class="hljs-name">servers</span>></span>
<span class="hljs-tag"><<span class="hljs-name">server</span>></span>
<span class="hljs-tag"><<span class="hljs-name">id</span>></span>nexus<span class="hljs-tag"></<span class="hljs-name">id</span>></span>
<span class="hljs-tag"><<span class="hljs-name">username</span>></span>admin<span class="hljs-tag"></<span class="hljs-name">username</span>></span>
<span class="hljs-tag"><<span class="hljs-name">password</span>></span>youclk<span class="hljs-tag"></<span class="hljs-name">password</span>></span>
<span class="hljs-tag"></<span class="hljs-name">server</span>></span>
<span class="hljs-tag"></<span class="hljs-name">servers</span>></span>
<span class="hljs-tag"><<span class="hljs-name">profiles</span>></span>
<span class="hljs-tag"><<span class="hljs-name">profile</span>></span>
<span class="hljs-tag"><<span class="hljs-name">id</span>></span>nexus<span class="hljs-tag"></<span class="hljs-name">id</span>></span>
<span class="hljs-tag"><<span class="hljs-name">repositories</span>></span>
<span class="hljs-tag"><<span class="hljs-name">repository</span>></span>
<span class="hljs-tag"><<span class="hljs-name">id</span>></span>maven<span class="hljs-tag"></<span class="hljs-name">id</span>></span>
<span class="hljs-tag"><<span class="hljs-name">name</span>></span>local private nexus<span class="hljs-tag"></<span class="hljs-name">name</span>></span>
<span class="hljs-tag"><<span class="hljs-name">url</span>></span>http://local-nexus.youclk.com/repository/maven-public/<span class="hljs-tag"></<span class="hljs-name">url</span>></span>
<span class="hljs-tag"><<span class="hljs-name">releases</span>></span>
<span class="hljs-tag"><<span class="hljs-name">enabled</span>></span>true<span class="hljs-tag"></<span class="hljs-name">enabled</span>></span>
<span class="hljs-tag"></<span class="hljs-name">releases</span>></span>
<span class="hljs-tag"><<span class="hljs-name">snapshots</span>></span>
<span class="hljs-tag"><<span class="hljs-name">enabled</span>></span>true<span class="hljs-tag"></<span class="hljs-name">enabled</span>></span>
<span class="hljs-tag"></<span class="hljs-name">snapshots</span>></span>
<span class="hljs-tag"></<span class="hljs-name">repository</span>></span>
<span class="hljs-tag"></<span class="hljs-name">repositories</span>></span>
<span class="hljs-tag"><<span class="hljs-name">pluginRepositories</span>></span>
<span class="hljs-tag"><<span class="hljs-name">pluginRepository</span>></span>
<span class="hljs-tag"><<span class="hljs-name">id</span>></span>maven<span class="hljs-tag"></<span class="hljs-name">id</span>></span>
<span class="hljs-tag"><<span class="hljs-name">name</span>></span>local private nexus<span class="hljs-tag"></<span class="hljs-name">name</span>></span>
<span class="hljs-tag"><<span class="hljs-name">url</span>></span>http://local-nexus.youclk.com/repository/maven-public/<span class="hljs-tag"></<span class="hljs-name">url</span>></span>
<span class="hljs-tag"><<span class="hljs-name">releases</span>></span>
<span class="hljs-tag"><<span class="hljs-name">enabled</span>></span>true<span class="hljs-tag"></<span class="hljs-name">enabled</span>></span>
<span class="hljs-tag"></<span class="hljs-name">releases</span>></span>
<span class="hljs-tag"><<span class="hljs-name">snapshots</span>></span>
<span class="hljs-tag"><<span class="hljs-name">enabled</span>></span>true<span class="hljs-tag"></<span class="hljs-name">enabled</span>></span>
<span class="hljs-tag"></<span class="hljs-name">snapshots</span>></span>
<span class="hljs-tag"></<span class="hljs-name">pluginRepository</span>></span>
<span class="hljs-tag"></<span class="hljs-name">pluginRepositories</span>></span>
<span class="hljs-tag"></<span class="hljs-name">profile</span>></span>
<span class="hljs-tag"></<span class="hljs-name">profiles</span>></span>
<span class="hljs-tag"><<span class="hljs-name">activeProfiles</span>></span>
<span class="hljs-tag"><<span class="hljs-name">activeProfile</span>></span>nexus<span class="hljs-tag"></<span class="hljs-name">activeProfile</span>></span>
<span class="hljs-tag"></<span class="hljs-name">activeProfiles</span>></span>
</settings>
不过一般不推荐这么写，settings.xml 应该尽可能保持简洁，精简配置，此处留下代理和权限认证即可，其余的可以移植到 pom.xml 中：
<repositories>
<repository>
<id>aliyun</id>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
</repository>
<repository>
<id>nexus</id>
<url>http://local-nexus.youclk.com/repository/maven-public/</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>central</id>
<url>
http://maven.aliyun.com/nexus/content/groups/public/
</url>
</pluginRepository>
<pluginRepository>
<id>maven-public</id>
<url>http://local-nexus.youclk.com/repository/maven-public/</url>
</pluginRepository>
</pluginRepositories>
小结
我的公众号《有刻》，我们共同成长！