Maven笔记

---

title: Maven
tag: maven的使用
categories: 分类
comment: 是否允许评论(true or false)
description: 描述
top_img: https://z3.ax1x.com/2021/10/06/4xq2s1.png

cover: https://z3.ax1x.com/2021/10/06/4xq2s1.png

一 项目基础

1.完成一个java项目，需要做哪些工作

• 分析项目要做什么，知道项目有哪些组成部分
• 设计项目，通过哪些步骤，使用哪些技术，需要多少人，多长时间
• 组件团队，招人、购置设备、服务器、软件、笔记本
• 开发人员写代码。开发人员需要测试自己写的代码。重复多次工作
• 测试人员，测试项目功能是否符合要求

2传统开发项目的问题，没有使用maven管理的项目

• 很多模块、模块之间有关系，手工管理关系，比较繁琐
• 需要很多第三方功能，需要很多jar文件，需要手工从网络中获取各个jar
• 需要管理jar的版本，并且版本要一样
• 管理jar文件之间的依赖，如果你的项目要使用a.jar需要使用b.jar,那么必须先获取b.jar里面的类。

3.需要改进项目的开发和管理，需要maven

• maven可以管理jar文件
• 自动下载jar和他的文档，源代码
• 管理jar直接的依赖，a.jar需要b.jar,maven会自动下载b.jar
• 帮你编译程序，把java编译为class
• 帮你测试你的代码是否正确
• 帮你打包文件，形成jar文件，或者war文件
• 帮你部署项目

4.构建：项目的构建

构建是面向过程的，就是一些步骤，完成项目代码的编译，测试，运行，打包，部署等等。

maven支持的构建包括有：

• 清理，把之前项目编译的东西清理掉，为新的编译代码提供准备
• 编译，把程序源代码编译为执行代码，java-class
• 测试，maven可以测试程序代码，验证你的功能是否正确
• 报告，生成测试结果的文件，同时测试很多功能
• 打包，把你的项目中所有的class文件，配置文件等所有资源放到一个压缩文件中，这个压缩文件就是项目的结果文件，通常java程序，压缩文件是jar扩展名的
• 安装，把5中生成的文件jar,war安装到本机仓库
• 部署，把程序安装好可以执行

5 maven核心概念：用好maven，了解这些概念

• POM：一个文件，名称是pom.xml,pom翻译过来叫做项目对象模型

  maven把一个项目当做一个模型使用。控制maven构建项目的过程，管理jar依赖。

• 约定的目录结构：maven项目的目录和文件的位置都是规定的

• 坐标：是一个唯一的字符串，用来表示资源的

• 依赖管理：管理你的项目可以使用jar文件

• 仓库管理：你的资源存放的位置

• 生命周期(了解)：maven工具构建项目的过程，就是生命周期。

6.maven工具的安装和配置

1）需要从maven的官网下载maven的安装包 apache-maven-3.3.9-bin.zip 我用3.8.1
2）解压安装包，解压到一个目录，非中文目录。
子目录 bin ：执行程序，主要是mvn.cmd
conf ：maven工具本身的配置文件 settings.xml
3）配置环境变量
在系统的环境变量中，指定一个M2_HOME的名称， 指定它的值是maven工具安装目录，bin之前的目录

M2_HOME=D:\work\maven_work\apache-maven-3.3.9

 再把M2_HOME加入到path之中，在所有路径之前加入 %M2_HOME%\bin;

4）验证，新的命令行中，执行mvn -v

注意：需要配置JAVA_HOME ，指定jdk路径

C:\Users\Administrator>mvn -v
 出现如下内容，maven安装，配置正确。
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-11T00:41:4
Maven home: D:\work\maven_work\apache-maven-3.3.9
Java version: 1.8.0_40, vendor: Oracle Corporation
Java home: C:\java\JDK8-64\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos"

二 Maven基础知识

1.maven约定的目录结构，约定是大家都遵循的一个规则。

每一个maven项目在磁盘中都是一个文件夹(项目-Hello)

每一个maven项目在磁盘中都是一个文件夹（项目-Hello）
Hello/
-------/src
------/main #放你主程序java代码和配置文件
----------/java #你的程序包和包中的java文件
----------/resources #你的java程序中要使用的配置文件

  ------/test  #放测试程序代码和文件的（可以没有）
  ----------/java       #测试程序包和包中的java文件
  ----------/resources  #测试java程序中要使用的配置文件

  ---/pom.xml  #maven的核心文件（maven项目必须有）

2.疑问： 命令行中 mvn compile 指令是编译src/main目录下的所有java文件的。

• 命令行中为什么有下载现象

  maven工具执行的操作需要很多插件(java类-jar文件)完成

