# Maven

# 安装与简介

Maven 是 apache 下的一个开源项目，是纯 java 开发，用于对 java 项目进行构建、依赖管理

当然也可以选择越来越流行的 Gradle 使用，它采用 Groovy DSL（特定领域编程语言，如 SQL）脚本语言，可进行方便的操作。Java 是 DPL（通用编程语言）。

下载二进制文件解压，配置环境变量即可使用。下面是 macOS 的例子：

1. 在官网下载 Binary tar.gz archive ，也可以下载 Source tar.gz archive 自己编译。

2. 将其解压到/usr/local/Maven下

   tar -zxvf apache-maven-3.6.1-bin.tar.gz -C /usr/local/Maven
   

3. 配置当前用户环境变量并刷新

   # zsh
   vim ~/.zshrc
   # bash
   vim ~/.bash_profile
   
   # 配置Maven环境变量
   export MAVEN_HOME="/usr/local/Maven/apache-maven-3.6.1"
   export PATH=$MAVEN_HOME/bin:$PATH
   
   # zsh
   source ~/.zshrc
   # bash
   source ~/.bash_profile
   

4. Maven 文件夹目录

   |——bin：mvn.bat（run方式运行项目）、mvnDebug.bat（debug方式运行项目）
   |——boot：Maven运行所需要的类加载器
   |——conf：settings.xml（整个Maven工具核心配置文件。配置本地仓库等）
   |——lib：Maven运行依赖的jar包
   

5. Maven 项目目录结构

   |—src
   	|—main
   		|—java					存放项目的java文件
   		|—resources			存放项目的资源文件，如spring、mybatis等配置文件
   		|—webapp				web工程主目录
   			|—WEB-INF			springboot中没有
   				|—web.xml
   	|—test
   		|—java					存放所有测试.java文件，如JUnit测试类
   		|—resources			测试资源文件，一般不放东西，调用的main中的资源文件
   |—target						目标文件输出位置，如.class、.jar、.war文件
   |—pom.xml						Maven项目核心配置文件
   

# 配置

# 配置阿里源

仓库地址，有很多 Repository，可以根据需要配置。

1. 打开 ${maven_home}/conf/settings.xml

2. 在<mirrors>上面配置

   <mirror>
       <id>aliyun-public</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun public</name>
       <url>https://maven.aliyun.com/repository/public</url>
   </mirror>
   
   <mirror>
       <id>aliyun-central</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun central</name>
       <url>https://maven.aliyun.com/repository/central</url>
   </mirror>
   
   <mirror>
       <id>aliyun-spring</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun spring</name>
       <url>https://maven.aliyun.com/repository/spring</url>
   </mirror>
   
   <mirror>
       <id>aliyun-spring-plugin</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun spring-plugin</name>
       <url>https://maven.aliyun.com/repository/spring-plugin</url>
   </mirror>
   
   <mirror>
       <id>aliyun-apache-snapshots</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun apache-snapshots</name>
       <url>https://maven.aliyun.com/repository/apache-snapshots</url>
   </mirror>
   
   <mirror>
       <id>aliyun-google</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun google</name>
       <url>https://maven.aliyun.com/repository/google</url>
   </mirror>
   
   <mirror>
       <id>aliyun-gradle-plugin</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun gradle-plugin</name>
       <url>https://maven.aliyun.com/repository/gradle-plugin</url>
   </mirror>
   
   <mirror>
       <id>aliyun-jcenter</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun jcenter</name>
       <url>https://maven.aliyun.com/repository/jcenter</url>
   </mirror>
   
   <mirror>
       <id>aliyun-releases</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun releases</name>
       <url>https://maven.aliyun.com/repository/releases</url>
   </mirror>
   
   <mirror>
       <id>aliyun-snapshots</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun snapshots</name>
       <url>https://maven.aliyun.com/repository/snapshots</url>
   </mirror>
   
   <mirror>
       <id>aliyun-grails-core</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun grails-core</name>
       <url>https://maven.aliyun.com/repository/grails-core</url>
   </mirror>
   
   <mirror>
       <id>aliyun-mapr-public</id>
       <mirrorOf>*</mirrorOf>
       <name>aliyun mapr-public</name>
       <url>https://maven.aliyun.com/repository/mapr-public</url>
   </mirror>
   

