Maven项目构建工具：从依赖管理到自动化构建

第一部分Maven概述1.1 为什么需要Maven⭐老师强调Maven是一个Java项目管理和构建工具核心解决两个问题定义项目结构和管理依赖关系。没有Maven的痛点问题说明工具不兼容Eclipse建的项目前端放WebContentIDEA建的项目前端放webapp源码目录命名也不同换工具打不开依赖手动下载引jar包得自己下载具体文件再塞进项目mysql驱动、文件上传、富文本编辑器等版本冲突多人协作用不同版本jar包如mysql驱动版本不一致就会冲突Maven的解决方案功能说明统一项目结构规范目录如src/main/java放Java文件src/main/resource放资源文件依赖管理只需一小段坐标代码就能引入jar包不用存实体文件版本统一自动处理版本冲突统一管理⭐老师强调Maven像图书馆索书号——不用搬书回家凭号系统就调出书。依赖管理本质是用声明式坐标替代手动文件操作。1.2 Maven的核心优势⭐老师强调Maven项目的核心优势在于工具无关性——只要确认是Maven项目任意工具都能打开对开发友好。标准构建流程编译 → 测试 → 打包 → 部署⭐老师强调打包必须打war包部署需依赖Tomcat手动放到其webapp目录运行。war包与Tomcat是硬性依赖关系。第二部分Maven安装与配置2.1 版本选择组件版本要求说明Maven3.6.3IDEA 2024与低版本如3.6.0不适配模板JDK1.8统一要求IDEA2024版开发环境⭐老师强调企业里多见老项目未升级先用3.6.3更稳妥熟练后搜下新版本差异就能平迁。2.2 安装步骤步骤1解压从官网下载安装包随便找目录解压类似Tomcat步骤2配置环境变量MAVEN_HOME Maven解压根目录含bin文件夹 PATH 添加 %MAVEN_HOME%\bin⭐老师强调MAVEN_HOME指向解压根目录PATH必须引其bin目录。易错点是漏配PATH或HOME错指。步骤3验证安装mvn -version出现版本信息即安装成功。2.3 配置本地仓库与镜像修改conf/settings.xml配置项位置作用localRepository约40多行设置本地仓库目录避免默认C盘选非中文目录mirrors约160多行添加阿里镜像提速!-- 本地仓库路径 -- localRepositoryE:/maven/localRepo/localRepository !-- 阿里镜像 -- mirror idalimaven/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror⭐老师强调不配置则默认下载到用户目录的.m2文件夹占C盘空间。配阿里镜像可大幅提速。2.4 IDEA中配置Maven路径All settings → Build工具 → Maven配置项说明Maven主路径指向Maven目录不含binSettings.xml勾选override指定改过的文件本地仓库自动读取settings.xml中的路径JDK用环境变量中JAVA_HOME对应的第三部分Maven项目结构3.1 标准目录结构项目名/ ├── pom.xml ← Maven项目标识 ├── src/ │ ├── main/ ← 开发环境 │ │ ├── java/ ← Java代码包名同groupId如com.qcby │ │ └── resource/ ← 非Java资源需自行补建 │ └── test/ ← 测试环境 │ ├── java/ ← 测试代码 │ └── resource/ ← 测试资源 └── target/ ← 输出结果编译后文件⭐老师强调看到项目里有pom.xml就说明是Maven项目。main和test是镜像分布开发写逻辑、测试写验证别把测试代码误放进main里。3.2 约定大于配置⭐老师强调Maven项目里resource和java目录本质都是文件夹你硬把Java文件放resource里也能存、不报错但项目只识别约定目录下的Java文件放错地方就扫描不到、无法编译使用。约定目录的作用让构建尽量自动化构建工具只需扫描固定位置不必全盘找文件⭐老师强调易错点是以为能存就能用其实得按约定来。这跟电脑文件系统权限无关是Maven构建机制的限制。3.3 创建Maven项目方式1用命令创建mvn archetype:generate -DgroupIdcom.example -DartifactId项目名方式2用IDEA创建选纯Maven项目不带模板项目名自己填JDK选1.8GroupId默认域名倒写建议改成自己的并与项目名统一⭐老师强调groupId一般是域名倒写如com.example版本信息相对随意。第四部分pom.xml配置4.1 项目坐标groupIdcom.qcby/groupId !-- 组id域名倒写 -- artifactIdfirst-maven-project/artifactId !-- 项目名 -- version1.0-SNAPSHOT/version !-- 版本号 --标签说明groupId组id域名倒写artifactId项目名/模块名version版本号SNAPSHOT为快照版⭐老师强调项目庞大时会拆为前台、后台、公共等模块各模块可由不同组开发。项目是总集模块是其细分单元。4.2 属性定义properties jdk.version1.8/jdk.version project.build.sourceEncodingUTF-8/project.build.sourceEncoding /properties⭐老师强调properties用来定义属性和变量可统一设置JDK版本、编码等。多个地方用同一版本时可在properties里统一设置。4.3 依赖引入dependencies dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version scoperuntime/scope /dependency /dependencies⭐老师强调所有依赖都可在中央仓库搜索如mysql、mybatis、spring等复制坐标进dependencies就能引入资源不用自己下jar包。第五部分依赖范围scope5.1 各scope详解scope编译测试打包说明典型示例test✗✓✗编译时用不了java变class阶段不参与只在测试环境能用打包时也用不了junit单元测试包provided✓✓✗编译、测试环境都能用最终打包不会被打进包里servlet包Tomcat自带compile✓✓✓整个编译阶段有必要用默认值不写就是compile通用依赖runtime✗✓✓编译阶段不参与测试和打包阶段才会用到靠反射获取资源数据库驱动、反射相关类⭐老师强调providedTomcat自带servlet-api的jar包本地开发需引入供编译和测试使用但打包部署时不能把servlet打进包里否则会和Tomcat自带的包发生版本冲突。runtimeruntime与system范围行为类似编译不用但来源不同——runtime仍来自仓库system强制用本地文件。scope像门票权限——test这张票只准进测试这扇门编译和打包的门都进不去。5.2 依赖传递⭐老师强调传递依赖是指项目间依赖会层层传导。若B项目依赖了mysql-connector并打包进本地仓库A项目只引入B项目就能因B已依赖它而间接用到mysql。传递条件方式说明不设置依赖直接去掉optionalfalse默认false即可传递true表示不传递scope设特定值test/provided会禁止传递⭐老师强调scope像传递开关test/provided就是关依赖链到这就断了。因为这两个值在打包时不可用而依赖想传递到A项目必须先打包提交。第六部分Maven生命周期6.1 生命周期阶段命令作用clean删除target文件夹编译后生成的文件compile编译把.java变成.classtest测试跑单元测试并输出结果package打包生成jar包或war包install把包提交到本地仓库deploy提交到远程服务器平时不直接用⭐老师强调这些环节是构建流程的先后步骤——package依赖前序编译与测试install又依赖package产出。6.2 打包与依赖复用⭐老师强调项目可打成jar包或war包。war包用于部署如河北大学研究生项目需放tomcat上自动解析jar包通用引入。jar包本质就是一些Java文件打包后别的项目可通过坐标引入。项目自身资源复用靠先打包再用相同groupId等坐标供他人引入。⭐老师强调打包和提交到本地仓库是两个动作。未提交就不算进仓库管理。6.3 JUnit单元测试Test public void testMethod() { // 测试代码 }⭐老师强调正常调方法得手写main、创建对象再点方法名而把Test加在方法上工具会自动帮咱们完成建main、建对象、调方法的过程。易错点注解必须加在具体方法上不是类或包它替代的是手动的main与方法调用不是替代业务逻辑本身附录一Maven命令速查表命令作用mvn clean清理target目录mvn compile编译mvn test运行测试mvn package打包mvn install安装到本地仓库mvn deploy部署到远程仓库mvn -version查看版本