[转载]Maven初级入门笔记

最近在研究Maven，写了一个简单的学习笔记。

本文所有资料百度云地址：http://pan.baidu.com/s/1jGn27PG

首先需要在本机上搭建一个nexus私服.

第一步，将Maven总结资料工具目录下的nexus-2.1.2.war直接放在D:Tomcat 7.0webapps目录下。

第二步，启动tomcat后，在webapps目录下生成一个nexus-2.1.2目录。

第三步，停掉tomcat，修改nexus-2.1.2目录名称为nexus。再次启动tomcat，访问http://127.0.0.1:9999/nexus 正常，说明nexus私服安装成功，本机电脑IP为10.1.16.158，tomcat端口为9999

 以下目录：

前言

1.Maven本地安装

2.在eclipse中配置maven

3.在eclipse中建立Web项目

4.在eclipse中使用Maven管理Web

 前言

本人电脑使用的操作系统为XP，以下文档是根据本人的电脑环境进行讲解和配置的。

1.Maven本地安装

1.检查jdk安装的情况(1.6以上版本):

Echo %JAVA_HOME%

java -version

在命令行窗口输入以上命令后，如果出现下图界面中的反馈信息，说明本机JDK未安装、环境变量未设置或配置的有问题。需要安装JDK以及配置环境变量，这里不再介绍如何安装，默认本机已经安装JDK及配置好到了Path环境变量中。

 

2.设置系统环境变量，JAVA_HOME

 

可以看到本人的JDK目录位置为D:jdk

3.对工具目录下的apache-maven-3.0.5-bin.zip进行解压缩，例如解压到如下目录(解压目录不要有中文字，不要有空格)：

D:apache-maven-3.0.5，解压后的目录结构如下图。

4.设置系统环境变量，MAVEN_HOME

 

5.设置环境变量Path，将%MAVEN_HOME%in加入Path中，一定要注意要用分号；与其他值隔开

 

6.验证安装是否成功，打开cmd窗口，敲入mvn -v 查看

 

出现如上页面说明MVN已经安装成功。

2.在eclipse中配置Maven

1.将D:apache-maven-3.0.5confsettings.xml文件复制到目录C:Documents and Settingsuser.m2。如果登陆电脑用户不同，需要将user更改为当前电脑登陆用户名称。如果没有.m2目录，在CMD窗口中执行mvn clean命令后会自动生成此目录，如下图

 

报错信息是因为在当前目录下没有pom.xml文件，可以暂时不用管。

2.解压工具目录下的eclipse的J2EE版本加已安装SVN插件.rar到D盘，将D盘的J2EE版本加已安装SVN插件目录下的eclipse目录剪切到D盘根目录后，打开eclipse目录后如下图。

 

3.点击eclipse.exe打开eclipse，在eclipse中配置Maven环境。eclipse的默认工作空间为D:eclipseworkspace。在eclipse中点击window下的Preferences后，在弹出的操作窗口中点击Maven下的Installations后如下图。

      

在选项Installations中，点击add，选取本机maven安装根目录，如下图。

 

点击确定后，如下图。

 

到此已经添加本地的Maven到eclipse中，因为eclipse和myeclipse自带的Maven很不稳定，在开发工具中需要配置使用本机安装的Maven.

下面再配置User Settings选项，点击User Settings后如下图.

 

配置如上图，如果对settings.xml进行了修改，需要点击Update Settings。在上图中可以看到默认的Maven本地仓库位置为C:Documents and Settingsuser.m2 epository

到此，在eclipse中的Maven环境就配置好了，下面就可以在eclipse中建立项目，使用Maven了。

3.在eclipse中建立Web项目

第一步，在eclipse中点击File-New-Project，选择Maven Project,如下图。

 

第二步，点击Next，如下图。

 

第三步，直接点击Next后，如下图。

 

第四步，在上图中需要选择maven-archetype-webapp，点击Next后，如下图。

 

第五步，在上图中填入数据，其中projectname可以修改为项目的简写名称，MavenWeb为项目名称，Version选择默认就可以（默认为快照版本），点击Finish后，一个Mave Web项目就建立好了，切换到JAVA视图，建立后的项目目录结构如下图。

 

由上图可以看到在eclipse自己创建的Maven Web项目中，需要手动建立一些目录才能够完全满足Maven约定。这里不再手动创建目录，我们手动导入一个已经按照Maven约定建立好额外目录的Maven项目。

4.在eclipse中使用Maven管理WEB项目

第一步，将Maven总结资料源代码目录下的nexusMaven复制到D:eclipseworkspace目录下。在eclipse中点击File-Import后如下图。

 