# repository

<localRepository>/Users/conanan/.m2/repository</localRepository>

# 一键构建

项目的一键构建：一个项目从编写源代码到编译、测试、打包、安装、部署的过程。Maven 项目构建过程：

• clean——>compile——>test——>package——>install——>deploy

Maven 的生命周期

• Clean 生命周期：clean
• Default 生命周期：
  • compile——>test——>package——>install——>deploy
• Site 生命周期：mvn site 生成项目的站点文档

命令和生命周期的阶段的关系：不同的生命周期的命令可以同时执行（如 mvn clean package）

Maven 包含了一个项目对象模型 (Project Object Model)，一组标准集合，一个项目生命周期(Project Lifecycle)，一个依赖管理系统(Dependency Management System)，和用来运行定义在生命周期阶段 (phase)中插件(plugin)目标(goal)的逻辑。

常用的 Maven 命令

• mvn clean：删除 target 及其内容。接手他人项目一般先执行此命令
• mvn compile：只编译 main目录的文件，存放至 target 目录
• mvn test：编译 test和 mian 目录的代码并运行
• mvn package：编译 test 和 mian 目录的代码，并根据项目类型打包（jar、war）
• mvn install：执行以上操作，并把项目发布到本地仓库
• mvn deploy：执行以上操作，并把项目发布到私服
• mvn tomcat:run：由于 Maven 集成了 Tomcat 插件。在当前项目的路径中执行，运行 Maven 工程项目
• mvn spring-boot:run：运行 SpringBoot 项目
• 可以组合使用，如：mvn clean package -Dmaven.test.skip，其他类似

# 依赖管理

依赖管理：Maven 工程队 Java 项目所依赖 jar 包的规范化管理

• Maven 项目的 jar 包只需在**pom.xml添加 jar 包的坐标**，自动从Maven 仓库下载 jar 包、运行

Maven 仓库分三类：本地仓库、远程仓库（私服）、中央仓库。可以配置本地仓库的路径

仓库之间的关系：当我们启动一个 maven 工程的时候，maven 工程会通过 pom 文件中 jar 包的坐标去本地仓库找对应 jar 包。默认情况下，如果本地仓库没有对应 jar 包，maven 工程会自动去中央仓库下载 jar 包到本地仓库。在公司中，如果本地没有对应 jar 包，会先从私服下载 jar 包。如果私服没有 jar 包，可以从中央仓库下载，也可以从本地上传。

Maven 乱码问题：修改 Runner 中 VM Options：-Dfile.encoding=gb2312

# 解决依赖冲突

• 第一声明者优先原则（先声明的包及依赖包优先进入项目）

• 路径近者优先原则，直接依赖优先于传递依赖（A 依赖 B 依赖 spring-bean2，A 依赖 spring-bean1，则应该用 1）

  • 直接依赖：项目中直接导入的 jar 包，就是该项目的直接依赖包。
  • 传递依赖：项目中没有直接导入的 jar 包，可以通过项目直接依赖 jar 包传递到项目中去。

• 排除依赖：要排除某个 jar 包下依赖包，在配置exclusions标签的时候，内部可以不写版本号。和默认和本 jar 包一样。

• 锁定版本：dependencyManagement方法在企业开发中常用。还可以提取版本号，使用<properties>标签设置成变量

maven 工程是可以分父子依赖关系的。凡是依赖别的项目后，拿到的别的项目的依赖包，都属于传递依赖。比如：当前 A 项目，被 B 项目依赖。那么我们 A 项目中所有 jar 包都会传递到 B 项目中。B 项目开发者，如果再在 B 项目中导入一套 ssm 框架的 jar 包，对于 B 项目是直接依赖。那么直接依赖的 jar 包就会把我们 A 项目传递过去的 jar 包覆盖掉。