• 下载什么东西了

  jar文件-叫做插件-插件用来完成某些功能

  3）下载的东西存放到哪里了。
      默认仓库（本机仓库）：
     C:\Users\（登录操作系统的用户名）Administrator\.m2\repository
  
  
  
  Downloading: https://repo.maven.apache.org/maven2/org/apache/maven/maven-plugin-parameter-documenter-2.0.9.pom
  
  

  https://repo.maven.apache.org ：中央仓库的地址

  执行mvn compile， 结果是在项目的根目录下生成target目录（结果目录，与src同级），
  maven编译的java程序，最后的class文件都放在target目录中
  
  
  设置本机存放资源的目录位置(设置本机仓库)：
   1. 修改maven的配置文件， maven安装目录/conf/settings.xml
      先备份 settings.xml
  
   2. 修改 <localRepository>  指定你的目录（不要使用中文目录）
  
   D:\work\maven_work\maven_repository
   
   我的：D:\JavaEnvironment\Maven\maven_repository
   【记得上面的 \ 统统得改成 / 】
  

3.仓库

• 仓库是什么：仓库是存放东西的，存放maven使用的jar和我们项目使用的Jar

• > maven使用的插件（各种jar）

    > 我项目使用的jar(第三方的工具)
  

  2）仓库的分类

  本地仓库， 就是你的个人计算机上的文件夹，存放各种jar
  远程仓库， 在互联网上的，使用网络才能使用的仓库
  ①：中央仓库，最权威的， 所有的开发人员都共享使用的一个集中的仓库，
  https://repo.maven.apache.org ：中央仓库的地址
  ②：中央仓库的镜像：就是中央仓库的备份， 在各大洲，重要的城市都是镜像。
  ————————————————

	③：私服，在公司内部，在局域网中使用的， 不是对外使用的。

3）仓库的使用，maven仓库的使用不需要人为参与

如：	开发人员需要使用mysql驱动--->maven首先查本地仓库--->私服--->镜像--->中央仓库

4.pom：项目对象模型，是一个pom.xml文件

![img](https://img-blog.csdnimg.cn/c03ec3e7456a46ba99f5f8f8e1fe3c26.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2FhYV9oYW8=,size_16,color_FFFFFF,t_70#pic_center

• 坐标：唯一值，在互联网中唯一标识一个项目的

  公司域名的倒写
  自定义项目名称
  自定版本号

  https://mvnrepository.com/ 搜索使用的中央仓库， 使用groupId 或者 artifactId作为搜索条件

• packaging:打包后压缩文件的扩展名，默认是jar,web应用是war

  packaging可以不写，默认是jar

• 依赖

  dependencies和dependency，相当于java代码中import

  你的项目中要使用的各种资源说明，比如我的项目要使用Mysql驱动

  <dependencies>
  		<!--配置依赖  相当于java代码中 import -->
  	  <dependency>
  		<groupId>mysql</groupId>
  		<artifactId>mysql-connector-java</artifactId>
  		<version>5.1.9</version>
  	 </dependency>
   
   </dependencies>
  

• properties:设置属性

• build：maven在进行项目的构建时，配置信息，例如指定编译java代码使用的jdk的版本等

5.maven生命周期，maven的命令，maven的插件

maven的生命周期：就是maven构建项目的过程，清理，编译，测试，报告，打包，安装，部署

maven的命令：maven独立使用，通过命令，完成maven的生命周期的执行

• 单元测试：用的是junit,junit是一个专门为用于测试的框架(工具)

  junit测试的内容：测试的是类中的方法，每一个方法都是独立测试的

• 使用步骤：

  加入依赖，在pom.xml加入单元测试依赖

  	  	 <!-- 单元测试 -->
  		 <dependency>
  			<groupId>junit</groupId>
  			<artifactId>junit</artifactId>
  			<version>4.11</version>
  			<scope>test</scope>
  		</dependency>
  

   2.在maven项目中的src/test/java目录下，创建测试程序。
      推荐的创建类和方法的提示：
  	 1.测试类的名称 是Test + 你要测试的类名
  	 2.测试的方法名称 是：Test + 方法名称
  
  	 例如你要测试HelloMaven ,
  	 创建测试类 TestHelloMaven
     @Test
  	 public void testAdd(){
        测试HelloMaven的add方法是否正确
  	 }
  
  
  
  	 其中testAdd叫做测试方法，它的定义规则
  	 1.方法是public的，必须的
  	 2.方法没有返回值， 必须的
  	 3.方法名称是自定义的，推荐是test + 方法名称
  	 4.在方法的上面加入 @Test
  
  
  
   3)mvn compile 
     编译main/java/目录下的 java 为class文件， 同时把class拷贝到 target/classes目录下面
  	把main/resources目录下的所有文件 都拷贝到target/classes目录下
  

  插件的配置

  

Maven的常用命令