第二步，选择Maven下的Existing Maven Projects，点击Next后，如下图。

 

第三步，点击Browse后，选取nexusMaven目录，如下图。

 

第四步，点击确定后，如下图。

 

第五步，点击Next后，如下图。

 

第六步，点击Finish，就完成了导入项目nexusMaven到eclipse中。如下图。

 

可以看到nexusMaven比eclipse自动创建的Maven Web项目多了src/test/java和src/main/java两个目录。

l  src/main/java存放项目源代码

l  src/test/java存放测试源代码

l  src/main/resources存放项目配置文件

l  Maven Dependencies下的jar为项目依赖的jar

l  webapp相对于myeclipse中web项目的WebRoot目录

l  target为项目编译、测试、文档输出目录。

第七步，修改nexusMaven项目下的pom.xml，将里面的127.0.0.1:9999全部修改为Maven私服所在的IP和端口号，目前为10.1.16.158:9999

第八步，使用Maven总结资料配置文件目录下的settings.xml文件覆盖掉C:Documents and Settingsuser.m2下的settings.xml文件，并且将文件里面的所有127.0.0.1:9999修改为Maven私服所在的IP和端口号，目前为10.1.16.158:9999。在此settings.xml文件中将本地仓库配置在了D:apache-maven-3.0.5 epository目录下。

第九步，需要在eclipse中的下图中，点击Update Settings，更新settings.xml文件。

 

第十步，下面我们将执行Maven操作。

首先执行项目清理操作，此操作会删除target构建目录，如下图。

 

选中nexusMaven项目中的pom.xml，单击鼠标右键，选择Run as下的Maven clean。执行后，控制台出现[INFO] BUILD SUCCESS信息，说明执行清理成功。

[WARNING]

[WARNING] Some problems were encountered while building the effective settings

[WARNING] Unrecognised tag: 'mirror' (position: START_TAG seen ...e preferred    | server for that repository.    |-->    <mirror>... @163:12)  @ C:Documents and Settingsuser.m2settings.xml, line 163, column 12

[WARNING]

[INFO] Scanning for projects...

[INFO]                                                                        

[INFO] ------------------------------------------------------------------------

[INFO] Building nexusMaven Maven Webapp 0.0.1-release

[INFO] ------------------------------------------------------------------------

[INFO]

[INFO] --- maven-clean-plugin:2.4.1:clean (default-clean) @ nexusMaven ---

[INFO] Deleting D:eclipseworkspace exusMaven arget

[INFO] ------------------------------------------------------------------------

[INFO] BUILD SUCCESS

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 0.344s

[INFO] Finished at: Wed Apr 16 13:08:56 CST 2014

[INFO] Final Memory: 2M/15M

[INFO] ------------------------------------------------------------------------

下面执行部署命令，此命令可以将项目打成WAR包，并且将包安装到本地仓库和私服，提供下载和依赖服务。选中nexusMaven项目中的pom.xml，单击鼠标右键，选择Run as下的Maven build..后，如下图。

 

在Goals中输入deploy，点击最下边的Run，执行部署命令。执行后，控制台出现[INFO] BUILD SUCCESS信息，说明执行部署成功。

[WARNING]

[WARNING] Some problems were encountered while building the effective settings

[WARNING] Unrecognised tag: 'mirror' (position: START_TAG seen ...e preferred    | server for that repository.    |-->    <mirror>... @163:12)  @ C:Documents and Settingsuser.m2settings.xml, line 163, column 12

[WARNING]

[INFO] Scanning for projects...

[INFO]                                                                        

[INFO] ------------------------------------------------------------------------

[INFO] Building nexusMaven Maven Webapp 0.0.1-release

[INFO] ------------------------------------------------------------------------

[INFO]

[INFO] --- maven-resources-plugin:2.5:resources (default-resources) @ nexusMaven ---

[debug] execute contextualize