为了防止以上情况的出现。我们利用dependencyManagement可以把 A 项目中主要 jar 包的坐标锁住（仅仅是锁住，还需要在dependencies中导入坐标，但不用写版本号），那么其他依赖该项目的项目中，即便是有同名 jar 包直接依赖，也无法覆盖。

# 依赖范围

• 依赖范围（A 依赖 B，需要在 A 的 pom.xml 文件中添加 B 的坐标，同时指定依赖范围）

  • Compile：编译范围，指 A 在编译时依赖 B，为默认依赖范围。在编译、测试、运行、打包时需要
    • 如：struts2-core
  • Provided：依赖只有在当 JDK 或者一个容器已经提供该依赖后才使用，在编译、测试时需要
    • 如：jsp-api.jar servlet-api.jar
  • Runtime：在测试、运行、打包时需要
    • 如：数据库驱动包
  • Test：只测试时需要
    • 如：JUnit.jar

  传递的依赖是否可以使用，参考下图：

  

# 拆分与聚合

拆分：项目开发通常是分组分模块开发，通过一个模块引用另一个模块来实现代码的重用，体现了 Maven 的根本思想。

聚合：每个模块开发完成要运行整个工程需要将每个模块聚合在一起运行。

继承：继承是为了消除重复，如果将 dao、service、web 分开创建独立的工程则每个工程的 pom.xml 文件中的内容存在重复。可以将这些重复的配置提取出来在父工程的 pom.xml 中定义。

工程和模块的区别：

• 工程不等于完整的项目，模块也不等于整的项目，一个完整的项目看的是代码，代码完整，就可以说这是一个完整的项目，和此项目是工程和模块没有关系。
• 工程天生只能使用自己内部资源，工程天生是独立的。后天可以和其他工程或模块建立关联关系。
• 模块天生不是独立的，模块天生是属于父工程的，模块一旦创建，所有父工程的资源都可以使用。

父子工程之间，子模块天生继承父工程，可以使用父工程所有资源。子模块之间天生是没有任何关系的。

父子工程之间不用建立关系，继承关系是先天的，不需要手动建立。

平级直接的引用叫依赖，依赖不是先天的，依赖是需要后天建立的。如 Service 依赖 Dao：

<dependency>
    <groupId>com.itheima</groupId>
    <artifactId>maven_dao</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

# 私服

需求：正式开发，不同的项目组开发不同的工程。 ssm_dao 工程开发完毕，发布到私服。 ssm_service 从私服下载 ssm_dao。

公司在自己的局域网内搭建自己的远程仓库服务器，称为私服，私服服务器即是公司内部的 maven 远程仓库，每个员工的电脑上安装 maven 软件并且连接私服服务器，员工将自己开发的项目打成 jar 并发布到私服服务器，其它项目组从私服服务器下载所依赖的构件（jar）。私服还充当一个代理服务器，当私服上没有 jar 包会从互联网中央仓库自动下载

搭建私服环境（了解）

1. 下载 nexus repository oss

   Nexus 是 Maven 仓库管理器，通过 nexus 可以搭建 maven 仓库，同时 nexus 还提供强大的仓库管理功能，构件搜索功能等

2. 安装：解压压缩包，用 powershell 管理员模式进入 bin 目录，执行 nexus.bat install。成功后可看到 nexus 服务

3. 卸载：同上，执行nexus.bat uninstall

4. 启动：同上，执行nexus.bat start。或在服务中直接启动。打开conf/nexus.properties根据配置访问仓库，使用内置账户密码 admin/admin123 登陆

nexus 仓库类型（默认在 sonatype-work 目录中）

