javaweb-maven基础-43

工程

已经上传到github
https://github.com/Jonekaka/three_200905/tree/master/temp/down_learn/maven/three

什么是 Maven

1.1.1 什么是 Maven
Maven 的正确发音是[ˈmevən]，而不是“马瘟”以及其他什么瘟。Maven 在美国是一个口语化的词
语，代表专家、内行的意思。
一个对 Maven 比较正式的定义是这么说的：Maven 是一个项目管理工具，它包含了一个 项目对象模
型 (POM：Project Object Model)，一组标准集合，一个项目生命周期(Project Lifecycle)，一个依赖管
理系统(Dependency Management System)，和用来运行定义在生命周期阶段(phase)中插件(plugin)目标
(goal)的逻辑。
1.1.2 Maven 能解决什么问题
可以用更通俗的方式来说明。我们知道，项目开发不仅仅是写写代码而已，期间会伴随着各种
必不可少的事情要做，下面列举几个感受一下：
1、我们需要引用各种 jar 包，尤其是比较大的工程，引用的 jar 包往往有几十个乃至上百个， 每用
到一种 jar 包，都需要手动引入工程目录，而且经常遇到各种让人抓狂的 jar 包冲突，版本冲突。
2、我们辛辛苦苦写好了 Java 文件，可是只懂 0 和 1 的白痴电脑却完全读不懂，需要将它编译成二
进制字节码。好歹现在这项工作可以由各种集成开发工具帮我们完成，Eclipse、IDEA 等都可以将代
码即时编译。当然，如果你嫌生命漫长，何不铺张，也可以用记事本来敲代码，然后用 javac 命令一
个个地去编译，逗电脑玩。
3、世界上没有不存在 bug的代码，计算机喜欢 bug就和人们总是喜欢美女帅哥一样。为了追求美为
了减少 bug，因此写完了代码，我们还要写一些单元测试，然后一个个的运行来检验代码质量。
4、再优雅的代码也是要出来卖的。我们后面还需要把代码与各种配置文件、资源整合到一起，定型
打包，如果是 web项目，还需要将之发布到服务器，供人蹂躏。
试想，如果现在有一种工具，可以把你从上面的繁琐工作中解放出来，能帮你构建工程，管理 jar
包，编译代码，还能帮你自动运行单元测试，打包，生成报表，甚至能帮你部署项目，生成 Web 站
点，你会心动吗？Maven 就可以解决上面所提到的这些问题。

Maven 优势举例

项目架构相同的多个工程，使用了相同的jar包，那么需要将jar包复制到每个工程中。导致项目臃肿，大部分都是jar包的占用
maven可以不用复制，减少jar占用？
传统项目将jar放入自己的项目中，maven将jar放入统一的jar仓库中，并定义好jar坐标，编译等需要就根据jar坐标索引，
依赖管理：maven工程队对jar包的管理过程
Maven 的一个核心特性就是依赖管理。当我们涉及到多模块的项目（包含成百个模块或者子项目），管理依赖就变成
一项困难的任务。Maven 展示出了它对处理这种情形的高度控制。
传统的 WEB 项目中，我们必须将工程所依赖的 jar 包复制到工程中，导致了工程的变得很大。那么
maven 工程是如何使得工程变得很少呢？
分析如下：

通过分析发现：maven 工程中不直接将 jar 包导入到工程中，而是通过在 pom.xml 文件中添加所需 jar
包的坐标，这样就很好的避免了 jar 直接引入进来，在需要用到 jar 包的时候，只要查找 pom.xml 文
件，再通过 pom.xml 文件中的坐标，到一个专门用于”存放 jar 包的仓库”(maven 仓库)中根据坐标从
而找到这些 jar 包，再把这些 jar 包拿去运行。
那么问题来了
第一：”存放 jar 包的仓库”长什么样？
第二：通过读取 pom.xml 文件中的坐标，再到仓库中找到 jar 包，会不会很慢？从而导致这种方式
不可行！
第一个问题：存放 jar 包的仓库长什么样，这一点我们后期会分析仓库的分类，也会带大家去看我们
的本地的仓库长什么样。
第二个问题：通过 pom.xml 文件配置要引入的 jar 包的坐标，再读取坐标并到仓库中加载 jar 包，这
样我们就可以直接使用 jar 包了，为了解决这个过程中速度慢的问题，maven 中也有索引的概念，通
过建立索引，可以大大提高加载 jar 包的速度，使得我们认为 jar 包基本跟放在本地的工程文件中再
读取出来的速度是一样的。这个过程就好比我们查阅字典时，为了能够加快查找到内容，书前面的
目录就好比是索引，有了这个目录我们就可以方便找到内容了，一样的在 maven 仓库中有了索引我
们就可以认为可以快速找到 jar 包。

项目的一键构建

我们的项目，往往都要经历编译、测试、运行、打包、安装 ，部署等一系列过程。
什么是构建？
指的是项目从编译、测试、运行、打包、安装 ，部署整个过程都交给 maven 进行管理，这个
过程称为构建。
一键构建
指的是整个构建过程，使用 maven 一个命令可以轻松完成整个工作

