Maven-maven介绍&maven安装配置&创建maven工程&M2Eclipse

末蓝、 2021-09-22 06:14 548阅读 0赞

# 一、 **Maven介绍** #

##  ##

## 1.1 **项目开发中遇到的问题** ##

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

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

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

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

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

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

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

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

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

##  ##

## 1.2 **什么是maven** ##

Maven是基于项目对象模型（POM），通过一小段描述信息对项目的依赖、文档进行管理，这就是项目管理工具的作用。

Maven是使用java开发的。Maven是可以跨平台使用的。

Maven的最重要的作用就是**项目构建、依赖管理**。

依赖：jar包，依赖管理就是对jar包的管理。

## 1.3 **什么是构建** ##

![Center][]

## 1.4 **项目构建的方式** ##

1、Eclipse

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

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

2、Ant

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

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

3、Maven

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

使用maven执行项目构建工具，不需要指定构建的前置条件，执行最终目标命令即可

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

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

**构建过程：**

**![Image 1][]![Center 1][]**

清理：清除上一次编码的文件

编译：编译本次的代码文件

测试：执行测试文件

报告：输出问题的报告等

## 1.5 **Maven模型** ##

![Image 1][] ![Center 2][]

# 二、 **Maven安装配置** #

## 2.1 **下载maven** ##