• hosted：宿主仓库，部署自己的 jar 到这个仓库，有 releases (公司内部发布版本仓库) 和 snapshot(公司内部测试版本仓库)
• proxy：代理仓库，用于代理远程的公共仓库，如 maven 中央仓库，用户连接私服，私服自动去中央仓库下载 jar 包或者插件
• group：仓库组，用来合并多个 hosted/proxy 仓库，通常我们配置自己的 maven 连接仓库组
• virtual(虚拟)：兼容 Maven1 版本的 jar 或者插件

# 将项目发布到私服

1. 修改本地 Maven 的settings.xml，配置连接私服的用户和密码（此用户名和密码用于私服校验）

   <server>
       <id>releases</id>  <!--连接发布版本项目仓库 -->
       <username>admin</username>
       <password>admin123</password>
   </server>
   <server>
       <id>snapshots</id>  <!--连接测试版本项目仓库 -->
       <username>admin</username>
       <password>admin123</password>
   </server>
   

2. 配置项目 pom.xml

   <!--根据工程的版本号，决定上传到哪个宿主仓库-->
   <!--配置私服仓库的地址，本公司的自己的 jar 包会上传到私服的宿主仓库-->
   <distributionManagement>
       <repository>
           <id>releases</id>
           <url>http://localhost:8081/nexus/content/repositories/releases/</url>
       </repository>
       <snapshotRepository>
           <id>snapshots</id>
           <url>http://localhost:8081/nexus/content/repositories/snapshots/</url>
       </snapshotRepository>
   </distributionManagement>
   

   注意：pom.xml 这里<id> 和 settings.xml 配置 <id> 对应！

3. 对要发布到私服的项目执行deploy命令。根据本项目pom.xml中version定义决定发布到哪个仓库

# 从私服下载 jar 包

1. 修改本地 Maven 的settings.xml，配置私服的仓库

   <profile>
       <id>dev</id>   <!--profile 的 id-->
       <repositories>
           <repository>
               <id>nexus</id>  <!--仓库 id，repositories 可以配置多个仓库，保证 id 不重复-->
               <url>http://localhost:8081/nexus/content/groups/public/</url> <!--仓库地址，即 nexus 仓库组的地址-->
               <releases>    <!--是否下载 releases 构件-->
                   <enabled>true</enabled>
               </releases>
               <snapshots>   <!--是否下载 snapshots 构件-->
                   <enabled>true</enabled>
               </snapshots>
           </repository>
       </repositories>
       <pluginRepositories>
           <pluginRepository>  <!-- 插件仓库，maven 的运行依赖插件，也需要从私服下载插件 -->
               <id>public</id>   <!-- 插件仓库的 id 不允许重复，如果重复后边配置会覆盖前边 -->
               <name>Public Repositories</name>
               <url>http://localhost:8081/nexus/content/groups/public/</url>
           </pluginRepository>
       </pluginRepositories>
   </profile>
   

   <!--使用 profile 定义仓库需要激活才可生效-->
   <activeProfiles>
       <activeProfile>dev</activeProfile>
   </activeProfiles>
   

2. 测试时只删除 dao 的 jar 包，运行 web 项目即可

# 安装第三方 jar 包到本地仓库

【注意】powershell 失败，但是 cmd 执行成功。后续 oracle 的 maven 坐标添加需要使用这个方法。Zip 包安装失败！其实是由于 powershell 执行带参数的命令时需要用''包裹起来

• cmd 或 powershell 进入 jar 包所在目录并运行

  mvn install:install-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dfile=fastjson-1.1.37.jar -Dpackaging=jar
  

  mvn install:install-file '-DgroupId=com.alibaba' '-DartifactId=fastjson' '-Dversion=1.1.37' '-Dfile=fastjson-1.1.37.jar' '-Dpackaging=jar'
  

