第一章 Maven
- 高效构建Java应用：Maven入门和进阶
一、Maven 简介和快速入门
1. Maven 介绍
- Maven 是一款为 Java 项目构建管理、依赖管理的工具（软件），使用 Maven 可以自动化构建、测试、打包和发布项目，大大提高了开发效率和质量。
- 总结：Maven就是一个软件，掌握软件安装、配置、以及基本功能 （项目构建、依赖管理） 使用就是主要目标！
2. Maven 主要作用理解
2.1 场景概念
-
场景1： 例如我们项目需要第三方库（依赖），如Druid连接池、MySQL数据库驱动和Jackson等。那么我们可以将需要的依赖项的信息编写到Maven工程的配置文件，Maven软件就会自动下载并复制这些依赖项到项目中，也会自动下载依赖需要的依赖！确保依赖版本正确无冲突和依赖完整！
-
场景2： 项目开发完成后，想要将项目打成.war文件，并部署到服务器中运行，使用Maven软件，我们可以通过一行构建命令（mvn package）快速项目构建和打包！节省大量时间！
2.2 依赖管理
- Maven 可以管理项目的依赖，包括自动下载所需依赖库、自动下载依赖需要的依赖并且保证版本没有冲突、依赖版本管理等。通过 Maven，我们可以方便地维护项目所依赖的外部库，而我们仅仅需要编写配置即可。
2.3 构建管理
-
项目构建是指将源代码、配置文件、资源文件等转化为能够运行或部署的应用程序或库的过程！
-
Maven 可以管理项目的编译、测试、打包、部署等构建过程。通过实现标准的构建生命周期，Maven 可以确保每一个构建过程都遵循同样的规则和最佳实践。同时，Maven 的插件机制也使得开发者可以对构建过程进行扩展和定制。主动触发构建，只需要简单的命令操作即可。
3. Maven 安装和配置
- 选用版本：apache-maven-3.6.3-bin.zip
| 发布时间 | maven版本 | jdk最低版本 |
|---|---|---|
| 2019 - 11 - 25 | 3.6.3 | Java 7 |
3.1 安装
-
安装条件： maven需要本机安装java环境、必需包含java_home环境变量！
-
软件安装： 右键解压即可（绿色免安装）
-
软件结构：
3.2 环境变量
- 环境变量：配置maven_home 和 path
3.3 命令测试
mvn -v
# 输出版本信息即可，如果错误，请仔细检查环境变量即可！
# 友好提示，如果此处错误，绝大部分原因都是java_home变量的事，请仔细检查！！
3.4 配置文件
- 我们需要需改maven/conf/settings.xml配置文件，来修改maven的一些默认配置。我们主要需要修改的有三个配置：1.依赖本地缓存位置（本地仓库位置）2.maven下载镜像3.maven选用编译项目的jdk版本！
3.4.1 配置本地仓库地址
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository
<localRepository>/path/to/local/repo</localRepository>
-->
<!-- conf/settings.xml 55行 -->
<localRepository>D:\repository</localRepository>
3.4.2 配置国内阿里镜像
<!--在mirrors节点(标签)下添加中央仓库镜像 160行附近-->
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
3.4.3 配置jdk17版本项目构建
<!--在profiles节点(标签)下添加jdk编译版本 268行附近-->
<profile>
<id>jdk-17</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>17</jdk>
</activation>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.compilerVersion>17</maven.compiler.compilerVersion>
</properties>
</profile>
3.5 idea配置本地maven
- 我们需要将配置好的maven软件，配置到idea开发工具中即可！ 注意：idea工具默认自带maven配置软件，但是因为没有修改配置，建议替换成本地配置好的maven！
3.5.1 打开idea配置文件，构建工具配置
- 依次点击
- file / settings / build / build tool / maven
3.5.2 选中本地maven软件
3.5.3 测试是否配置成功
- 注意：如果本地仓库地址不变化，只有一个原因，就是maven/conf/settings.xml配置文件编写错误！仔细检查即可！
二、基于 IDEA 的 Maven 工程创建
1. 梳理 Maven 工程 GAVP 属性
-
Maven工程相对之前的工程，多出一组gavp属性，gav需要我们在创建项目的时指定，p有默认值，后期通过配置文件修改。既然要填写的属性，我们先行了解下这组属性的含义!
-
Maven 中的 GAVP 是指 GroupId、ArtifactId、Version、Packaging 等四个属性的缩写，其中前三个是必要的，而 Packaging 属性为可选项。这四个属性主要为每个项目在maven仓库总做一个标识，类似人的《姓-名》。有了具体标识，方便maven软件对项目进行管理和互相引用！
-
GAV遵循一下规则：
- GroupID 格式：com.{公司/BU }.业务线.[子业务线]，最多 4 级。
- 说明：{公司/BU} 例如：alibaba/taobao/tmall/aliexpress 等 BU 一级；子业务线可选。
- 正例：com.taobao.tddl 或 com.alibaba.sourcing.multilang
- ArtifactID 格式：产品线名-模块名。语义不重复不遗漏，先到仓库中心去查证一下。
- 正例：tc-client / uic-api / tair-tool / bookstore
- Version版本号格式推荐：主版本号.次版本号.修订号 1.0.0
- 主版本号：当做了不兼容的 API 修改，或者增加了能改变产品方向的新功能。
- 次版本号：当做了向下兼容的功能性新增（新增类、接口等）。
- 修订号：修复 bug，没有修改方法签名的功能加强，保持 API 兼容性。
- 例如： 初始 → 1.0.0 修改bug → 1.0.1 功能调整 → 1.1.1 等
- GroupID 格式：com.{公司/BU }.业务线.[子业务线]，最多 4 级。
-
Packaging定义规则：
- 指示将项目打包为什么类型的文件，idea根据packaging值，识别maven项目类型！
- packaging 属性为 jar（默认值），代表普通的Java工程，打包以后是.jar结尾的文件。
- packaging 属性为 war，代表Java的web工程，打包以后.war结尾的文件。
- packaging 属性为 pom，代表不会打包，用来做继承的父工程。
2. Idea构建 Maven JavaSE 工程
- 注意：此处省略了version，直接给了一个默认值<version>1.0-SNAPSHOT</version>
- 自己后期可以在项目中随意修改！
3. Idea构建 Maven JavaEE 工程
3.1 手动创建
3.1.1 创建一个 javasemaven 工程
3.1.2 手动添加web项目结构文件
- 注意：结构和命名固定
3.1.3 修改pom.xml文件打包方式
- 修改位置：项目下/pom.xml
<groupId>com.alex</groupId>
<artifactId>maven_parent</artifactId>
<version>1.0-SNAPSHOT</version>
<!-- 新增一列打包方式packaging -->
<packaging>war</packaging>
3.1.4 刷新和校验
- 项目的webapp文件夹出现小蓝点，代表成功！！
3.2 插件方式创建
3.2.1 安装插件JBLJavaToWeb
- file / settings / plugins / marketplace
3.2.2 创建一个 javasemaven 工程
3.2.3 右键、使用插件快速补全web项目
4. Maven 工程项目结构说明
- Maven 是一个强大的构建工具，它提供一种标准化的项目结构，可以帮助开发者更容易地管理项目的依赖、构建、测试和发布等任务。以下是 Maven Web 程序的文件结构及每个文件的作用：
|-- pom.xml # Maven 项目管理文件
|-- src
|-- main # 项目主要代码
| |-- java # Java 源代码目录
| | `-- com/example/myapp # 开发者代码主目录
| | |-- controller # 存放 Controller 层代码的目录
| | |-- service # 存放 Service 层代码的目录
| | |-- dao # 存放 DAO 层代码的目录
| | `-- model # 存放数据模型的目录
| |-- resources # 资源目录，存放配置文件、静态资源等
| | |-- log4j.properties # 日志配置文件
| | |-- spring-mybatis.xml # Spring Mybatis 配置文件
| | `-- static # 存放静态资源的目录
| | |-- css # 存放 CSS 文件的目录
| | |-- js # 存放 JavaScript 文件的目录
| | `-- images # 存放图片资源的目录
| `-- webapp # 存放 WEB 相关配置和资源
| |-- WEB-INF # 存放 WEB 应用配置文件
| | |-- web.xml # Web 应用的部署描述文件
| | `-- classes # 存放编译后的 class 文件
| `-- index.html # Web 应用入口页面
`-- test # 项目测试代码
|-- java # 单元测试目录
`-- resources # 测试资源目录
- pom.xml：Maven 项目管理文件，用于描述项目的依赖和构建配置等信息。
- src/main/java：存放项目的 Java 源代码。
- src/main/resources：存放项目的资源文件，如配置文件、静态资源等。
- src/main/webapp/WEB-INF：存放 Web 应用的配置文件。
- src/main/webapp/index.html：Web 应用的入口页面。
- src/test/java：存放项目的测试代码。
- src/test/resources：存放测试相关的资源文件，如测试配置文件等。
