Java-Web知识点 Maven

概述

Maven 的正确发音是[ˈmevən]，而不是“马瘟”以及其他什么瘟。Maven 在美国是一个口语化的词 语，代表专家、内行的意思。 一个对 Maven 比较正式的定义是这么说的：Maven 是一个项目管理工具，它包含了一个项目对象模 型 (POM：Project Object Model)，一组标准集合，一个项目生命周期(Project Lifecycle)，一个依赖管 理系统(Dependency Management System)，和用来运行定义在生命周期阶段(phase)中插件(plugin)目标 (goal)的逻辑。

作用

• 构建工程,管理 jar 包,编译代码,自动运行单元测试,打包,生成报表,部署项目,生成 Web站点等

依赖管理(导入坐标,jar版本冲突)

• Maven 的一个核心特性就是依赖管理。当我们涉及到多模块的项目（包含成百个模块或者子项目），管理依赖就变成 一项困难的任务。Maven 展示出了它对处理这种情形的高度控制。
• maven 工程中不直接将 jar 包导入到工程中，而是通过在 pom.xml 文件中添加所需 jar 包的坐标，这样就很好的避免了 jar 直接引入进来，在需要用到 jar 包的时候，只要查找 pom.xml 文 件，再通过 pom.xml 文件中的坐标，到一个专门用于”存放 jar 包的仓库”(maven 仓库)中根据坐标从 而找到这些 jar 包，再把这些 jar 包拿去运行。
• 通过 pom.xml 文件配置要引入的 jar 包的坐标，再读取坐标并到仓库中加载 jar 包，这 样我们就可以直接使用 jar 包了，为了解决这个过程中速度慢的问题，maven 中也有索引的概念，通过建立索引，可以大大提高加载 jar 包的速度，使得我们认为 jar 包基本跟放在本地的工程文件中再 读取出来的速度是一样的。

项目的一键构建(编译代码,运行代码)

• 构建指的是项目从编译、测试、运行、打包、安装 ，部署整个过程都交给 maven 进行管理.
• 而一键构建. 指在maven项目路径下,使用tomcat:run这个命令
  这将工程的编译,测试,运行都变得非常简单.

安装

• 我曾经写过相同的文章链接
• 目录结构
  

分类

• 本地仓库 ：用来存储从远程仓库或中央仓库下载的插件和 jar 包，项目使用一些插件或 jar 包， 优先从本地仓库查找
  • 默认本地仓库位置在 ${user.dir}/.m2/repository，${user.dir}表示windows 用户目录
  • 可以通过在settings.xml中进行修改
    
• 远程仓库[私服]:如果本地需要插件或者 jar 包，本地仓库没有，默认去远程仓库下载。 远程仓库可以在互联网内也可以在局域网内。
• 中央仓库: 在maven 软件中内置一个远程仓库地址 http://repo1.maven.org/maven2 ，它是中 央仓库，服务于整个互联网，它是由 Maven 团队自己维护，里面存储了非常全的 jar 包，它包含了世界上大部分流行的开源项目构件.
  

目录结构

作为一个 maven 工程，它的 src目录和 pom.xml 是必备的。 进入 src目录后，我们发现它里面的目录结构如下：

src/main/java —— 存放项目的.java 文件
src/main/resources —— 存放项目资源文件，如 spring, hibernate 配置文件
src/test/java —— 存放所有单元测试.java 文件，如 JUnit 测试类 
src/test/resources —— 测试资源文件
target —— 项目输出位置，编译后的class 文件会输出到此目录
pom.xml——maven 项目核心配置文件 

注意：如果是普通的 java 项目，那么就没有webapp 目录

运行

进入 maven 工程目录（当前目录有 pom.xml 文件），运行 tomcat:run 命令。
根据上边的提示信息，通过浏览器访问：http://localhost:8080/项目名/

问题

如果本地仓库配置错误会报下边的错误

• 分析:
  maven 工程运行先从本地仓库找 jar 包，本地仓库没有再从中央仓库找，上边提示 downloading… 表示 从中央仓库下载 jar，由于本地没有联网，报错。

• 解决： 在 maven 安装目录的conf/setting.xml 文件中配置本地仓库，参考“：maven 仓库/配置本地仓库章节”。

命令

• compile
  • compile 是 maven 工程的编译命令，作用是将 src/main/java 下的文件编译为 class 文件输出到 target 目录下。
• test
  • test 是 maven 工程的测试命令 mvn test，会执行src/test/java下的单元测试类。 cmd 执行 mvn test 执行 src/test/java 下单元测试类，下图为测试结果，运行 1 个测试用例，全部成功。
    