• 打开 cmd 或 powershell 直接运行

  mvn install:install-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dpackaging=jar -Dfile=C:/my_java/mavenjar/fastjson-1.1.37.jar
  

  mvn install:install-file '-DgroupId=com.alibaba' '-DartifactId=fastjson' '-Dversion=1.1.37' '-Dpackaging=jar' '-Dfile=C:/my_java/mavenjar/fastjson-1.1.37.jar'
  

# 安装第三方 jar 包到私服

• 修改本地 Maven 的settings.xml，配置第三方仓库的 server 信息

  <server>
      <id>thirdparty</id>
      <username>admin</username>
      <password>admin123</password>
  </server>
  

• cmd 进入 jar 包所在目录并运行

  mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dpackaging=jar -Dfile=fastjson-1.1.37.jar -Durl=http://localhost:8081/nexus/content/repositories/thirdparty/ -DrepositoryId=thirdparty
  

• 打开 cmd 直接运行

  mvn deploy:deploy-file -DgroupId=com.alibaba -DartifactId=fastjson -Dversion=1.1.37 -Dpackaging=jar -Dfile=C:/my_java/mavenjar/fastjson-1.1.37.jar -Durl=http://localhost:8081/nexus/content/repositories/thirdparty/ -DrepositoryId=thirdparty
  

# IDEA 中的 Maven 项目

# IDEA 创建 Maven 工程

• Java 工程

  • 使用骨架（archetype）创建 Java 工程。需要补齐 IDEA 没有自动创建的目录，并设置其属性。如 resources（Resources Root）

  

  • 不使用骨架（archetype）创建 Java 项目：resources 自动创建并设置，仅仅少了 test 下 resources 目录。建议使用！

• Web 工程

  • 使用骨架（archetype）创建 Java Web 工程。需要补齐 main 目录下 java（Sources Root）、resources（Resources Root）

    

资源包修改：Project Structure—>Modules 即可设置，但是一般不会修改。

Maven 中 project 标签下初始配置可以如下，稍加修改

<modelVersion>4.0.0</modelVersion>

<groupId>com.itheima</groupId>
<artifactId>maven-01</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>

# Maven 项目的运行

• 方法一：

  • 在 maven_web 子模块的 pom.xml 中配置 tomcat 插件运行（需 install）

    运行 ssm_web 工程它会从本地仓库下载依赖的 jar 包（需要将 maven_web 所依赖的所有模块发布至本地仓库，直接 install 父工程也行），所以当 ssm_web 依赖的 jar 包内容修改了必须及时发布到本地仓库，比如：ssm_web 依赖的 ssm_service 修改了，需要及时将 ssm_service 发布到本地仓库。

  方法二：

  • 在 maven_parent 父工程的 pom.xml 中配置 tomcat 插件运行，自动聚合并执行（推荐）（需 install）

    如果子工程都在本地，采用方法 2 则不需要子工程修改就立即发布到本地仓库，父工程会自动聚合并使用最新代码执行。

    注意：如果子工程和父工程中都配置了 tomcat 插件，运行的端口和路径以子工程为准。

  方法三：

  • 使用本地 Tomcat 部署（依赖其他模块时需 install 被依赖模块，否则只需 package）

    

  • 注意自动生成得 Artifacts 可能路径不对（那是由于在配置 Deployment 时删掉了两个 Build，特别是第二个生成 Artifacts 路径的那个）。但是由于老项目编码问题太烦人，所以删掉也可以（只删除第一个暂未尝试）

    

    

  • 但是其实自动生成的是对的，在配置 Deployment 时不删除 Before Launch 中的选项时是可以运行的（特别是第二个！第二个才是生成该目录的构建）

    

    

# 解决 Maven 项目中 Java 版本警告

在 POM.xml 中添加如下配置（Spring Boot 就是这样配置的）。可查看 Maven 文档配置

<properties>
  <java.version>1.8</java.version>
  <maven.compiler.source>${java.version}</maven.compiler.source>
  <maven.compiler.target>${java.version}</maven.compiler.target>
  <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <resource.delimiter>@</resource.delimiter>
</properties>