Maven对所有的功能提供相对应的命令，要想知道maven都有哪些命令，就需要知道mave有哪些功能。maven的主要三个功能：管理依赖，构建项目，管理项目信息。管理依赖，需要声明就可以自动到仓库下载：管理项目信息其实就是生成一个站点文档，一个命令就可以解决，maven功能的主体其实就是项目的创建。

Maven提供一个项目构建的模型，把编译、测试、打包、部署等都对应成一个个生命周期阶段，并对每一个阶段提供相应的命令，程序员只需要掌握一小堆命令，就可以完成项目的构建过程。

mvn clean 清理(会删除原来编译和测试的目录，即target目录，但是已经install到仓库里的包不会删除)

mvn compile 编译测试程序(会在当前目录下生成一个target,里边存放编译测试程序之后生成的字节码文件)

mvn test 测试(会生成一个目录surefire-reports ,保存测试结果)

mvn install 安装主程序(会把本工程打包，并且按照本工程的坐标保存到本地仓库中)

mvn deploy 部署主程序(会把本工程打包，按照本工程的坐标保存到本地库中，并且还会保存到私服仓库中，还会自动把项目部署到web容器中)

三、IDEA使用Maven

• 在idea中设置maven，让idea和maven结合使用

  idea中内置了maven,但是一般都是不适用内置的，因为内置修改maven的设置不方便。使用自己安装的maven，需要覆盖idea中的默认设置，让idea知道maven安装位置等信息。

  配置的入口 ①：配置当前工程的设置， file–settings —Build, Excution,Deployment–Build Tools
  –Maven
  Maven Home directory: maven的安装目录
  User Settings File : 就是maven安装目录conf/setting.xml配置文件
  Local Repository : 本机仓库的目录位置

    		   --Build Tools--Maven--Runner  
    			  VM Options : -DarchetypeCatalog=internal
    			  JRE: 你项目的jdk
  
              -DarchetypeCatalog=internal : maven项目创建时，会联网下载模版文件，
  				  比较大， 使用-DarchetypeCatalog=internal，不用下载， 创建maven项目速度快。
  
  
         （现在没有other settings了） ②：配置以后新建工程的设置， file--other settings--Settings for New Project
  

• 使用模板创建项目

  1）maven-archetype-quickstart : 普通的java项目
  2）maven-archetype-webapp : web工程

  

添加模板的流程：

这里会需要坐标的三个值，以quickstart为例，直接到这个网址找：https://maven.apache.org/archetypes/maven-archetype-quickstart/summary.htm

进入网址后：可以看到Build Information即为我们需要的坐标值，将坐标值填入上面即可

用maven-archetype-quickstart 模板创建了java项目后得自己手动在main和test添加目录下添加resources文件夹，右键new下面的Directory选中后下面可以选resources类型的文件夹，选中回车就好了。

普通java项目的完整目录：

其中App和AppTest是默认生成的，可以删掉

Web工程的完整目录：

其中main下的java、resource还有test及其下所有文件夹都得自己添加，new Directory后会有提示。

普通java项目的pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<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>

  <!-- 自己的项目坐标（gav） -->
  <groupId>com.kaho</groupId>
  <artifactId>ch01-javase-maven</artifactId>
  <version>1.0</version>
    <!-- 这里指明包的类型 -->
  <packaging>jar</packaging> 


  <properties>
    <!-- maven构建项目使用的是utf-8，避免中文的乱码 -->
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <!-- 编译java代码使用的jdk版本 -->
    <maven.compiler.source>1.8</maven.compiler.source>
    <!-- 你的java项目应该运行在什么样的jdk版本 -->
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <!-- 依赖 -->
  <dependencies>
    <!-- 单元测试 -->
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <!-- 插件配置管理，这一块自动生成的，可以删掉，写不写都实际存在 -->
  <build>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-jar-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
        <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
        <plugin>
          <artifactId>maven-site-plugin</artifactId>
          <version>3.7.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-project-info-reports-plugin</artifactId>
          <version>3.0.0</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

Web项目的pom.xml

<?xml version="1.0" encoding="UTF-8"?>

<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.kaho</groupId>
  <artifactId>ch02-maven-web</artifactId>
  <version>1.0</version>
  <!-- web项目是war文件 -->
  <packaging>war</packaging>


  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <finalName>ch02-maven-web</finalName>
    <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
      <plugins>
        <plugin>
          <artifactId>maven-clean-plugin</artifactId>
          <version>3.1.0</version>
        </plugin>
        <!-- see http://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_war_packaging -->
        <plugin>
          <artifactId>maven-resources-plugin</artifactId>
          <version>3.0.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-compiler-plugin</artifactId>
          <version>3.8.0</version>
        </plugin>
        <plugin>
          <artifactId>maven-surefire-plugin</artifactId>
          <version>2.22.1</version>
        </plugin>
        <plugin>
          <artifactId>maven-war-plugin</artifactId>
          <version>3.2.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-install-plugin</artifactId>
          <version>2.5.2</version>
        </plugin>
        <plugin>
          <artifactId>maven-deploy-plugin</artifactId>
          <version>2.8.2</version>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

