Maven

1      Maven介绍

1.1     项目开发中遇到的问题

1、都是同样的代码,为什么在我的机器上可以编译执行,而在他的机器上就不行?

2、为什么在我的机器上可以正常打包,而配置管理员却打不出来?

3、项目组加入了新的人员,我要给他说明编译环境如何设置,但是让我挠头的是,有些细节我也记不清楚了。

4、我的项目依赖一些jar包,我应该把他们放哪里?放源码库里?

5、这是我开发的第二个项目,还是需要上面的那些jar包,再把它们复制到我当前项目的svn库里吧

6、现在是第三次,再复制一次吧    ----- 这样真的好吗?

7、我写了一个数据库相关的通用类,并且推荐给了其他项目组,现在已经有五个项目组在使用它了,今天我发现了一个bug,并修正了它,我会把jar包通过邮件发给其他项目组

-----这不是一个好的分发机制,太多的环节可能导致出现bug

8、项目进入测试阶段,每天都要向测试服务器部署一版。每次都手动部署,太麻烦了。

1.2     什么是maven

svn:版本控制工具

Maven是基于项目对象模型(POM),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。

Maven是跨平台的项目管理工具。主要服务于基于Java平台的项目构建依赖管理项目信息管理

gradle

Maven主要有两个功能:

1、项目构建(打包(jar,war),部署)

2、依赖管理(做好配置,自定下载依赖)

1.3     什么是构建

构建过程:

 

实施

运维(客服)

测试

开发组

1.4     项目构建的方式

1、Eclipse

手工操作较多,项目的构建过程都是独立的,很难一步完成。比如:编译、测试、部署等。

开发时每个人的IDE配置都不同,很容易出现本地代码换个地方编译就出错

2、Ant

         Ant只是一个项目构建工具,它没有集成依赖管理。

Ant在进行项目构建时,它没有对项目目录结构进行约定,需要手动指定源文件、类文件等目录地址。同时它执行task时,需要显示指定依赖的task,这样会造成大量的代码重复。

3、Maven

         Maven不仅是一个项目构建工具,更是一个项目管理工具。它在项目构建工程中,比ant更全面,更灵活。

Maven在进行项目构建时,它对项目目录结构拥有约定,知道你的源代码在哪里,类文件应该放到哪里去。

它拥有生命周期的概念,maven的生命周期是有顺序的,在执行后面的生命周期的任务时,不需要显示的配置前面任务的生命周期。例如执行 mvn install 就可以自动执行编译,测试,打包等构建过程

4、gradle   android

1.5     Maven模型

Pom.xml  maven的核心配置文件

Central:中央仓库

                  私服

                  本地

 

plug:插件  jdk编译插件   tomcat插件     

2      Maven安装配置

2.1     下载maven

官方网站:http://maven.apache.org

本课程使用的maven的版本为3.5

Maven是使用java开发,需要安装jdk1.6以上,推荐使用1.7

2.2     Maven的安装

第一步:安装jdk,要求1.6或以上版本。

第二步:把maven解压缩,解压目录最好不要有中文。

第三步:配置环境变量MAVEN_HOME

第四步:配置环境变量PATH,将%MAVEN_HOME%in加入Path中,在Windows中一定要注意要用分号;与其他值隔开。

第五步:验证是否安装成功,打开cmd窗口,输入mvn –v

2.3     Maven的配置

Maven有两个settings.xml配置文件,一个是全局配置文件,一个是用户配置文件。

2.3.1  全局配置(默认)

%MAVEN_HOME%/conf/settings.xml 是maven全局的配置文件。

该配置文件中配置了本地仓库(依赖)的路径,默认就是:~/.m2/repository。其中~表示当前用户路径C:Users[UserName]。

localRepository:用户仓库,用于检索依赖包路径

2.3.2  用户配置

~/.m2/settings.xml是用户的配置文件(默认没有该文件,需要将全局配置文件拷贝过来在进行修改)

注意:一般本地仓库的地址不使用默认配置,通常情况下需要在用户配置中,配置新的仓库地址。

配置步骤如下:

第一步:创建一个本地仓库目录,比如E:// repository/maven。

