[置顶] Maven3实战笔记环境配置与使用入门(一)

1.  前言

Maven是apache的一个顶级项目，它的出现越来越影响着现在的众多的开源项目，不仅如此，很多公司的很多新项目都采用Maven提倡的方式进行管理。Maven正逐渐侵入我们原先的管理项目的习惯，对于团队的管理，项目的构建，都是一种质的飞跃。当然是我个人的一些项目经验而说的这话。如果原先的团队老大本身的管理非常科学，也有一套其他软件辅助项目的构建、打包、发布等等一系列机制保证。那么Maven可能对其并没有实质性的影响或者是质的飞跃。当然在此也并不是说咱们中国人做出来的项目就管理不善……只是说利用Maven帮助我们构建项目更科学、更有可维护性、更加模块化、模块功能更加职能单一、做出来的项目更加具有可复用性等等好处。当然笔者也是个刚学习Maven的人，我们一起来学习Maven到底为我们带来了什么好处。笔者邮箱已经给出，欢迎与笔者进行学术上的交流。

2.  Maven的思想

本来想看完了实战整本，再写总结的，后来觉得还是先写出来吧。哪怕有什么不对的地方再纠正都不晚，就怕到时候看完了一点心得都没有，全忘了就太……所以先将学习的点点滴滴感受写下来，之后结合实例咱们可以反复的推敲。

目前笔者看到的Maven的主要功能是：项目构建；项目构建；项目依赖管理；软件项目持续集成；版本管理；项目的站点描述信息管理；

由此可以看出Maven最主要的体现在了哪2个词？——对了，“项目”和“管理”！加在一起就是项目管理。项目管理是一个很抽象的概念。项目管理既可以指技术上的管理手段，也可以指“以人为本”的非技术因素。诚然，无论是技术还是非技术，项目的成败最大的责任人其实就是项目经理。这里我们抛开人为因素不提，仅就技术上来说，Maven提供了一种思想让团队更科学的管理、构建项目。用配置文件的方式对项目的描述、名称、版本号、项目依赖等等信息进行描述。使之项目描述结构清晰，任何人接手的成本比较低。在项目构建时，利用Maven的“约定大于配置”的思想，可以比Ant脚本构建项目省去不少配置文件的内容。而且一个项目可能依赖于其他的项目和第三方的组件才能顺利完成，Maven提供了仓库的概念，让这些依赖项放进仓库中，项目想要从仓库中去取，其他项目组也需要，OK，从仓库中去取，不必每个人去开源项目的站点去苦苦搜寻了。如此人员的成本、软件维护的成本、沟通的成本、硬件的成本都降下来了。客户笑了、公司老板也笑了、项目经理笑了、团队里面的人员也笑了、Apache社区看到这么多人在用也笑了。给笔者的感觉，现在的开源东西越来越向“敏捷开发”、“极限编程”的方向靠拢。通过Maven辅助管理项目，更能发现项目中哪些模块是重复的轮子。

3.  Maven的环境搭建

下面我们来看看Maven的环境搭建。首先从Apache网站下载Maven。下载url是：http://maven.apache.org/download.html。笔者下载的是Maven 3.0.3版本。下载下来的包结构如下

 bin就不用说了，就是Maven的一些命令参数，boot里面是Maven自己的类加载器，咱们也不必理会。conf里面有个settings.xml就是本机Maven的总配置信息。lib是Maven运行时需要的类库。将bin目录和JDK的bin目录一样设置为系统的PATH。这样在命令行就能直接运行Maven指令了。

保持网络畅通，在命令行执行一条语句

 mvn help:system

 会从网上下载很多东西，本地用户的临时文件夹，会生成一个临时Maven文件目录，用于存储本地资源仓库。比如在C:\Users\liuyan下面有个文件夹叫做.m2

 

将刚刚提到的settings.xml拷贝到C:\Users\liuyan\.m2下面，如此Maven就算在本机安装好了。

开发工具的选用，笔者使用的是Myeclipse8.6版本，此IDE已经集成了Maven插件Maven4Myeclipse，仅需要将总配置信息配置上即可。在Myeclipse点击window菜单，打开preferences选项。之后点击到myeclipse的maven4myeclipse节点，如下图所示。

 

4.  Maven使用入门

首先我们先写一个非常简单的小项目（我们姑且称之为项目啊），项目结构如下图所示

 

src.main.java是项目代码文件夹、src.test.java是项目单元测试文件夹、src.main.resource是放置项目资源文件、配置文件文件夹。下面我们看项目代码