官方网站：[http://maven.apache.org][http_maven.apache.org]

本教程使用的maven的版本为3.3.3 （还有3.0.5区别不大）

Maven是使用java开发，该版本需要安装jdk1.6以上，推荐使用1.7

![Image 1][]![Center 3][]

## 2.2 **Maven的安装** ##

第一步：安装jdk，要求1.6或以上版本。

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

第三步：配置环境变量MAVEN\_HOME

![Image 1][] ![Center 4][]

注意：变量值为bin的外层目录

第四步：配置环境变量PATH，将%MAVEN\_HOME%\\bin加入Path中，在Windows中一定要注意要用分号；与其他值隔开。

![Image 1][] ![Center 5][]

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

![Image 1][] ![Center 6][]

## 2.3 **Maven的配置** ##

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

### 2.3.1 **全局配置（默认）** ###

**%MAVEN\_HOME%/conf/settings.xml** 是maven全局的配置文件。

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

![Image 1][] ![Center 7][]

![Center 8][]

![Center 9][]

![Image 1][]

### 2.3.2 **用户配置** ###

用户配置默认地址：~/.m2/settings.xml，该文件默认是不存在的，需要复制全局配置文件到该目录下。

注意事项：

1、一般情况下，开发时需要使用用户配置，而不使用全局配置。因为用户配置更加的灵活。

2、一旦配置用户配置，那么全局配置失效。

3、一般情况下，开发时，不使用默认本地仓库地址，需要显式的指定本地仓库地址。

步骤一：拷贝全局配置文件 **%MAVEN\_HOME%/conf/settings.xml到~/.m2的目录下**

**![Center 10][]**

**![Image 1][]**

步骤二：修改~/.m2/settings.xml的配置、指定自己的位置

![Image 1][]![Center 11][]

**注意：**

**用户级别的仓库在全局配置中一旦设置，全局配置将不再生效，转用用户所设置的仓库，否则使用全局配置文件中的默认路径仓库。**

# 三、创建Maven工程 #

3.1  **M** **aven的工程结构**

**![Image 1][]![Center 12][]**

## 3.2  **Maven的工程创建** ##

### 3.2.1 **第一步：根据maven的目录结构创建helloMaven工程** ###

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

![Image 1][]

**![Image 1][]![Center 13][]**

### 3.2.2 **第二步：创建HelloWorld.java** ###

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

package maven;
    
    public class HelloWorld {
    	public String sayHello(String name){
    		return "Hello World :" + name + "!";
    	}
    }

### 3.2.3 **第三步：创建TestHelloWorld.java** ###

package 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">
      
      <modelVersion>4.0.0</modelVersion>
      
      
      <groupId>cn.itcast.maven</groupId>
      
      <artifactId>HelloWorld</artifactId>
      
      
      <version>0.0.1</version>
      
      <name>Hello</name>
      
      
    	<dependencies>
    		
    		<dependency>
    			
    			<groupId>junit</groupId>
    			
    			<artifactId>junit</artifactId>
    			
    			<version>4.9</version>
    			
    			<scope>test</scope>
    		</dependency>		
    		
    	</dependencies>
    </project>

到此maven工程即创建成功。

## 3.3**Maven的命令** ##

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

### 3.3.1 **Mvn compile** ###

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

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

![Center 14][]

这个会根据pom文件需要的jar包 从网络仓库下载jar包（注意需要有网络没有网络需要另一种方式）

![Image 1][] ![Center 15][]

下载完毕后会在你电脑的maven仓库中生成一个jar包的仓库（注意你配置的全局仓库和局部仓库，如何配置见上面）

![Image 1][]![Center 16][]

![Center 17][]

执行完毕后会在你项目目录中生成target文件

![Image 1][]特别注意：在你团队开发项目的时候，可能宕下来的项目在你本地仓库中没有相应的jar包、会导致你项目有一个红色的叹号、这个时候需要你将jar包从网络上添加到你本地上、但是怎么添加呢？两种办法。

第一种、找出你引用的jar包，直接向领导要，然后添加到本地仓库中。

第二种、执行maven的命令，这里没有指定命令，每一个命令都对应着一个maven插件、但是这里注意的是、可以执行测试命令、在测试前需要查找jar包，没有的话会从网上下载，添加到你本地仓库中。

或者：用maven命令将jar包移动到maven的本地repository中 mvn archetype:create -DgroupId=packageName -DartifactId=projectName

然后修改pom.xml文件，在dependencies里加入你想要下载的jar包

下面是参考别人的命令：

mvn install:install-file -Dfile=webapps\ROOT\WEB-INF\lib\jaas.jar -DgroupId=javax.security -DartifactId=jaas -Dversion=1.0.01 -Dpackaging=jar

需要注意以下几点.  
1.注意"-"不能缺少 install后面的"-"是没有空格的  
2.注意"-Dfile"中jar包的路径和jar包的名字.  
3.注意看cmd命令提示,查看本地repository中是否成功的复制了jar包.

### 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，将项目打包，通常应用于发布前

执行过程：

清理————清空环境

编译————编译源码

测试————测试源码

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

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

# 4 **M2Eclipse（如何配置在eclipse中的maven）** #

M2Eclipse是eclipse中的maven插件（简称m2e）

(说明一下：一般的eclipse没有maven插件，但是eclipse mars2中自带maven插件无需自己配）

## 4.1 **安装配置M2Eclipse插件** ##

### 4.1.1 **第一步：将以下包中的插件进行复制。** ###

![Image 1][] ![Center 18][]

### 4.1.2 **第二步：粘贴到eclipse中的dropins目录中** ###

![Image 1][] ![Center 19][]

### 4.1.3 **第三步：查看eclipse中是否有maven插件** ###

![Image 1][] ![Center 20][]

### 4.1.4 **第四步：设置maven安装目录** ###

**![Center 21][]**

### 4.1.5 **第五步：设置用户配置** ###

![Image 1][] ![Center 22][]

到此、eclipse的配置完成

## 4.2 **创建maven工程** ##

### 4.2.1 **通过骨架创建maven工程** ###

**需要联网才能选择骨架**

#### 4.2.1.1 **创建工程** ####

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

![Image 1][] ![Center 23][]

第二步：next

![Image 1][] ![Center 24][]

第三步：next

![Image 1][] ![Center 25][]

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

第四步：next

![Image 1][] ![Center 26][]

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

![Image 1][]

![Center 27][]

#### 4.2.1.2 **创建MavenFirst.java** ####

在src/main/java中创建cn.gbicc.maven包，然后创建MavenFirst.java

package cn.gbicc.maven_first;
    
    
    public class MavenFirst {
    
    	public String sayHello(String name) {
    		return "hello " + name;
    	}
    }

#### 4.2.1.3 **创建TestMavenFirst.java** ####

在src/test/java中创建cn.gbicc.maven包，然后创建TestMavenFirst.java

package cn.gbicc.maven_first;
    
    import junit.framework.Assert;
    
    import org.junit.Test;
    
    
    
    public class TestMavenFirst {
    
    	@Test
    	public void testSayHello() {
    		MavenFirst first = new MavenFirst();
    
    		String result = first.sayHello("zhangsan");
    
    		Assert.assertEquals("hello zhangsan", result);
    	}
    }

#### 4.2.1.4 **执行maven命令进行测试** ####

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

![Center 28][]

![Image 1][]

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

例如：

Maven clean

Maven install

Maven package

Maven test

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

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

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

![Image 1][]

![Center 29][]  
![Center 30][]

### 4.2.2**不通过骨架创建maven工程** ###

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

#### 4.2.2.1 **创建工程** ####

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

![Center 23][]

第二步：next

![Center 31][]

注意下面的勾选是因为上次勾选的默认写在的位置

第三步：next

![20170423173410084][]

第四步：finish

#### 4.2.1.2**修改pom文件** ####

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

<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>cn.itcast.maven</groupId>
    	<artifactId>maven-second</artifactId>
    	<version>0.0.1-SNAPSHOT</version>
    
    	<dependencies>
    		<dependency>
    			<groupId>junit</groupId>
    			<artifactId>junit</artifactId>
    			<version>4.12</version>
    		</dependency>
    		<dependency>
    			<groupId>cn.itcast.maven</groupId>
    			<artifactId>maven-first</artifactId>
    			<version>0.0.1-SNAPSHOT</version>
    		</dependency>
    	</dependencies>
    </project>

#### 4.2.1.3 **创建MavenSecond.java** ####

package cn.gbicc.maven;
    
    public class MavenSecond {
    	
    	public String sayHello(String name) {
    		MavenFirst first = new MavenFirst();
    		return first.sayHello(name) + ":second";
    	}
    
    }

#### 4.2.1.4**创建TestMavenSecond.java** ####

package cn.gbicc.maven;
    
    import org.junit.Assert;
    import org.junit.Test;
    
    public class TestMavenSecond {
    
    	@Test
    	public void testSayHello() {
    		MavenSecond second = new MavenSecond();
    
    		String result = second.sayHello("zhangsan");
    
    		Assert.assertEquals("hello zhangsan:second", result);
    	}
    
    }

#### 4.2.1.5 **测试工程** ####

![20170423174049905][]

**关于maven核心工程请见下回maven的核心概念&maven仓库管理**

[Center]: /images/20210920/f3b5b2f358d14f0fb67f3fa05d75aea0.png
[Image 1]: 
[Center 1]: /images/20210920/63ab783203804ea0b710297a2f5a597c.png
[Center 2]: /images/20210920/aea546513fcb4d7a9867c2be715c2972.png
[http_maven.apache.org]: http://maven.apache.org
[Center 3]: /images/20210920/70e680ee11574a6c8b19301f29aaaace.png
[Center 4]: /images/20210920/0ac9f76b83ce454a96b67c4c816776cd.png
[Center 5]: /images/20210920/ea49ebe1c20f49dbb6fcfe2b98871d52.png
[Center 6]: /images/20210920/65d247f9a5ad48178d43be89838512e7.png
[Center 7]: /images/20210920/a2813427aa3b4b9d91c530704b2cc8cc.png
[Center 8]: /images/20210920/12cd9c84878d42f3b68b50f34f116b7f.png
[Center 9]: /images/20210920/2d3576afdb30467c8a35f37be6aeaab0.png
[Center 10]: /images/20210920/015b2eeabd674543a1c338d6ff339d23.png
[Center 11]: /images/20210920/4e21bebc1e6c4a3199a6b5506ee972fb.png
[Center 12]: /images/20210920/21997b51af3e480c8e601ec97087406f.png
[Center 13]: /images/20210920/63ca264bdfed4c829274d0a7e796d822.png
[Center 14]: /images/20210920/2605dd3066764df985b90c8437cd2ca6.png
[Center 15]: /images/20210920/8fe324bef4b44799923d6e45f7ad9450.png
[Center 16]: /images/20210920/356df9f8899549468198cedab868c86a.png
[Center 17]: /images/20210920/d0d733641f674734aa10f8ab5b9fcecf.png
[Center 18]: /images/20210920/6a7a4451bb0f483abde276851e1e8e2c.png
[Center 19]: /images/20210920/506d46f89d954ce8b8250cd8809f0f59.png
[Center 20]: /images/20210920/eb16a4f8363b431281a6d9c2acb86ab9.png
[Center 21]: /images/20210920/6dcd25323b36415a989e22727b2f745b.png
[Center 22]: /images/20210920/acb6a4b8ef814dabb5bac44210f9c391.png
[Center 23]: /images/20210920/68a70b8af5ac4363932a432e5104e953.png
[Center 24]: /images/20210920/d99a3b00e3ec4f9290719a48003650e6.png
[Center 25]: /images/20210920/11aa36e15ffd4037ab265354aff95071.png
[Center 26]: /images/20210920/1f6a6437923249e6857741aa30e72240.png
[Center 27]: /images/20210920/8707b1d3a98a450c9d6a4fe6eeb06fbe.png
[Center 28]: /images/20210920/4e590291f5ec46479b9b51e304a8ef51.png
[Center 29]: /images/20210920/7e1a872b79ca414095b7c8cf46ac76cf.png
[Center 30]: /images/20210920/f00ef0a2a2e7426bb6fd9f8abc8f13b1.png
[Center 31]: /images/20210920/a68b05e344d848448b0b5e6a1fb77b28.png
[20170423173410084]: /images/20210920/d4be7ff2b39649b8b58e95ef4948328f.png
[20170423174049905]: /images/20210920/11e3ae10e0a942b5bff8b70bf316c292.png