• clean
  • clean是maven工程的清理命令,执行clean 会删除target目录及内容.
• package
  • package 是 maven 工程的打包命令，对于 java 工程执行 package 打成 jar 包，对于web 工程打成war 包。 (也会将项目进行编译,包括text的)
• install
  • install 是 maven 工程的安装命令，执行 install 将 maven 打成 jar 包或 war 包发布到本地仓库。
• deploy
  • deploy 需要进行配置,然后才能进行发布操作
    注意:当后面的命令执行时，前面的操作过程也都会自动执行.按照顺序不包括clean命令

生命周期

• maven 对项目构建过程分为三套相互独立的生命周期，请注意这里说的是“三套”，而且“相互独立”， 这三套生命周期分别是：

  • Clean Lifecycle 在进行真正的构建之前进行一些清理工作。
  • Default Lifecycle 构建的核心部分，编译，测试，打包，部署等等。
  • Site Lifecycle 生成项目报告，站点，发布站点。

概念模型

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

• 项目对象模型(Project Object Model)
  一个 maven 工程都有一个 pom.xml 文件，通过 pom.xml 文件定义项目的坐标、项目依赖、项目信息、 插件目标等。

• 依赖管理系统(Dependency Management System)

  • 通过 maven 的依赖管理对项目所依赖的 jar 包进行统一管理。

• 比如：项目依赖 junit4.9，通过在 pom.xml 中定义 junit4.9 的依赖即使用 junit4.9，如下所示是 junit4.9 的依赖定义：

<!-- 依赖关系 --> 
 <dependencies>   
 <!-- 此项目运行使用 junit，所以此项目依赖 junit -->  
   <dependency>  
			<!-- junit 的项目名称 --> 
			<groupId>junit</groupId>  
			<!-- junit 的模块名称 -->  
			<artifactId>junit</artifactId>  
			<!-- junit 版本 -->   
			<version>4.9</version>  
			<!-- 依赖范围：单元测试时使用 junit -->  
			<scope>test</scope> 
  </dependency> 

• 一个项目的生命周期(Project Lifecycle)
  使用 maven 完成项目的构建，项目构建包括：清理、编译、测试、部署等过程，maven 将这些 过程规范为一个生命周期，如下所示是生命周期的各各阶段：
  maven 通过执行一些简单命令即可实现上边生命周期的各各过程，比如执行 mvn compile 执行编译、 执行 mvn clean 执行清理(前面有命令介绍)
• 一组标准集合
  maven将整个项目管理过程定义一组标准，比如：通过 maven 构建工程有标准的目录结构，有标准的生命周期阶段、依赖管理有标准的坐标定义等。 (目录结构有介绍)
• 插件(plugin)目标(goal)
  maven 管理项目生命周期过程都是基于插件完成的。

idea的maven配置

依据图片指示，选择本地 maven 安装目录，指定 maven 安装目录下conf文件夹中 settings 配置文件。

idea中创建一个maven的web工程

打开 idea，选择创建一个新工程

选择 idea 提供好的 maven 的 web 工程模板
点击 Next 填写项目信息
点击 Next，此处不做改动。
点击 Next 选择项目所在目录

点击 Finish 后开始创建工程，耐心等待，直到出现如下界面
手动修改 src/main/java 目录，如下图右键 java文件夹上右键->Make Directory as->Sources Root
手动创建 src/main/java/resources 目录,在resoures上右键->Make Directory as->Resources Root

• 建议不使用骨架创建Maven项目.

坐标的来源

• 添加依赖需要指定依赖 jar 包的坐标，但是很多情况我们是不知道 jar 包的的坐标，可以通过如下方 式查询
  -http://search.maven.org/或http://mvnrepository.com/

将复制的信息粘贴到pom.xml内
例如:

<dependencies>
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-context</artifactId>
	    <version>5.1.7.RELEASE</version>
	</dependency>
</dependencies>

坐标的依赖范围

A 依赖 B，需要在 A 的 pom.xml 文件中添加 B 的坐标，添加坐标时需要指定依赖范围，依赖范围包括：

