本文纲要
一、分模块开发与设计
1.1 为什么需要分模块开发
1.2 分模块开发的意义
1.3 如何进行分模块开发
1.4 分模块开发的项目结构
二、依赖管理进阶
2.1 依赖的传递性
2.2 依赖冲突与解决
2.3 可选依赖(optional)
2.4 排除依赖(exclusions)
三、聚合与继承
3.1 聚合
3.2 继承
3.3 聚合与继承的区别
四、属性管理
4.1 自定义属性
4.2 配置文件加载属性
4.3 内置属性和其他属性
五、版本管理
5.1 SNAPSHOT 与 RELEASE 版本
5.2 其他版本号含义
六、多环境开发配置
6.1 定义多环境
6.2 激活特定环境
七、跳过测试
7.1 图形化按钮跳过
7.2 命令行跳过
7.3 细粒度控制
八、私服 Nexus
8.1 什么是私服
8.2 私服的安装与启动
8.3 私服仓库分类
8.4 本地仓库访问私服的配置
8.5 资源上传与下载
分模块开发与设计
1 ) 为什么需要分模块开发
- 传统单体项目将所有功能写在一个模块中,随着系统扩展会出现很多问题:
- 银行系统从最早的手工记账,发展到 DOS 终端、网上银行、手机 App、数字货币等多个子系统。
- 某个大型系统可能同时包含订单模块、商品模块、用户模块等,不同模块由不同团队并行开发。
- 订单模块需要使用商品模块中的实体类(domain/pojo),这就产生了模块间的依赖和共享需求。
通过 分模块开发,我们可以将原始工程按功能拆分成若干子模块,方便模块之间的相互调用和接口共享。
2 ) 分模块开发的意义
- 独立维护:每个模块可以独立开发、测试、部署和升级。
- 复用性强:其他模块通过 Maven 坐标即可直接引用,无需拷贝代码。
- 并行开发:多个团队可以同时开发不同模块,提升效率。
- 职责清晰:模块只关注自己的功能,降低耦合。
3 ) 如何进行分模块开发
以 SSM 整合工程为例,将原单体工程拆分为:
maven_03_pojo:存放实体类(domain)maven_04_dao:数据访问层maven_02_ssm:业务层与控制层(主工程)
步骤:
- 创建新模块
maven_03_pojo,将原有Book实体类移入。 - 在原
maven_02_ssm的pom.xml中添加对maven_03_pojo的依赖。 - 在
maven_03_pojo中执行mvn install,将其安装到本地仓库。 - 同理创建
maven_04_dao,移入BookDao接口和相关依赖。 - 主工程依赖
maven_04_dao,并通过依赖传递间接使用maven_03_pojo。
关键代码演示:
maven_03_pojo/pom.xml
<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>
<groupId>com.wb</groupId>
<artifactId>maven03pojo</artifactId>
<version>1.0-SNAPSHOT</version>
</project>
maven03pojo/src/main/java/com/wb/domain/Book.java
package com.wb.domain;
public class Book {
private Integer id;
private String type;
private String name;
private String description;
// getters/setters 省略...
}
在 maven_02_ssm 中依赖该模块
<dependency>
<groupId>com.wb</groupId>
<artifactId>maven03pojo</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
4 ) 分模块开发的项目结构
workspace
├── maven01parent # 聚合父工程(后续加入)
├── maven02ssm # 主工程(web层)
│ ├── src/main/java/com/wb/
│ │ ├── config/ # 配置类
│ │ ├── controller/ # 控制器
│ │ └── service/ # 业务层接口与实现
│ ├── src/main/resources/ # 配置文件
│ └── pom.xml
├── maven03pojo # 实体模块
│ ├── src/main/java/com/wb/domain/
│ │ └── Book.java
│ └── pom.xml
└── maven04dao # 数据访问模块
├── src/main/java/com/wb/dao/
│ └── BookDao.java
└── pom.xml
注意:私服和聚合/继承配置将在后文逐步添加。
二、依赖管理进阶
1 ) 依赖的传递性
Maven 的依赖具有传递性。若模块 A 依赖 B,B 依赖 C,则 A 可以直接使用 C 中的类,无需在 A 中重复声明。
概念区分:
- 直接依赖:当前工程
pom.xml中明确配置的依赖。 - 间接依赖(传递性依赖):直接依赖的依赖,会沿着依赖链传递下来。
例如:
maven_04_dao直接依赖maven_03_pojo和mybatis。maven_02_ssm直接依赖maven_04_dao,那么它间接可以使用maven_03_pojo和mybatis中的类。
在 IDEA 的 Maven 工具窗口中,可以通过 Show Dependencies 查看依赖树。
2 ) 依赖冲突与解决
当同一个依赖存在不同版本时,会出现冲突。Maven 解决冲突的规则:
- 同一个 pom 中配置多个同坐标依赖:最后声明的版本生效。
- 路径优先:依赖层级越浅,优先级越高。
例如:A → B → C(版本1.0),A → D → C(版本2.0)。若 B 和 D 都在深度2,则先配置的靠前?不,路径优先指深度不同时,浅者优先。 - 声明优先:在同一深度下,先后顺序影响最终版本(先声明者覆盖后声明者)。
实际开发中,建议通过 <dependencyManagement> 统一管理版本,避免冲突。
3 ) 可选依赖(optional)
如果模块 A 依赖 B,但不想将 B 传递给引用 A 的项目,可以在 B 的依赖中添加 <optional>true</optional>。
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
<optional>true</optional> <!-- 隐藏该依赖,不传递 -->
</dependency>
配置后,其他项目引用该模块时,将不会自动引入此依赖。
4 ) 排除依赖(exclusions)
当我们引用某个模块时,想主动去掉它传递过来的某些依赖,可以使用 <exclusions>。
例如:maven_02_ssm 依赖 maven_04_dao,但不想要其中的 log4j 和 mybatis 传递进来。
<dependency>
<groupId>com.wb</groupId>
<artifactId>maven04dao</artifactId>
<version>1.0-SNAPSHOT</version>
<exclusions>
<exclusion>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
</exclusion>
<exclusion>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
</exclusion>
</exclusions>
</dependency>
可选 vs 排除总结:
| 配置方式 | 作用方 | 效果 |
|---|---|---|
<optional>true</optional> | 当前模块对自己依赖的隐藏 | 别人引用我时,看不到我的这个依赖 |
<exclusions> | 引用方对被引用方依赖的剔除 | 我引用你时,不要你的某些依赖 |
三、聚合与继承
1 ) 聚合
聚合是将多个模块组织成一个整体,同时对多个模块执行构建命令(compile、install 等)。它通过一个聚合工程来管理其他模块。
特点:
- 聚合工程本身没有业务代码,只有
pom.xml。 - 打包方式为
pom。 - 使用
<modules>标签声明管理的模块。
maven_01_parent 聚合配置:
<groupId>com.wb</groupId>
<artifactId>maven01parent</artifactId>
<version>1.0-RELEASE</version>
<packaging>pom</packaging>
<modules>
<module>../maven02ssm</module>
<module>../maven03pojo</module>
<module>../maven04dao</module>
</modules>
此后只需对 maven_01_parent 执行构建,所有子模块会按照依赖关系顺序自动构建(先编译无依赖的 pojo,再构建 dao,最后 ssm)。
2 ) 继承
继承用于消除重复配置,子工程可以继承父工程中定义的依赖、属性、插件等配置。
父工程同样打包方式为 pom。
父工程中配置公共依赖:
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- 其他公共依赖... -->
</dependencies>
父工程中提供可选依赖(版本管理):
<dependencyManagement>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
</dependencies>
</dependencyManagement>
子工程声明继承关系:
<!-- maven02ssm/pom.xml -->
<parent>
<groupId>com.wb</groupId>
<artifactId>maven01parent</artifactId>
<version>1.0-RELEASE</version>
<relativePath>../maven01parent/pom.xml</relativePath>
</parent>
<dependencies>
<!-- 使用父工程 dependencyManagement 中的依赖,无需写版本 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
3 )聚合与继承的区别
| 特性 | 聚合 | 继承 |
|---|---|---|
| 作用 | 快速构建多个模块 | 复用配置,减少重复 |
| 配置位置 | 父工程中 <modules> | 子工程中 <parent> |
| 打包方式 | pom | pom(父工程) |
| 代码 | 无业务代码 | 无业务代码 |
通常聚合与继承会合并使用同一个父工程,例如这里的 maven_01_parent 既管理模块构建,又提供公共依赖和属性。
四、属性管理
1 ) 自定义属性
Maven 可以自定义属性,用于统一管理版本号、路径等可变量。
定义方式:
<properties>
<spring.version>5.2.10.RELEASE</spring.version>
<junit.version>4.12</junit.version>
</properties>
引用方式:${属性名}
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
这样只需修改一处属性,所有引用该属性的地方同步更新。
2 ) 配置文件加载属性
Maven 还可以将属性注入到资源文件(如 jdbc.properties)中,但需要配置资源过滤。
父工程中开启资源过滤:
<build>
<resources>
<resource>
<directory>${project.basedir}/src/main/resources</directory>
<filtering>true</filtering> <!-- 开启过滤,解析 ${} -->
</resource>
</resources>
</build>
jdbc.properties 文件中使用 Maven 属性:
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=${jdbc.url}
jdbc.username=root
jdbc.password=root
通过 Maven 的属性占位符,可以在不同环境动态切换数据库地址(详见多环境开发)
3 ) 内置属性和其他属性
Maven 的属性分五类:
- 自定义属性:
<properties>中定义。 - 内置属性:如
${project.basedir}、${project.version}。 - Settings 属性:来自
settings.xml中的配置。 - Java 系统属性:可通过
${java.home}等获取。 - 环境变量:可通过
${env.JAVA_HOME}获取系统环境变量。
示例:在命令行执行 mvn help:system 可以查看所有可用属性。
五、版本管理
1 ) SNAPSHOT 与 RELEASE 版本
- SNAPSHOT:快照版本,表示项目处于开发迭代中,发布到仓库时带有时间戳,可重复更新。
- RELEASE:稳定发布版,一旦发布不可更改。
在 Maven 依赖中可指定版本类型,私服仓库通常分为 snapshots 仓库和 releases 仓库。
2 ) 其他版本号含义
- Alpha:内部测试版,功能可能不完整。
- Beta:公开测试版,相对 Alpha 更稳定。
- RC (Release Candidate):候选发布版,接近正式版。
- M (Milestone):里程碑版,表示阶段性成果。
- GA:一般可用的正式版。
六、多环境开发配置
1 ) 定义多环境
使用 <profiles> 标签可以定义多个环境,每个环境指定不同的属性值。
<profiles>
<profile>
<id>env_dep</id>
<properties>
<jdbc.url>jdbc:mysql://127.1.1.1:3306/ssm_db</jdbc.url>
</properties>
<activation>
<activeByDefault>true</activeByDefault> <!-- 默认激活 -->
</activation>
</profile>
<profile>
<id>env_pro</id>
<properties>
<jdbc.url>jdbc:mysql://127.2.2.2:3306/ssm_db</jdbc.url>
</properties>
</profile>
</profiles>
这样,jdbc.url 在不同的 profile 中会取不同的值。
2 )激活特定环境
- 默认激活:通过
<activeByDefault>true</activeByDefault>指定。 - 命令行激活:在 Maven 指令后加
-P 环境ID。mvn install -P env_pro- IDEA 中也可在 Maven 面板的命令栏中输入
install -P env_test。
七、跳过测试
1 ) 图形化按钮跳过
在 IDEA 的 Maven 面板中,点击闪电符号(Toggle Skip Tests),测试阶段会被跳过,test 颜色变灰。
2 ) 命令行跳过
mvn package -DskipTests
3 )细粒度控制
通过配置 maven-surefire-plugin 可以精确控制哪些测试类参与或排除。
<build>
<plugins>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.12.4</version>
<configuration>
<skipTests>false</skipTests> <!-- 全局不跳过 -->
<excludes>
<exclude>/BookServiceTest.java</exclude> <!-- 排除特定测试 -->
</excludes>
</configuration>
</plugin>
</plugins>
</build>
八、私服 Nexus
1 ) 什么是私服
私服是架设在局域网内的一种 Maven 仓库服务器,用于解决团队内部资源共享和中央仓库网络限制等问题。它相当于中央仓库在本地网络的代理。
2 ) 私服的安装与启动
- 下载
Nexus Repository Manager OSS。 - 解压后包含两个目录:
nexus-版本号(应用程序)和sonatype-work(数据仓库)。 - 进入安装目录的
bin,执行:nexus.exe /run - 默认端口
8081,启动后浏览器访问http://localhost:8081。 - 初始用户名
admin,密码存放在sonatype-work/nexus3/admin.password文件中。
3 ) 私服仓库分类
| 仓库类型 | 英文 | 用途 | 操作 |
|---|---|---|---|
| 宿主仓库 | hosted | 存放本公司开发的模块或第三方商业 jar | 上传 |
| 代理仓库 | proxy | 代理远程仓库(如中央仓库、阿里云),缓存下载的资源 | 下载 |
| 仓库组 | group | 将多个仓库聚合,统一对外提供下载服务 | 下载 |
通常一个团队会创建自己的宿主仓库(release 和 snapshot 各一个),并将它们加入默认的 maven-public 仓库组,方便下载。
4 ) 本地仓库访问私服的配置
修改 settings.xml (位于 maven 安装目录 conf 下)
4.1 配置私服认证信息
<servers>
<server>
<id>itheima-snapshot</id>
<username>admin</username>
<password>admin123</password>
</server>
<server>
<id>itheima-release</id>
<username>admin</username>
<password>admin123</password>
</server>
</servers>
4.2 配置镜像,让所有请求都走私服仓库组
<mirrors>
<mirror>
<id>nexus</id>
<mirrorOf>*</mirrorOf>
<url>http://localhost:8081/repository/maven-public/</url>
</mirror>
</mirrors>
5 ) 资源上传与下载
在需要发布到私服的工程的 pom.xml 中配置部署目标:
<distributionManagement>
<repository>
<id>itheima-release</id>
<url>http://localhost:8081/repository/itheima-release/</url>
</repository>
<snapshotRepository>
<id>itheima-snapshot</id>
<url>http://localhost:8081/repository/itheima-snapshot/</url>
</snapshotRepository>
</distributionManagement>
上传命令:
mvn deploy
该命令会将模块打包并上传到对应私服仓库(release 或 snapshot 取决于版本号中是 -SNAPSHOT 还是 -RELEASE)。
下载资源:当本地仓库没有所需依赖时,Maven 会自动从配置的私服仓库组下载,私服会层层向下请求(代理仓库 → 中央仓库),并缓存到私服本地,后续下载直接命中缓存。
总结
通过以上内容,我们完成了 Maven 进阶核心知识的学习,包括分模块开发、依赖管理、聚合继承、属性管理、多环境配置、跳过测试以及私服的搭建与使用。
这些技能将极大提升多项目协作和工程构建效率。
2604



被折叠的 条评论
为什么被折叠?