一个简单的类com.liuyan.maven.helloword.HelloWorld

 package com.liuyan.maven.helloword;

 public class HelloWorld {
     public String sayHello() {
         return "hello maven";
     }

     /**
      * @param args
      */
     public static void main(String[] args) {
         System.out.println(new HelloWorld().sayHello());
     }

 }

 在此项目的根目录下有一个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/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.liuyan.maven</groupId>
     <artifactId>MavenDemo</artifactId>
     <version>0.0.1-SNAPSHOT</version>
 </project>

 进入控制台，将当前目录cd到与pom.xml同级的文件夹下面。执行命令

 mvn clean compile

 因为笔者写总结前之前下载了相关包，所以此时相关输出download包的信息少一些

 [INFO] Scanning for projects...
 [INFO]
 [INFO] ------------------------------------------------------------------------
 [INFO] Building MavenDemo 0.0.1-SNAPSHOT
 [INFO] ------------------------------------------------------------------------
 [INFO]
 [INFO] --- maven-clean-plugin:2.4.1:clean (default-clean) @ MavenDemo ---
 [INFO] Deleting E:\Genuitec\ws\MavenDemo\target
 [INFO]
 [INFO] --- maven-resources-plugin:2.4.3:resources (default-resources) @ MavenDem
 o ---
 [WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e
 . build is platform dependent!
 [INFO] skip non existing resourceDirectory E:\Genuitec\ws\MavenDemo\src\main\res
 ources
 [INFO]
 [INFO] --- maven-compiler-plugin:2.3.2:compile (default-compile) @ MavenDemo ---

 [WARNING] File encoding has not been set, using platform encoding GBK, i.e. buil
 d is platform dependent!
 [INFO] Compiling 1 source file to E:\Genuitec\ws\MavenDemo\target\classes
 [INFO] ------------------------------------------------------------------------
 [INFO] BUILD SUCCESS
 [INFO] ------------------------------------------------------------------------
 [INFO] Total time: 2.044s
 [INFO] Finished at: Sat May 28 16:23:07 CST 2011
 [INFO] Final Memory: 5M/15M
 [INFO] ------------------------------------------------------------------------

 执行后造成的结果。就是项目的根路径下出现了一个taget文件夹

 里面就是编译后的class类。经理过来说，你需要进行单元测试才能发布出来给大家用。Ok，我们在源码包——src/test/java下面开始编写junit单元测试类。

单元测试代码如下

 package com.liuyan.maven.helloword;

 import org.junit.Test;
 import org.junit.Assert;

 public class TestHelloWorld {

     @Test
     public void testSayHello() {
         HelloWorld helloWorld = new HelloWorld();
         Assert.assertEquals(helloWorld.sayHello(), "hello maven");
     }

 }

 之后我们因为使用了junit单元测试，那么就是说我们这个项目依赖了它。修改一下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/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.liuyan.maven</groupId>
     <artifactId>MavenDemo</artifactId>
     <version>0.0.1-SNAPSHOT</version>
     <dependencies>
         <dependency>
             <groupId>junit</groupId>
             <artifactId>junit</artifactId>
             <version>4.7</version>
             <scope>test</scope>
         </dependency>
     </dependencies>
 </project>

 进入命令行，执行命令

 mvn clean test

 执行后观察一下taget文件夹如下图，多出了test-classes文件夹和另外2个咱们暂时不用去管的文件夹。

之后在观察一下本地的临时仓库C:\Users\liuyan\.m2\repository，会多出文件夹junit，下载的版本是4.7。

如果我们想把项目打成jar的形式输出出去呢？在项目根目录下执行

 mvn clean package

 执行后效果如下

 生成了一个jar包，至于SNAPSHOT是快照的意思，快照就是项目暂时还不稳定的意思。

打包测试后没问题了，想把此项目当做Maven的本地资源仓库，为其他的项目也能提供服务，可以这么做。

执行命令

 mvn clean install

 

执行后本地的临时库文件多了你自己的这个项目。这样别的项目需要你这个项目提供服务的时候就可以从本地Mavne库中提取相应的jar了。

5.  利用IDE构建POM.xml骨架

现在的形式是这样，Maven虽然如火如荼，但是支持Maven的各种IDE插件确实还有很多不少的缺陷。正所谓名不正则言不顺，总给人感觉IDE不支持的开源项目都是“非主流”，呵呵，确实现在Maven在IDE中存在各种各样的问题，比如就刚才简单的命令在dos命令行就可以顺利执行，到了Myeclipse怎么就不行了呢。笔者在此仅仅使用IDE构建一下pom.xml文件，因为个人感觉利用IDE执行Maven命令其实意义不是很大，因为到了linux环境下还是需要手工执行Maven命令的。

使用Myeclipse工具可以为开发者提供良好的可视化编辑POM.xml文件

6.  总结

这算是开张了，本次仅仅介绍了Maven的环境搭建和入门命令，还了解了一些Maven的思想。之后我们会结合书里面的小案例来一步步的学习Maven的特性。