[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!

[INFO] Copying 0 resource

[INFO]

[INFO] --- maven-compiler-plugin:2.3.2:compile (default-compile) @ nexusMaven ---

[WARNING] File encoding has not been set, using platform encoding GBK, i.e. build is platform dependent!

[INFO] Compiling 1 source file to D:eclipseworkspace exusMaven argetclasses

[INFO]

[INFO] --- maven-resources-plugin:2.5:testResources (default-testResources) @ nexusMaven ---

[debug] execute contextualize

[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!

[INFO] skip non existing resourceDirectory D:eclipseworkspace exusMavensrc est esources

[INFO]

[INFO] --- maven-compiler-plugin:2.3.2:testCompile (default-testCompile) @ nexusMaven ---

[WARNING] File encoding has not been set, using platform encoding GBK, i.e. build is platform dependent!

[INFO] Compiling 1 source file to D:eclipseworkspace exusMaven arget est-classes

[INFO]

[INFO] --- maven-surefire-plugin:2.10:test (default-test) @ nexusMaven ---

[INFO] Surefire report directory: D:eclipseworkspace exusMaven argetsurefire-reports

 

-------------------------------------------------------

 T E S T S

-------------------------------------------------------

Running com.song.wbgy.user.test.UserTest

User [name=lisong, password=123456]

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.047 sec

 

Results :

 

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

 

[INFO]

[INFO] --- maven-war-plugin:2.1.1:war (default-war) @ nexusMaven ---

[INFO] Packaging webapp

[INFO] Assembling webapp [nexusMaven] in [D:eclipseworkspace exusMaven arget exusMaven-0.0.1-release]

[INFO] Processing war project

[INFO] Copying webapp resources [D:eclipseworkspace exusMavensrcmainwebapp]

[INFO] Webapp assembled in [47 msecs]

[INFO] Building war: D:eclipseworkspace exusMaven arget exusMaven-0.0.1-release.war

[WARNING] Warning: selected war files include a WEB-INF/web.xml which will be ignored

(webxml attribute is missing from war task, or ignoreWebxml attribute is specified as 'true')

[INFO]

[INFO] --- maven-install-plugin:2.3.1:install (default-install) @ nexusMaven ---

[INFO] Installing D:eclipseworkspace exusMaven arget exusMaven-0.0.1-release.war to D:apache-maven-3.0.5 epositorycomsongwbgy exusMaven.0.1-release exusMaven-0.0.1-release.war

[INFO] Installing D:eclipseworkspace exusMavenpom.xml to D:apache-maven-3.0.5 epositorycomsongwbgy exusMaven.0.1-release exusMaven-0.0.1-release.pom

[INFO]

[INFO] --- maven-deploy-plugin:2.7:deploy (default-deploy) @ nexusMaven ---

Uploading: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/0.0.1-release/nexusMaven-0.0.1-release.war

Uploaded: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/0.0.1-release/nexusMaven-0.0.1-release.war (4 KB at 9.8 KB/sec)

Uploading: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/0.0.1-release/nexusMaven-0.0.1-release.pom

Uploaded: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/0.0.1-release/nexusMaven-0.0.1-release.pom (2 KB at 8.2 KB/sec)

Downloading: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/maven-metadata.xml

Uploading: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/maven-metadata.xml

Uploaded: http://127.0.0.1:9999/nexus/content/repositories/releases/com/song/wbgy/nexusMaven/maven-metadata.xml (319 B at 3.3 KB/sec)

[INFO] ------------------------------------------------------------------------

[INFO] BUILD SUCCESS

[INFO] ------------------------------------------------------------------------

[INFO] Total time: 3.016s

[INFO] Finished at: Wed Apr 16 13:13:08 CST 2014

[INFO] Final Memory: 10M/25M

[INFO] ------------------------------------------------------------------------

在输出信息中详细的记录的Maven deploy命令的执行过程及执行结果。

注：

1、            如何在eclipse中建立Web项目，请查看地址http://hi.baidu.com/sdhzlzhk/item/3c0b26c42786517189ad9e80

2、            Maven Web Project同样可以点击Run as下的Run on Server启动服务器进行测试，之前需要建立一个Server项目，具体创建方法请查看http://hi.baidu.com/sdhzlzhk/item/3c0b26c42786517189ad9e80

3、            Maven项目的jar包添加方式和以往有很大不同，Maver项目使用了自己的依赖管理，通过pom.xml进行配置实现对jar包的依赖管理，具体请查看资料目录下的文件。Maven使用仓库和私服共同管理jar包，一个jar包只需要一个人添加一次，其他人就可以通过配置pom.xml进行使用，无需重复下载和添加。

4、            Maven可以将项目的编译、测试、打包、生成文档通过maven deploy一起执行。Maven生成的文档一般不使用。

5、            如果要发布项目正式版本需要在pom.xml文件中的version属性值中含有release关键字，这样项目将发布到私服的正式仓库，否则将当做非正式版本发布到私服的快照仓库。

6、            在使用Maven发布版本时，需要一定的规范和制度，可以参考下Maven的版本管理。

文章是使用到的安装包及文档的百度云分享地址：http://pan.baidu.com/s/1q5wBG