Maven笔记

---

一、Maven简介

1.1、软件是一个工程

软件工程：为了能够实现软件的流水线式生产，在设计和构建软件时能够有一种规范和工程化的方法，人们便提出了软件工程的概念。

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

• 很多模块，模块之间有关系，手工管理关系，比较繁琐。
• 需要很多第三方功能，需要很多jar文件，需要手工从网络中获取各个jar
• 需要管理jar的版本，比如你需要的是mysql.5.1.5.jar，那你不能给一个mysql.4.0.jar
• 管理jar文件之间的依赖，你的项目要使用a.jar需要使用b.jar里面的类。必须首先获取到b.jar才可以，然后才能使用a.jar
  注： a.jar需要b.jar这个关系叫做依赖，或者你的项目中要使用mysql的驱动，也可以叫做项目依赖mysql驱动。a.class使用b.class，a依赖b类。

1.3、需要改进项目的开发和管理，需要maven

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

1.4、构建：项目的构建

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

• 清理：把之前项目编译的东西删除掉，为新的编译代码做准备，
• 编译：把程序源代码编译为执行代码，java-class文件（批量的，maven可以同时把成千上百的文件编译为class。javac不一样，javac一次编译一个文件）。
• 测试：maven可以执行测试程序代码，验证你的功能是否正确。（批量的，maven同时执行多个测试代码，同时测试很多功能。）
• 报告：生成测试结果的文件，测试通过没有
• 打包：把你的项目中所有的class文件，配置文件等所有资源放到一个压缩文件中。这个压缩文件就是项目的结果文件，通常java程序，压缩文件是jar扩展名的，对于web应用，压缩文件扩展名是.war
• 安装：把打包中生成的文件jar、war安装到本机仓库
• 部署：把程序安装好可以执行。

1.5、maven核心概念

1、POM：一个文件名称是pom.xml，pom翻译过来叫做项目对象模型。maven把一个项目当一个模型使用。控制maven构建项目的过程，管理jar依赖。
2、约定的目录结构：maven项目的目录和文件的位置都是规定的。
3、坐标：是一个唯一的字符串，用来表示资源的。
4、依赖管理：管理你的项目可以使用jar文件
5、仓库管理（了解）：资源存放的位置
6、生命周期（了解）：maven工具构建项目的过程，就是生命周期。
7、插件和目标（了解）：执行maven构建的时候用的工具是插件
8、继承
9、聚合

1.6、maven工具的安装和配置

1、需要从maven的官网下载maven的安装包
2、解压安装包，解压到一个目录，非中文目录。
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
出现如下内容，maven安装，配置正确

二、Maven的核心概念

2.1、maven约定的目录结构

每一个maven项目在磁盘中都是一个文件夹。比如（项目名-Hello）

2.2、mvn compile 编译src/main目录下的所有Java文件。

第一次使用会下载东西

• maven工具执行的操作需要很多插件（Java类–jar文件）完成的
• 下载的是jar文件–叫做插件–插件是完成某些功能
• 下载的东西存放在默认仓库（本机仓库）：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目录（结果目录），maven编译的Java程序，最后的class文件都放在target目录中。
设置本机存放资源的目录位置（设置本机仓库）：
1、修改maven的配置文件，maven安装目录/conf/setting.xml 先备份setting.xml
2、修改 < localRepository > 指定你的目录（不要使用中文目录）

2.3、仓库

1、仓库：仓库是存放东西的，存放，maven使用的jar包和我们项目使用的jar
> maven使用的插件（各种jar）
>我项目使用的jar（第三方工具）
2、仓库的分类
本地仓库，就是你的个人计算机上的文件夹，存放各种jar
远程仓库，在互联网上，使用网络才能使用的仓库
①：中央仓库，最权威的，所有开发人员都共享使用的一个集中的仓库。 https://repo.maven.apache.org ：中央仓库的地址
②：中央仓库的镜像：就是中央仓库的备份，在各大洲、重要的城市都有镜像。
③：私服，在公司内部，在局域网中使用的，不是对外使用的
3、仓库的使用，maven仓库的使用不需要人为参与。比如开发人员需要使用mysql驱动—>maven首先查看本地仓库—>私服—>镜像—>中央仓库