/USERS/.m2/repository

第二步:复制maven的全局配置文件(.settings)到~/.m2目录下,即创建用户配置文件

第三步:修改maven的用户配置文件。

注意:

用户级别的仓库在全局配置中一旦设置,全局配置将不再生效,转用用户所设置的仓库,否则使用全局配置文件中的默认路径仓库(全局:maven/conf/settings.xml  用户:用户:~/.m2/settings.xml

3      创建Maven工程

3.1     Maven的工程结构

Project

  |-src

  |   |-main

  |   |  |-java        —— 存放项目的.java文件

  |   |  |-resources   —— 存放项目资源文件,如spring, hibernate配置文件

  |   |  |-webapp     ———存放jsp,html,web.xml等网页文件   WebContent

  |   |-test   测试代码

  |      |-java        ——存放所有测试.java文件,如JUnit测试类

  |      |-resources   —— 测试资源文件

  |-target             —— 目标文件输出位置例如.class、.jar、.war文件

  |-pom.xml           ——maven项目核心配置文件

3.2     Maven的工程创建

3.2.1  第一步:根据maven的目录结构创建HelloMaven工程

target目录会在编译之后自动创建。

3.2.2  第二步:创建HelloWorld.java

在src/main/java/com/qf/maven目录下新建文件Hello.java

package com.qf.maven;

public class HelloWorld {

            public String sayHello(String name){

                       return "Hello World :" + name + "!";

            }

}

3.2.3  第三步:创建TestHelloWorld.java

package com.qf.maven;

import org.junit.Test;

import static junit.framework.Assert.*;

public class TestHelloWorld{

        

         @Test

         public void testSayHello(){

                  HelloWorld hw = new HelloWorld();

                  String result = hw.sayHello("zhangsan");

                  assertEquals("hello zhangsan",result);

         }      

}

3.2.4  第四步:配置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">

  <!-- 版本:4.0.0 -->

  <modelVersion>4.0.0</modelVersion>

  <!-- 组织名称:暂时使用 组织名称+项目名称 作为组织名称 -->

  <!-- 组织名称:实际名称 按照访问路径规范设置,通常以功能作为名称:eg: junit spring -->

  <groupId>com.qf.maven</groupId>

  <!-- 项目名称 -->

  <artifactId>HelloWorld</artifactId>

  <!-- 当前项目版本号:同一个项目开发过程中可以发布多个版本,此处标示0.0.1版 -->

  <!-- 当前项目版本号:每个工程发布后可以发布多个版本,依赖时调取不同的版本,使用不同的版本号 -->

  <version>0.0.1</version>

  <!-- 名称:可省略 -->

  <name>Hello</name>

  <!-- 依赖关系 -->

            <dependencies>

                       <!-- 依赖设置 -->

                       <dependency>

                                   <!-- 依赖组织名称 -->

                                   <groupId>junit</groupId>

                                   <!-- 依赖项目名称 -->

                                   <artifactId>junit</artifactId>

                                   <!-- 依赖版本名称 -->

                                   <version>4.9</version>

                                   <!-- 依赖范围:test包下依赖该设置 -->

                                   <scope>test</scope>

                       </dependency>                  

                      

            </dependencies>

</project>

到此maven工程即创建成功。

3.3     Maven的命令

需要在pom.xml所在目录中执行以下命令。

3.3.1  Mvn compile

执行 mvn compile命令,完成编译操作

执行完毕后,会生成target目录,该目录中存放了编译后的字节码文件。

3.3.2  Mvn clean

执行 mvn clean命令

执行完毕后,会将target目录删除。

3.3.3  Mvn test

执行 mvn test命令,完成单元测试操作

执行完毕后,会在target目录中生成三个文件夹:surefire、surefire-reports(测试报告)、test-classes(测试的字节码文件)

3.3.4  Mvn package

执行 mvn package命令,完成打包操作

执行完毕后,会在target目录中生成一个文件,该文件可能是jar、war

3.3.5  Mvn install

执行 mvn install命令,完成将打好的jar包安装到本地仓库的操作

执行完毕后,会在本地仓库中出现安装后的jar包,方便其他工程引用

3.3.6  mvn clean compile命令

cmd 中录入 mvn clean compile命令

组合指令,先执行clean,再执行compile,通常应用于上线前执行,清除测试类

3.3.7  mvn clean test命令

cmd 中录入 mvn clean test命令

组合指令,先执行clean,再执行test,通常应用于测试环节

3.3.8  mvn clean package命令

cmd 中录入 mvn clean package命令

         组合指令,先执行clean,再执行package,将项目打包,通常应用于发布前

         执行过程:

                  清理————清空环境

                  编译————编译源码

                  测试————测试源码

                  打包————将编译的非测试类打包

3.3.9  mvn clean install命令

cmd 中录入 mvn clean install 查看仓库,当前项目被发布到仓库中

         组合指令,先执行clean,再执行install,将项目打包,通常应用于发布前

         执行过程:

                  清理————清空环境

                  编译————编译源码

                  测试————测试源码

                  打包————将编译的非测试类打包

                  部署————将打好的包发布到资源仓库中

3.4     使用eclipse创建maven工程

widows –》首选项:maven

 

 

3.4.1  通过骨架创建maven工程

3.4.1.1        创建工程

第一步:选择new→maven→Maven Project

 

第二步:next

第三步:next

选择maven的工程骨架,这里我们选择quickstart。

第四步:next

输入GroupId、ArtifactId、Version、Package信息点击finish完成。

3.4.1.2        MavenFirst.java

在src/main/java中创建com.qf.maven包,然后创建MavenFirst.java

3.4.1.3        创建TestMavenFirst.java

在src/test/java中创建com.qf.maven包,然后创建TestMavenFirst.java

3.4.1.4        执行maven命令进行测试

在Eclipse的maven插件中执行maven命令,需要在maven工程或者pom.xml文件上点击右键,选择Run as→maven build..

可以在菜单中看到maven常用的命令已经以菜单的形式出现。

例如:

Maven clean

Maven install

Maven package

Maven test

 

Maven build和maven build... 并不是maven的命令。

maven build...只是提供一个命令输入功能,可以在此功能中输入自定义的maven命令。

maven build的功能就是执行上次自定义命令。

3.4.2  不通过骨架创建maven工程

通过选择骨架创建maven工程,每次选择骨架时都需要联网下载,如果网络不通或者较慢的情况下会有很长时间的等待。使用很是不方便,所以创建工程时可以不选择骨架直接创建工程。

3.4.2.1        创建工程

第一步:选择new→maven→Maven Project

第二步:next

 

第三步:next

 

Packaging:指定打包方式,默认为jar。选项有:jar、war、pom。

第四步:点击finish,完成maven工程创建。

3.4.2.2        修改pom文件

在Maven-second工程中依赖使用maven-first工程的代码

4      Maven核心概念

4.1     坐标

4.1.1  什么是坐标?

在平面几何中坐标(x,y)可以标识平面中唯一的一点。在maven中坐标就是为了定位一个唯一确定的jar包。

Maven世界拥有大量构建,我们需要找一个用来唯一标识一个构建的统一规范

拥有了统一规范,就可以把查找工作交给机器

4.1.2  Maven坐标主要组成

groupId:定义当前Maven组织名称

artifactId:定义实际项目名称

version:定义当前项目的当前版本

唯一的表示一个项目

4.2     依赖管理

就是对项目中jar 包的管理。可以在pom文件中定义jar包的GAV坐标,管理依赖。

依赖声明主要包含如下元素:

<dependencies>

                  <dependency>

                          <groupId>junit</groupId>

                          <artifactId>junit</artifactId>

                          <version>4.9</version>

                          <scope>test</scope>

                  </dependency>               

         </dependencies>

4.2.1  依赖范围

其中依赖范围scope 用来控制依赖和编译,测试,运行的classpath的关系. 主要的是三种依赖关系如下:

1.compile: 默认编译依赖范围。对于编译,测试,运行三种classpath都有效

2.test:测试依赖范围。只对于测试classpath有效

3.provided:已提供依赖范围。对于编译,测试的classpath都有效,但对于运行无效。因为由容器已经提供,例如servlet-api

4.runtime:运行时提供。例如:jdbc驱动

         <scope>runtime</scope>

4.2.2  依赖传递

4.2.2.1        直接依赖和间接依赖

如果B中使用A,C中使用B,则称B是C的直接依赖,而称A是C的间接依赖

C->B                  B->A

C直接依赖B

C间接依赖A

4.2.2.2        依赖范围对传递依赖的影响

左边第一列表示第一直接依赖范围  aàb

上面第一行表示第二直接依赖范围  b-->c

中间的交叉单元格表示传递性依赖范围。

总结:

  • 当第二依赖的范围是compile的时候,传递性依赖的范围与第一直接依赖的范围一致。
  • 当第二直接依赖的范围是test的时候,依赖不会得以传递。
  • 当第二依赖的范围是provided的时候,只传递第一直接依赖范围也为provided的依赖,且传递性依赖的范围同样为 provided;
  • 当第二直接依赖的范围是runtime的时候,传递性依赖的范围与第一直接依赖的范围一致,但compile例外,此时传递的依赖范围为runtime;
  • 如果直接与间接依赖中包含有同一个坐标不同版本的资源依赖,以直接依赖的版本为准(就近原则)
  • a<---b   junit 3.9
  • bß-c   junit 4.1

4.2.3  依赖冲突

  • 如果直接与间接依赖中包含有同一个坐标不同版本的资源依赖,以直接依赖的版本为准(就近原则)
  • a<---b   junit 3.9
  • b<--c   junit 4.1

1、Maven-first工程中依赖log4j-1.2.8版本

那么maven-third中依赖的就是log4j-1.2.8

2、maven-second工程中依赖log4j-1.2.9版本

那么maven-third中依赖的就是log4j-1.2.9,因为它直接依赖的maven-second项目中依赖的就是1.2.9版本

  • 如果直接依赖中包含有同一个坐标不同版本的资源依赖,以配置顺序下方的版本为准(就近原则)

Maven-second中依赖 log4j-1.2.9 和 log4j-1.2.14

 

此时log4j-1.2.14版本生效。

 

4.2.4  可选依赖

<optional> true/false 是否可选,也可以理解为是否向下传递。

在依赖中添加optional选项决定此依赖是否向下传递,

如果是true则不传递,如果是false就传递,默认为false。

4.2.5  排除依赖

ThirdMaven  SecondMaven  FirstMaven

<exclusions

    <exclusion>

       <groupId>com.qf.maven</groupId>

       <artifactId>maven-first</artifactId>

    </exclusion>

</exclusions>

排除依赖包中所包含的依赖关系,不需要添加版本号

如果在本次依赖中有一些多余的jar包也被传递依赖过来,如果想把这些jar包排除的话可以配置exclusions进行排除。

4.3     生命周期

4.3.1  什么是生命周期?

Maven生命周期就是为了对所有的构建过程进行抽象和统一

包括项目清理、初始化、编译、打包、测试、部署等几乎所有构建步骤。

生命周期可以理解为构建工程的步骤。

在Maven中有三套相互独立的生命周期,请注意这里说的是“三套”,而且“相互独立”,这三套生命周期分别是:

 Clean Lifecycle: 在进行真正的构建之前进行一些清理工作。

 Default Lifecycle: 构建的核心部分,编译,测试,打包,部署等等。

 Site Lifecycle: 生成项目报告,站点,发布站点。  ProjectManager

再次强调一下它们是相互独立的,你可以仅仅调用clean来清理工作目录,仅仅调用site来生成站点。当然你也可以直接运行 mvn clean install site 运行所有这三套生命周期。

4.3.2  Maven三大生命周期

4.3.2.1        clean:清理项目

每套生命周期都由一组阶段(Phase)组成,我们平时在命令行输入的命令总会对应于一个特定的阶段。比如,运行mvn clean ,这个的clean是Clean生命周期的一个阶段。有Clean生命周期,也有clean阶段。Clean生命周期一共包含了三个阶段:

pre-clean 执行一些需要在clean之前完成的工作

clean 移除所有上一次构建生成的文件

post-clean 执行一些需要在clean之后立刻完成的工作

mvn clean 中的clean就是上面的clean,在一个生命周期中,运行某个阶段的时候,它之前的所有阶段都会被运行,也就是说,mvn clean 等同于 mvn pre-clean clean ,如果我们运行 mvn post-clean ,那么 pre-clean,clean 都会被运行。这是Maven很重要的一个规则,可以大大简化命令行的输入。

4.3.2.2        default:构建项目

Default生命周期是Maven生命周期中最重要的一个,绝大部分工作都发生在这个生命周期中。这里,只解释一些比较重要和常用的阶段:

下面的看红色就行

validate

generate-sources

process-sources

generate-resources

process-resources 复制并处理资源文件,至目标目录,准备打包。

compile 编译项目的源代码。

process-classes

generate-test-sources

process-test-sources

generate-test-resources

process-test-resources 复制并处理资源文件,至目标测试目录。

test-compile 编译测试源代码。

process-test-classes

test 使用合适的单元测试框架运行测试。这些测试代码不会被打包或部署

prepare-package

package 接受编译好的代码,打包成可发布的格式,如 JAR 。

pre-integration-test

integration-test

post-integration-test

verify

install 将包安装至本地仓库,以让其它项目依赖。

deploy 将最终的包复制到远程的仓库,以让其它开发人员与项目共享。

运行任何一个阶段的时候,它前面的所有阶段都会被运行,这也就是为什么我们运行mvn install 的时候,代码会被编译,测试,打包。此外,Maven的插件机制是完全依赖Maven的生命周期的,因此理解生命周期至关重要。

4.3.2.3     site:生成项目站点

Site生命周期

pre-site 执行一些需要在生成站点文档之前完成的工作

site 生成项目的站点文档

post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备

site-deploy 将生成的站点文档部署到特定的服务器上

这里经常用到的是site阶段和site-deploy阶段,用以生成和发布Maven站点,这可是Maven相当强大的功能,Manager比较喜欢,文档及统计数据自动生成,很好看。

4.4     Maven插件

Maven的核心仅仅定义了抽象的生命周期,具体的任务都是交由插件完成的。每个插件都能实现一个功能,每个功能就是一个插件目标。Maven的生命周期与插件目标相互绑定,以完成某个具体的构建任务。

例如compile就是插件maven-compiler-plugin的一个插件目标

4.4.1  Maven编译插件

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

Maven-tomcat插件:

  <build>

    <finalName>HelloMaven4_web</finalName>

      <!-- 插件 -->

         <plugins>

             <plugin> 

               <groupId>org.apache.tomcat.maven</groupId> 

               <artifactId>tomcat7-maven-plugin</artifactId> 

               <version>2.2 </version> 

                   <configuration> 

                      <url>http://localhost:8080/HelloMaven4_web</url> 

                      <server>tomcat</server> 

                  </configuration> 

              </plugin>

         </plugins>

  </build>

修改配置文件后,在工程上点击右键选择maven→update project configration

4.4.2  Tomcat插件

4.4.2.1        使用maven创建一个web工程

第一步:不选用骨架

第二步:将打包方式选择为war

第三步:点击finish,工程创建成功。

第四步:在工程中添加web.xml

 

Web.xml内容如下:

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

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"

    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"

    id="WebApp_ID" version="2.5">

    <welcome-file-list>

       <welcome-file>index.html</welcome-file>

       <welcome-file>index.htm</welcome-file>

       <welcome-file>index.jsp</welcome-file>

       <welcome-file>default.html</welcome-file>

       <welcome-file>default.htm</welcome-file>

       <welcome-file>default.jsp</welcome-file>

    </welcome-file-list>

</web-app>

第五步:在webapp下创建index.jsp

注意:创建了一个web工程,但是没有生成web.xml 启动时,就会报错,你要手动添加吗? 使用eclipse的同学都知道右键 选择JavaEE Tools来创建web.xml那么idea呢?

 第一步:点击file,选择projectStructure

  第二步:选择facets,选择web-》web项目名 点击+web.xml

原文地址:https://www.cnblogs.com/wanghuaying/p/9671394.html