Maven 模块化开发
请参照如上章节导航进行阅读
在多人协同开发时,特别是规模较大的项目,为了方便日后的代码维护和管理,我们会将每个开发人员的工作细分到具体的功能和模块上。
随着项目的不断扩大,模块也会越来越多,后续会更加难以维护和扩展,为了应对这种情况后期我们还会采用微服务架构的方式进行开发。
本章节以构建一个 IoT云平台 项目为例,我们可以将模块划分为如下形式:
统一的依赖管理(dependencies)
通用的工具类(commons)
领域模型(domain)
管理后台(admin)
前端控制台(console)
接口模块(api)
整个模块化开发过程主要是在开发思想上稍作了一些转变,只需要按照下面的流程操作即可。
创建一个名为 iot-cloud 的工程,pom.xml 文件如下:
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">
4.0.0
net.work100.training.stage2
iot-cloud
1.0.0-SNAPSHOT
pom
该项目称之为 Root 项目,主要作用是管理整个工程的全部模块,当有新模块加入时需要在 modules 元素下配置对应的模块目录
创建一个名为 iot-cloud-dependencies 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud
1.0.0-SNAPSHOT
../pom.xml
iot-cloud-dependencies
pom
iot-cloud-dependencies
UTF-8
UTF-8
1.8
5.2.3.RELEASE
4.0.1
1.2
1.2.17
1.7.25
3.5
org.springframework
spring-webmvc
${spring.version}
javax.servlet
javax.servlet-api
${javax.servlet-api.version}
provided
javax.servlet
jstl
${javax.jstl.version}
org.slf4j
slf4j-api
${slf4j.version}
org.slf4j
slf4j-log4j12
${slf4j.version}
org.slf4j
jcl-over-slf4j
${slf4j.version}
org.slf4j
jul-to-slf4j
${slf4j.version}
log4j
log4j
${log4j.version}
org.apache.commons
commons-lang3
${commons-lang3.version}
org.apache.maven.plugins
maven-compiler-plugin
3.7.0
${java.version}
${java.version}
${project.build.sourceEncoding}
true
src/main/java
**/*.java
src/main/resources
然后修改 iot-cloud 工程的 pom.xml 文件:
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">
4.0.0
net.work100.training.stage2
iot-cloud
1.0.0-SNAPSHOT
pom
iot-cloud-dependencies
创建一个名为 iot-cloud-commons 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud-dependencies
1.0.0-SNAPSHOT
../iot-cloud-dependencies/pom.xml
iot-cloud-commons
jar
iot-cloud-commons
org.apache.commons
commons-lang3
然后在 iot-cloud 工程的 pom.xml 中增加 iot-cloud-commons 配置
创建一个名为 iot-cloud-domain 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud-dependencies
1.0.0-SNAPSHOT
../iot-cloud-dependencies/pom.xml
iot-cloud-domain
jar
iot-cloud-domain
然后在 iot-cloud 工程的 pom.xml 中增加 iot-cloud-domain 配置
创建一个名为 iot-cloud-web-admin 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud-dependencies
1.0.0-SNAPSHOT
../iot-cloud-dependencies/pom.xml
iot-cloud-web-admin
war
iot-cloud-web-admin
net.work100.training.stage2
iot-cloud-domain
${project.parent.version}
然后在 iot-cloud 工程的 pom.xml 中增加 iot-cloud-web-admin 配置
创建一个名为 iot-cloud-web-console 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud-dependencies
1.0.0-SNAPSHOT
../iot-cloud-dependencies/pom.xml
iot-cloud-web-console
war
iot-cloud-web-console
然后在 iot-cloud 工程的 pom.xml 中增加 iot-cloud-web-console 配置
创建一个名为 iot-cloud-web-api 的项目,pom.xml 文件如下:
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4.0.0
net.work100.training.stage2
iot-cloud-dependencies
1.0.0-SNAPSHOT
../iot-cloud-dependencies/pom.xml
iot-cloud-web-api
war
iot-cloud-web-api
然后在 iot-cloud 工程的 pom.xml 中增加 iot-cloud-web-api 配置
至此一个完整的模块化工程创建完毕,此时的 Root 工程 pom.xml 文件如下:
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">
4.0.0
net.work100.training.stage2
iot-cloud
1.0.0-SNAPSHOT
pom
iot-cloud-dependencies
iot-cloud-commons
iot-cloud-domain
iot-cloud-web-admin
iot-cloud-web-console
iot-cloud-web-api
我们可以在 Root 工程中使用 Maven 提供的 mvn clean 命令测试一下效果,控制台输出如下:
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Build Order:
[INFO]
[INFO] iot-cloud [pom]
[INFO] iot-cloud-dependencies [pom]
[INFO] iot-cloud-commons [jar]
[INFO] iot-cloud-domain [jar]
[INFO] iot-cloud-web-admin [war]
[INFO] iot-cloud-web-console [war]
[INFO] iot-cloud-web-api [war]
[INFO]
[INFO] ---------------< net.work100.training.stage2:iot-cloud >----------------
[INFO] Building iot-cloud 1.0.0-SNAPSHOT [1/7]
[INFO] --------------------------------[ pom ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud ---
[INFO]
[INFO] ---------< net.work100.training.stage2:iot-cloud-dependencies >---------
[INFO] Building iot-cloud-dependencies 1.0.0-SNAPSHOT [2/7]
[INFO] --------------------------------[ pom ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-dependencies ---
[INFO]
[INFO] -----------< net.work100.training.stage2:iot-cloud-commons >------------
[INFO] Building iot-cloud-commons 1.0.0-SNAPSHOT [3/7]
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-commons ---
[INFO]
[INFO] ------------< net.work100.training.stage2:iot-cloud-domain >------------
[INFO] Building iot-cloud-domain 1.0.0-SNAPSHOT [4/7]
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-domain ---
[INFO]
[INFO] ----------< net.work100.training.stage2:iot-cloud-web-admin >-----------
[INFO] Building iot-cloud-web-admin 1.0.0-SNAPSHOT [5/7]
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-web-admin ---
[INFO]
[INFO] ---------< net.work100.training.stage2:iot-cloud-web-console >----------
[INFO] Building iot-cloud-web-console 1.0.0-SNAPSHOT [6/7]
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-web-console ---
[INFO]
[INFO] -----------< net.work100.training.stage2:iot-cloud-web-api >------------
[INFO] Building iot-cloud-web-api 1.0.0-SNAPSHOT [7/7]
[INFO] --------------------------------[ war ]---------------------------------
[INFO]
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ iot-cloud-web-api ---
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary for iot-cloud 1.0.0-SNAPSHOT:
[INFO]
[INFO] iot-cloud .......................................... SUCCESS [ 0.160 s]
[INFO] iot-cloud-dependencies ............................. SUCCESS [ 0.002 s]
[INFO] iot-cloud-commons .................................. SUCCESS [ 0.002 s]
[INFO] iot-cloud-domain ................................... SUCCESS [ 0.002 s]
[INFO] iot-cloud-web-admin ................................ SUCCESS [ 0.002 s]
[INFO] iot-cloud-web-console .............................. SUCCESS [ 0.003 s]
[INFO] iot-cloud-web-api .................................. SUCCESS [ 0.002 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 0.320 s
[INFO] Finished at: 2020-02-22T15:49:59+08:00
[INFO] ------------------------------------------------------------------------
请观看视频教程
实例源码已经托管到如下地址:
如果对课程内容感兴趣,可以扫码关注我们的 公众号 或 QQ群,及时关注我们的课程更新