Maven工具窗口

例如：双击clean，则会把左侧目录中的target目录清除

双击compile，则会编译生成target

双击test，则会执行test中的测试代码，如：

双击package，则会将工程打包并生成在target目录下，如：

双击install，就会将工程jar安装到本地仓库中，如：

插件和依赖：

Maven配置web环境

不需要和以往一样，而是用依赖的方式，在pom.xml文件中加入下面代码，这样就可以写servlet程序了

    <!-- 加入servlet依赖（servlet的jar）-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>
    <!-- jsp的依赖（jsp相关的jar加入进来） -->
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.1</version>
      <scope>provided</scope>
    </dependency>
    <!-- Tomcat的依赖，添加后就能在new中就可以找到servlet了 -->
    <dependency>
      <groupId>org.apache.tomcat</groupId>
      <artifactId>tomcat</artifactId>
      <version>8.0.50</version>
      <type>pom</type>
    </dependency>    

注意：如果加入上述代码后会爆红，只需要进入maven工具串口中刷新一下即可。

IDEA中导入模块module

选择项目文件夹，点击OK

导入之后记得在这里设置JDK

四 maven Scope的使用范围

• 依赖范围，使用scope表示的

  scope的值有compile,test,provided,默认是compile(所有过程都起作用)

  scope：表示依赖使用的范围，也就是在maven构建项目的哪些阶段中起作用

  maven构建项目：编译、测试、打包、安装、部署过程

junit的依赖范围是test，即只是在测试过程中起作用

<dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

<dependency>
  <groupId>a</groupId>
  <artifactId>b</artifactId>   b.jar 是compile，即所有过程都起作用
  <version>4.11</version>
  <scope>compile</scope>
</dependency>



 <dependency>
  <groupId>javax.servlet</groupId>
  <artifactId>javax.servlet-api</artifactId>
  <version>3.1.0</version>          servlet.jar
  <scope>provided</scope> 提供者：在编译、测试过程起作用，但打包、安装、部署不需要
</dependency>

在写项目的过程中的用到的所有依赖jar,必须在本地仓库中有。

没有的话必须通过maven下载，包括provided的都必须下载

你在servlet需要继承HttpServlet( provided) , 你使用的HttpServlet是maven仓库中的。

当你的写好的程序， 放到 tomat服务器中运行时， 此时你的程序中不包含servlet的jar
因为tomcat提供了 servlet的.jar

五、maven的常用操作

1.maven的属性设置

设置maven的常用属性

2.maven的全局变量

自定义的属性

1.在 通过自定义标签声明变量（标签名就是变量名）
2.在pom.xml文件中的其它位置，使用 ${标签名} 使用变量的值

自定义全局变量一般是定义 依赖的版本号， 当你的项目中要使用多个相同的版本号，
先在<properties>中使用全局变量定义，再在<version>中使用${变量名}表示这个统一的版本号

3.资源插件

 <build>
	<resources>
	<resource>
	<directory>src/main/java</directory><!--所在的目录-->
	<includes><!--包括目录下的.properties,.xml 文件都会扫描到-->
	<include>**/*.properties</include>
	<include>**/*.xml</include>
	</includes>
	<!--filtering 选项 false 不启用过滤器， *.property 已经起到过滤的作用了 -->
	<filtering>false</filtering>
	</resource>
	</resources>
 </build>

在mybatis中一般会用到这个

1. 默认没有使用resources的时候， maven执行编译代码时， 会把src/main/resources目录中的文件拷贝到target/classes目录中。对于src/main/java目录下的非java文件不处理，不拷贝到target/classes目录中

2.我们的程序有需要把一些文件放在src/main/java目录中，当执行java程序时，需要用到src/main/java目录中的文件。需要告诉maven 在 mvn compile 编译 src/main/java目录下的程序时，需要把这些文件一同拷贝到target/classes目录中。此时就需要在 <build> 中加入 <resources>

es>

src/main/java

/*.properties
/*.xml


false

在mybatis中一般会用到这个

```xml
1. 默认没有使用resources的时候， maven执行编译代码时， 会把src/main/resources目录中的文件拷贝到target/classes目录中。对于src/main/java目录下的非java文件不处理，不拷贝到target/classes目录中

2.我们的程序有需要把一些文件放在src/main/java目录中，当执行java程序时，需要用到src/main/java目录中的文件。需要告诉maven 在 mvn compile 编译 src/main/java目录下的程序时，需要把这些文件一同拷贝到target/classes目录中。此时就需要在 <build> 中加入 <resources>