Maven实战之初识Maven

Maven实战之初识Maven

Maven的简单介绍

1. 作用：Maven主要用于项目的构建，管理项目的依赖以及项目的信息（自动化构建、编译、单元测试、生成文档、打包、部署）
2. 优势：相对于Ant、Make等，Maven抽象构建过程，提供构建任务的实现，自动化构建，有效地提高了开发效率，使开发人员可以集中精力在主要的开发任务上。而且Maven是跨平台工具，意味着在主流操作系统中，Maven都提供了对应的技术支持
3. 使用注意：需要在JDK1.4及以上版本使用

Maven的安装

下载地址：Maven下载地址 ，选择最新版本的Binary文件即可，这里使用的是最新的apache-maven-3.3.9-bin.zip

Windows平台安装

1. 首先将下载下来的Maven文件解压到一个文件中

2. 然后配置环境变量（该步骤可省略，不过建议配上）

   1. 新建一个名为M2_HOME 的变量，其值为刚刚解压缩的maven文件，这里为E:\Program Files (x86)\apache-maven-3.3.9 如下所示

   

   2. 将;%M2_HOME%/bin; 添加到PATH路径中，如下所示：

      

3. 测试配置结果：

   打开CMD窗口，输入 mvn -version 如果上面的配置正确，则可以看到对应的输出信息，大致如下所示

   

Linux平台的配置

Linux平台的配置跟Windows平台的配置基本一致，只是将Maven文件加入Path路径的方式不同，这里就不做具体演示

Maven的简单配置

为了更好地使用Maven，这里对Maven进行简单的配置

拷贝settting.xml 文件

在刚刚解压的Maven文件中，在conf目录中有一个setting.xml，这是Maven的全局性设置文件，在该文件中的修改会影响到当前计算机的所有用户，一般情况下，推荐复制一份到家目录的的.me文件夹之下，windows的配置路径为C:\Users\xuhuanfeng\.m2

设置代理

由于某些原因，Maven使用过程中有时会出现无法连接到中央仓库的情况，这个时候可以尝试更换仓库地址，也可以选择设置代理，这里使用的是设置代理的方式，设置方式为在中增加一个，具体如下所示

<proxies>
   <proxy>
      <id>proxy</id><!--代理名称-->
      <active>true</active><!--选择该代理-->
      <protocol>http</protocol><!--代理协议-->
      <host>127.0.0.1</host><!--代理服务器地址-->
      <port>1080</port><!--代理端口-->
   </proxy>
</proxies>

Maven_HelloWorld

搭建完Maven平台之后，我们就开始我们的Maven学习之旅，首先肯定是久负盛名的HelloWorld项目了

1. 新建一个文件夹，命名为HelloWorld作为我们项目的根目录
2. 在HelloWorld目录下编写一个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/maven-v4_0_0.xsd">  

      <modelVersion>4.0.0</modelVersion>
      <!--Maven2 / Maven3 固定写法-->
      <groupId>cn.xuhuanfeng.maven</groupId>
      <!--groupId，可以近似当作公司/组织+项目名-->
      <artifactId>HelloWorld</artifactId>
      <!--artifactId，可以近似看做模块名称-->
      <version>1.0-SNAPSHOT</version>
      <!--当前版本号-->
      <name>Maven_HelloWorld</name>
      <!--项目的名称，可以省略-->
 </project>   
 

3. 在 HelloWorld文件中，创建对应的Java类，对应的包路径为 src/main/java/cn/xuhuanfeng/maven/HelloWorld.java，内容如下

package cn.xuhuanfeng.maven;
/**
*  Maven HelloWorld项目
*/
public class HelloWorld{

    public String  sayHello(){
        return "Maven_HelloWorld";
    }

4. 使用CMD窗口进入到项目的根目录，也就是HelloWorld目录下，执行mvn clean compile，输入内容如下

   

从上图中可以看到，HelloWorld项目已经编译成功了，其中的部分细节内容，后续将补上，这里可以暂时先不在意

在HelloWorld目录中，会自动生成target目录，其中有一个名为classes文件夹，编译好的class文件就存放在这里,类路径跟包名一一对应，如下所示：

编写测试用例

这里我们为HelloWorld.java编写对应的单元测试，并且交给Maven由其进行自动的测试

1. 引入Junit依赖，在pom.xml文件中，project元素下增加Junit依赖，代码如下：

<dependencies>
 <dependency>
     <!--引入Junit依赖-->
     <groupId>junit</groupId>
     <artifactId>junit</artifactId>
     <version>4.7</version>
     <scope>test</scope>
 </dependency>
</dependencies>

2. 编写测试类，在 HelloWorld文件中，创建对应的Java类，对应的包路径为 src/test/java/cn/xuhuanfeng/maven/TestHelloWorld.java，内容如下

package cn.xuhuanfeng.maven;

import static org.junit.Assert.assertEquals;
import org.junit.Test;

/**
*  测试HelloWorld
*/
public class HelloWorldTest{

    @Test
    public void testHelloWorld(){
        HelloWorld helloWorld = new HelloWorld();
        String result = helloWorld.sayHello();
        assertEquals("Maven_HelloWorld",result);
    }

}

3. 运行测试用例，执行命令为mvn clean test， 对应的结果如下所示：

   

从上图中可以看到，在执行test之前，会对整个项目先进行compile，从而保证始终得到最新版本的class文件，并且，从图中可以看到，Maven自动帮我们 运行测试样例，并且返回样例的结果。

文件路径说明

Maven会自动编译src/main/java目录下的文件，并且编译，运行src/test/java目录下的测试样例，这也是我们将路径命名如下的原因，同时，将测试代码以及主代码分开也是一种比较好的做法。

自动生成项目骨架

在上面中，我们手动编写了一个基本的Maven项目，包括了配置pom.xml，HelloWorld.java以及对应的测试类，可能你会感觉到实际上使用Maven很麻烦，确实，如果按照上面那种做法，很繁琐，所以Maven为我们提供了另一种机制，可以通过配置archetype来生成对应的项目骨架，不过，由于这里只是简单的入门，所以我们直接使用Maven提供的archetype即可，通过命令mvn archetype:generate 就可以快速地生成一个项目的骨架，具体过程如下所示：

中间会有很多内容，主要是Maven从中央仓库中拉取相关的信息，这里省略

然后可以看到熟悉的内容，只需要在这里填入对应的groupId，artifactId，version，package等信息即可

最后生成的项目结果图如下所示：

并且包含了Junit依赖以及一个简单的测试样式，是不是很方便？

总结

在这一小节中，我们了解了关于Maven的一些基本知识，手动创建了一个Maven例子，HelloWorld，并为其编写测试样例，通过Maven的构建插件以及测试插件，自动完成编译、测试的工作，最后通过Maven的自动构建工具，构建一个简单的项目骨架，Maven的学习之路还在继续。

本节中主要用到的命令为

 mvn clean compile
 mvn clean test
 mvn archetype:generate