2.4、pom（项目对象模型，是一个pom.xml文件）

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

    <groupId>公司域名的倒写</groupId >
    <artifactId>自定义项目名称</artifactId>
    <version>自定版本号</version>

https://mvnrepository.com/ 搜索使用的中央仓库， 使用groupId 或者 artifactId作为搜索条件。
2、packaging：打包后压缩文件的扩展名，默认是jar，web应用是war。（packaging可以不写，默认是jar）
3、依赖
dependencies和dependency，相当于是Java代码中import
比如我的项目要使用mysql驱动

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

4、properties：设置属性
5、build：maven在进行项目的构建时，配置信息，例如指定编译Java代码使用的jdk的版本等。

2.5、maven的生命周期，maven的命令，maven的插件

1、maven的生命周期：就是maven构建项目的过程。清理、编译、测试、报告、打包、安装、部署
2、maven的命令：maven三大功能：管理依赖、构建项目、管理项目信息。管理依赖，只需要声明就可以自动到仓库下载；管理项目信息其实就是生成一个站点文档，一个命令就可以解决。最后再说：那maven功能的主体其实就是项目构建。
maven独立使用，通过命令，完成maven的生命周期的执行。maven可以使用命令，完成项目的清理，编译，测试等等。
Maven常用命令：

• mvn clean：清理（会删除原来编译和测试的目录，即target目录，但是已经install到仓库里的包不会删除）
• mvn compile：编译主程序（会在当前目录下生成一个target，里面存放编译主程序之后生成的字节码文件）
• mvn test-compile：编译测试程序（会在当前目录下生成一个target，里面存放编译测试程序之后生成的字节码文件）
• mvn test：测试（会生成一个目录surefire-reports，保存测试结果）
• mvn package：打包主程序（会编译、编译测试、测试、并且按照pom.xml配置把主程序打包生成jar包或者war包）
• mvn install：安装主程序（会把本工程打包，并且按照本工程的坐标保存到本地仓库中）
• mvn deploy：部署主程序（会把本工程打包，按照本工程的坐标保存到本地库中，并且还会保存到私服仓库中。还会自动把项目部署到web容器中）。
  注意：执行以上命令必须在命令行进行pom.xml所在目录！！！
  3、maven的插件：maven命令执行时，真正完成功能的是插件，插件就是一些jar文件，一些类。
  补充：单元测试（测试方法）：用的是junit，junit是一个专门测试的框架（工具）。
  junit测试的内容：测试的是类中的方法，每一个方法都是独立测试的。方法是测试的基本单位（单元）。
  maven借助单元测试，批量的测试你类中的大量方法是否符合预期的
  使用步骤：
  1、加入依赖，在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+方法名称。
测试方法的定义规则：
1.方法是public的，必须的
2.方法没有返回值， 必须的
3.方法名称是自定义的，推荐是Test + 方法名称
4.在方法的上面加入 @Test

三、依赖管理

依赖范围，使用scope表示的。
scope表示依赖使用的范围，也就是maven构建项目的哪些阶段中起作用。
maven构建项目 编译，测试，打包，安装，部署过程（阶段）

3.1、依赖的范围

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.11</version>
<scope>test</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仓库中的。
当你写好的程序，放到tomcat服务器运行时，此时你的程序中不包含servlet的jar，因为tomcat提供了servlet的.jar。

四、Maven常用操作

4.1、maven的属性设置

< properties>设置maven的常用属性

4.2、maven的全局变量

自定义的属性：
①、在< properties>通过自定义标签声明变量（标签名就是变量名）
②、在pom.xml文件中的其他位置，使用$ (标签名)使用变量的值
自定义全局变量一般是定义依赖的版本号，当你的项目中要使用多个相同的版本号，先使用全局变量定义，再使用$(变量名)。

4.3、资源插件（指定资源位置）

src/main/java和src/test/java 这两个目录中的所有*.java文件分别在comile和test-comiple阶段被编译，编译结果分别放到了target/classes和target/test-classes目录中，但是这两个目录中的其他文件都会被忽略掉，如果需要把src目录下的文件包放到target/classes目录，作为输出的jar一部分。需要指定资源文件位置。
以下内容放到< build>标签中。

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