我们一起来看 Hello-Maven 工程的一键运行的过程。通过 tomcat:run 的这个命令，我们发现现在的
工程编译，测试，运行都变得非常简单。

进入目录后直接mvn tomcat:run运行方便

Maven 的安装

http://archive.apache.org/dist/maven/maven-3/
Maven 下载后，将 Maven 解压到一个没有中文没有空格的路径下，比如 D:\software\maven 下面。
解压后目录结构如下：

bin:存放了 maven 的命令，比如我们前面用到的mvn tomcat:run
boot:存放了一些 maven 本身的引导程序，如类加载器等
conf:存放了 maven 的一些配置文件，如 setting.xml 文件
lib:存放了 maven 本身运行所需的一些 jar 包
至此我们的 maven 软件就可以使用了，前提是你的电脑上之前已经安装并配置好了 JDK。

测试是否安装成功

Maven 仓库

maven 的工作需要从仓库下载一些 jar 包，如下图所示，本地的项目 A、项目 B 等都会通过 maven
软件从远程仓库（可以理解为互联网上的仓库）下载 jar 包并存在本地仓库，本地仓库 就是本地文
件夹，当第二次需要此 jar 包时则不再从远程仓库下载，因为本地仓库已经存在了，可以将本地仓库
理解为缓存，有了本地仓库就不用每次从远程仓库下载了。

中央仓库几乎放置了所有的开源jar包，但是为了安全与便利，也会开辟私服

本地仓库 ：用来存储从远程仓库或中央仓库下载的插件和 jar 包，项目使用一些插件或 jar 包，
优先从本地仓库查找
默认本地仓库位置在 $user.dir/.m2/repository，${user.dir}表示windows 用户目录。
如果不适用默认位置，在 MAVE_HOME/conf/settings.xml 文件中配置本地仓库位置（maven 的安装目录下）：

若在此目录下放置好jar包，便不用去中央仓库或者私服下载了
远程仓库：如果本地需要插件或者 jar 包，本地仓库没有，默认去远程仓库下载。
远程仓库可以在互联网内也可以在局域网内。
中央仓库 ：在 maven 软件中内置一个远程仓库地址 http://repo1.maven.org/maven2 ，它是中
央仓库，服务于整个互联网，它是由 Maven 团队自己维护，里面存储了非常全的 jar 包，它包
含了世界上大部分流行的开源项目构件。

maven 仓库地址、私服等配置信息需要在 setting.xml 文件中配置，分为全局配置和用户配置。
在 maven 安装目录下的有 conf/setting.xml 文件，此 setting.xml 文件用于 maven 的所有 project
项目，它作为 maven 的全局配置。
如需要个性配置则需要在用户配置中设置，用户配置的 setting.xml 文件默认的位置在：$user.dir/.m2/settings.xml目录中,${user.dir} 指windows 中的用户目录。
maven会先找用户配置，如果找到则以用户配置文件为准，否则使用全局配置文件。

Maven 工程认识

核心代码
配置文件
测试代码
测试配置

作为一个 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 工程运行先从本地仓库找 jar 包，本地仓库没有再从中央仓库找，上边提示 downloading…
表示 从中央仓库下载 jar，由于本地没有联网，报错。
解决：
在 maven 安装目录的conf/setting.xml 文件中配置本地仓库

第二个错误：
org.eclipse.jdt.internal.compiler.classfmt.ClassFormatException
maven默认是用的是tomcat6，而项目的jdk为1.8，二者并不支持。所以需要将maven的tomcat版本换为tomcat7或更高。
并且需要将 启动tomcat的代码换为 tomcat7：run。否则还是会默认使用tomcat6

更改项目中的文件，pom.xml，不是maven的全局配置pom.xml

maven常用命令

clean 是 maven 工程的清理命令，执行 clean 会删除 target 目录及内容。
当使用别人的项目的时候，他的target目录下生成了许多和他的本地配置相关的文件，可能不在可用。可以根据自己的配置重新自动生成
生成的文件，自动放入target目录下
compile 是 maven 工程的编译命令，作用是将 src/main/java 下的文件编译为 class 文件输出到 target
目录下。
test 是 maven 工程的测试命令 mvn test，会执行src/test/java下的单元测试类。编译，
不仅仅编译了test下的代码，还有main下的代码
package 是 maven 工程的打包命令，对于 java 工程执行 package 打成 jar 包，对于web 工程打成war
包。
install 是 maven 工程的安装命令，执行 install 将 maven 打成 jar 包或 war 包发布到本地仓库。
从运行结果中，可以看出：
当后面的命令执行时，前面的操作过程也都会自动执行，

Maven 生命周期

后面的会把前面的都执行一次
类似于跑步的选手，想要到达终点就必须把每一个路段都跑过，而且每次都要重新从起点开始跑

主要掌握的是默认生命周期，最常用

maven 对项目构建过程分为三套相互独立的生命周期，请注意这里说的是“三套”，而且“相互独立”，
这三套生命周期分别是：
Clean Lifecycle 在进行真正的构建之前进行一些清理工作。
Default Lifecycle 构建的核心部分，编译，测试，打包，部署等等。
Site Lifecycle 生成项目报告，站点，发布站点。