• compile：编译范围，指 A在编译时依赖 B，此范围为默认依赖范围。编译范围的依赖会用在 编译、测试、运行，由于运行时需要所以编译范围的依赖会被打包。
• provided：provided 依赖只有在当 JDK 或者一个容器已提供该依赖之后才使用， provided 依 赖在编译和测试时需要，在运行时不需要，比如：servlet api 被 tomcat 容器提供。
• runtime：runtime 依赖在运行和测试系统的时候需要，但在编译的时候不需要。比如：jdbc 的驱动包。由于运行时需要所以 runtime 范围的依赖会被打包。
• test：test 范围依赖 在编译和运行时都不需要，它们只有在测试编译和测试运行阶段可用， 比如：junit。由于运行时不需要所以test范围依赖不会被打包。
• system：system 范围依赖与 provided 类似，但是你必须显式的提供一个对于本地系统中 JAR 文件的路径，需要指定 systemPath 磁盘路径，system依赖不推荐使用。

依赖范围	对于编译classpath有效	对于测试classpath有效	对于运行时classpath有效	例子
compile	Y	Y	Y	spring-core
test	-	Y	-	Junit
provided	Y	Y	-	sevlet-api
runtime	-	Y	Y	JDBC驱动
system	Y	Y	-	本地的Maven仓库之外的类库

在 maven-web 工程中测试各各 scop。 测试总结：

• 默认引入 的 jar 包 -------> compile 【默认范围 可以不写】（编译、测试、运行 都有效 ）
• servlet-api 、jsp-api -------> provided （编译、测试 有效， 运行时无效 防止和 tomcat 下 jar 冲突）
• jdbc 驱动 jar 包 ----> runtime （测试、运行 有效 ）
• junit -----> test （测试有效）
• 依赖范围由强到弱的顺序是：compile>provided>runtime>test

项目中添加的坐标

设置 jdk 编译版本

• 需要设置编译版本为 1.8，这里需要使用 maven 的插件来设置： 在 pom.xml 中加入：

<build>
        <!--maven插件-->
        <plugins>
            <!--jdk编译插件-->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                    <encoding>utf-8</encoding>
                </configuration>
            </plugin>
        <plugins>
<build>

添加 tomcat7 插件

<!--tomcat插件-->
            <plugin>
                <groupId>org.apache.tomcat.maven</groupId>
                <!-- tomcat7的插件， 不同tomcat版本这个也不一样 -->
                <artifactId>tomcat7-maven-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                    <!-- 通过maven tomcat7:run运行项目时，访问项目的端口号 -->
                    <port>80</port>
                    <!-- 项目访问路径  本例：localhost:9090,  如果配置的aa， 则访问路径为localhost:9090/aa-->
                    <path>/travel</path>
                </configuration>
            </plugin>

• 此时点击 idea最右侧 Maven Projects，
• 就可以看到我们新添加的tomcat7 插件
• 双击 tomcat7插件下tomcat7:run 命令直接运行项目
  
  也可以直接点击如图按钮，手动输入 tomc7:run
  

断点试调

• 按图操作
  
  这样就可以正常的像tomcat进行操作.

总结

常用的 maven 命令

常用 的 maven 命令包括：

• compile：编译
• clean：清理
• test：测试
• package：打包
• install：安装

坐标定义

在 pom.xml 中定义坐标，内容包括：groupId、artifactId、version，详细内容如下：

<!--项目名称，定义为组织名+项目名，类似包名--> 
<groupId>cn.itcast.maven</groupId> 
<!-- 模块名称 --> 
<artifactId>maven-first</artifactId> 
<!-- 当前项目版本号，snapshot 为快照版本即非正式版本，release 为正式发布版本 --> 
<version>0.0.1-SNAPSHOT</version> 
<packaging > ：打包类型 

• jar：执行 package 会打成 jar 包
• war：执行 package 会打成 war 包
• pom ：用于 maven 工程的继承，通常父工程设置为 pom

pom 基本配置

pom.xml 是 Maven 项目的核心配置文件，位于每个工程的根目录，基本配置如下：

<project > ：文件的根节点 . 
<modelversion > ： pom.xml 使用的对象模型版本 
<groupId > ：项目名称，一般写项目的域名 <artifactId > ：模块名称，子项目名或模块名称 <version > ：产品的版本号 .  
<packaging > ：打包类型，一般有 jar、war、pom 等  <name > ：项目的显示名，常用于 Maven 生成的文档。   
<description > ：项目描述，常用于 Maven 生成的文档 
<dependencies> ：项目依赖构件配置，配置项目依赖构件的坐标 <build> ：项目构建配置，配置编译、运行插件等。 

简述

Maven 是什么?优点?

• 导入坐标,jar版本冲突
• 编译代码,运行代码
• 规范了工程的结构
• 整个测试案例统一执行