Maven基础知识整理

Maven

最近公司要新起项目，回过头来看一下关于构建工具的事。比较常用的就是maven了

。

maven是一个项目自动构建工具，类似的还有ant, gradle。maven具体是如何管理构建过程的呢？

首先什么是构建。写好的代码，要发布到web服务器，需要打包的过程，就是在构建。

maven工程必须按照约定的目录结构构建：

根目录：工程名
|---src：源码
|---|---main:存放主程序
|---|---|---java：java源码文件
|---|---|---resource：存放框架的配置文件
|---|---test：存放测试程序
|---pom.xml：maven的核心配置文件

pom.xml:

<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.hzg.maven</groupId>
    <artifactId>Hello</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <name>Hello</name>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.0</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

使用maven，最关键的就是这个pom.xml。可以看到，首先定义了项目的“坐标”，即groupId、artifactId、version，通过这个坐标可以唯一标识一个依赖，这个项目本身也可能会被发布到本地和远程仓库中，有了这个坐标就方便其他项目导入了。dependencies中定义的是项目用到的jar包，也是通过坐标来定位的。scope是依赖的范围，包括以下几种：

scope	含义
compile	默认值，适用于所有阶段（开发、测试、部署、运行）
provided	只在开发、测试阶段使用，避免servlet容器和本地仓库的jar包冲突
runtime	只在运行时使用，如JDBC驱动，适用运行和测试阶段
test	只在测试时使用，用于编译和运行测试代码，不会随项目发布
system	类似provided，需要显示提供包含依赖的jar，maven不会在仓库中查找它

写到这的时候了解了一下，比如项目中用到的lombok依赖的scope是provided。lombok只在编译阶段有效，在编译时将带lombok注解的java文件正确编译为完整的class文件。system不常用。

有的项目由于设计需要，可能会拆分为多个模块。例如在项目Hello中包含了模块a和模块b两个子模块，maven可以管理这种父子模块的关系，配置文件大概长这样：

父项目的配置文件：

<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.abcd.hello</groupId>
    <artifactId>hello-parent</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>
    
    <modules>   <!--子模块-->
        <module>hello-a</module>
        <module>hello-b</module>
    </modules>
    <properties>   <!--版本信息-->
        <slf4j.version>1.8.0</slf4j.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
        </dependency>
    </dependencies>
</project>

子模块的配置文件:

<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>
    <parent>
        <groupId>com.abcd.hello</groupId>
        <artifactId>hello-parent</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <artifactId>hello-a</artifactId>
    <packaging>war</packaging>    <!--指定打包方式为war包-->
</project>

项目中需要添加依赖时，加一个dependency标签即可。maven解析依赖时会先从本地仓库查找被依赖的jar包；如果本地仓库没有的，就会去中央仓库查找maven坐标来获取jar包，并下载到本地仓库中。而当我们的项目要被其他项目使用时，可能会用到mvn install/deploy命令，将项目发布到仓库中。仓库就好像是一个集中管理jar包的地方，当你本地可能有多个项目用到同一个依赖的时候，通过maven联系仓库来找就好了，而不用你自己去找jar包然后配置到项目里了，就节省了搭建项目的时间。

当我们找好了依赖，而且代码也写好的时候，这时候就需要构建，也就是说服务器并不认你写好的.java文件，只认编译过的.class文件，通过maven就可以帮你快速的编译整个项目的代码。有时候使用maven构建之后会发现项目多了一个target文件夹，这就是构建得到的东西都放在里面。

构建的各个环节包括：

环节	作用
clean	将以前编译得到的旧文件class字节码文件删除
compile	将java源程序编译成class字节码文件
test	自动测试，调用junit程序
report	测试程序执行的结果
package	打包(war/jar)
install	将打包得到的文件安装到仓库中
deploy	部署到远程服务器

Maven的生命周期模型(lifecycle)

maven有三套相互独立的生命周期，分别是：

1. clean lifecycle: 构建之前的清理工作
2. default lifecycle: 构建的核心部分，编译测试打包部署等等
3. site lifecycle: 生成项目报告，发布站点

可以仅仅调用clean来清理工作目录，也可以直接运行mvn clean install site运行所有三套生命周期。每套生命周期都由一组阶段(phase)组成，这些阶段是有顺序的，比如常用的mvn clean，会执行clean生命周期的clean阶段和之前所有的阶段。

生命周期	阶段	作用
clean	pre-clean	clean前的工作
clean	clean	移除所有上一次构建生成的文件
clean	post-clean	clean后的工作
default	validate
default	generate-sources
default	process-sources
default	generate-resources
default	process-resources	复制并处理资源文件到目标目录
default	compiile	编译项目源代码
default	process-classes
default	generate-test-sources
default	process-test-sources
default	generate-test-resources
default	process-test-resoureces	复制并处理资源文件到目标测试目录
default	test-compile	编译测试源代码
default	process-test-classes
default	test	使用合适的单元测试框架运行测试
default	prepare-package
default	package	接收编译好的代码，打包成可发布的格式如jar
default	pre-integration-test
default	integration-test
default	post-integration-test
default	verify
default	install	将打包安装到本地仓库
default	deploy	将打包复制到远程的仓库
site	pre-site
site	site
site	post-site
site	site-depoly

时间仓促，整理个大概，也算是有个大框理解了。

参考博客链接：

Maven生命周期详解

Maven最全笔记，99%的人都收藏了！