maven概念图

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
的依赖定义：
说白了就是jar包的坐标，
公司组织名字
项目名
版本号
三个仓库，本地，私服，中央，依次

<!-- 依赖关系 -->
<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 通过执行一些简单命令即可实现上边生命周期的各各过程，比如执行 mvn compile 执行编译、
执行 mvn clean 执行清理。
 一组标准集合
maven将整个项目管理过程定义一组标准，比如：通过 maven 构建工程有标准的目录结构，有
标准的生命周期阶段、依赖管理有标准的坐标定义等。
 插件(plugin)目标(goal)
maven 管理项目生命周期过程都是基于插件完成的。

idea 开发 maven 项目

配置maven安装位置，配置文件，以及仓库位置

给maven配置工程属性，确保在不联网的情况下也可以工程，只要之前下载过创建工程的插件，就会从本地寻找，而不必联网

idea 中创个 建一个 maven 的 的 web

勾选表示使用模板

公司名，项目名，版本号

配置项目本地maven属性

创建java文件夹，更改属性，识别为代码目录，同类型的还有资源德等目录。maven对每个文件夹爱放什么都十分严格，智能找到对应目录下的创建选项
如果想在目录中添加jsp页面，需要将他设置成资源文件夹

一般不这么做

预习是学习之本
如果不使用骨架，可以更快的创造一个工程，推荐。就是不勾选

创建一个 Servlet

使用了jar包如何导入？

就是要将 servlet-api-xxx.jar 包放进来，作为 maven 工程应当添加 servlet的坐标，从而
导入它的 jar

pom 基础配置

pom.xml 是 Maven 项目的核心配置文件，位于每个工程的根目录，基本配置如下：
：文件的根节点 .
： pom.xml 使用的对象模型版本
：项目名称，一般写项目的域名
：模块名称，子项目名或模块名称
：产品的版本号 .
：打包类型，一般有 jar、war、pom 等
：项目的显示名，常用于 Maven 生成的文档。
：项目描述，常用于 Maven 生成的文档
：项目依赖构件配置，配置项目依赖构件的坐标
：项目构建配置，配置编译、运行插件等。
pom.xml 文件，再添加坐标

添加
在java中引入，右键即可自动添加
添加完坐标以后，包会从中央仓库下载，不需要再手动下载了
写入包名自动补全
添加 jar 包的坐标时，还可以指定这个 jar 包将来的作用范围。范围后面介绍
有两个问题？

怎么确定包的坐标？

网页
https://search.maven.org

怎么设定jar包作用范围？

为了解决一些问题
比如jar包冲突，编译的时候没问题，运行的时候出现异常，
那么可以设定jar包在编译阶段有效，运行时屏蔽，默认都是compile
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依赖不推荐使用

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

每个 maven 工程都需要定义本工程的坐标，坐标是 maven 对 jar 包的身份定义，对于本工程自动定义为：

  <!--项目名称，定义为组织名+项目名，类似包名-->
  <groupId>testmaven</groupId>
  <!-- 模块名称 -->
  <artifactId>learnmaven</artifactId>
  <!-- 当前项目版本号，snapshot 为快照版本即非正式版本，release为正式发布版本 -->
  <version>1.0-SNAPSHOT</version>
  <!--打包类型 jar：执行 package 会打成 jar 包
war：执行 package 会打成 war 包-->
  <!--pom ：用于 maven 工程的继承，通常父工程设置为 pom-->
  <packaging>war</packaging>

插件问题

依赖可以自动填充，但是插件不能，如何解决？




以后配置tomcat7运行项目，直接输入就能自动生成这一段代码

查看包是否已经根据坐标导入

执行项目

根据右侧的生命周期，双击即可
一键构建的意思是不再依赖外部的插件，使用自身的插件，导致版本不匹配有可能

命令或者点击都行
软件启动配置，可调试

一般也有test类，这里省略
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>two</groupId>
  <artifactId>three</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>three Maven Webapp</name>
  <!-- FIXME change it to the project's website -->
  <url>http://www.example.com</url>

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

  <!-- 添加servlet-api，jsp-api -->
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.9</version>
      <scope>test</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.0</version>
      <scope>provided</scope>
    </dependency>
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>servlet-api</artifactId>
      <version>2.5</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>

  <build>
    <!-- 配置了很多插件 -->
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <configuration>
          <source>1.7</source>
          <target>1.7</target>
          <encoding>UTF-8</encoding>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.tomcat.maven</groupId>
        <artifactId>tomcat7-maven-plugin</artifactId>
        <version>2.1</version>
        <configuration>
          <port>9699</port>
          <path>/mgr</path>
          <uriEncoding>UTF-8</uriEncoding>
          <server>tomcat7</server>
        </configuration>
      </plugin>

    </plugins>
  </build>
</project>

test。java

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/hello")
public class test extends HttpServlet {
     
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
     
        req.getRequestDispatcher("/a.jsp").forward(req,resp);
    }
}