首页 > 代码库 > [转载]Maven初级入门笔记

[转载]Maven初级入门笔记

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

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

 

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

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

第二步,启动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%\bin加入Path中,一定要注意要用分号;与其他值隔开

 技术分享

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

技术分享 

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

2.在eclipse中配置Maven

1.将D:\apache-maven-3.0.5\conf\settings.xml文件复制到目录C:\Documents and Settings\user\.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:\eclipse\workspace。在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 Settings\user\.m2\repository

到此,在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:\eclipse\workspace目录下。在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 Settings\user\.m2下的settings.xml文件,并且将文件里面的所有127.0.0.1:9999修改为Maven私服所在的IP和端口号,目前为10.1.16.158:9999。在此settings.xml文件中将本地仓库配置在了D:\apache-maven-3.0.5\repository目录下。

第九步,需要在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 \n   | server for that repository.\n   |-->\n\n   <mirror>... @163:12)  @ C:\Documents and Settings\user\.m2\settings.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:\eclipse\workspace\nexusMaven\target

[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 \n   | server for that repository.\n   |-->\n\n   <mirror>... @163:12)  @ C:\Documents and Settings\user\.m2\settings.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:\eclipse\workspace\nexusMaven\target\classes

[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:\eclipse\workspace\nexusMaven\src\test\resources

[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:\eclipse\workspace\nexusMaven\target\test-classes

[INFO]

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

[INFO] Surefire report directory: D:\eclipse\workspace\nexusMaven\target\surefire-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:\eclipse\workspace\nexusMaven\target\nexusMaven-0.0.1-release]

[INFO] Processing war project

[INFO] Copying webapp resources [D:\eclipse\workspace\nexusMaven\src\main\webapp]

[INFO] Webapp assembled in [47 msecs]

[INFO] Building war: D:\eclipse\workspace\nexusMaven\target\nexusMaven-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:\eclipse\workspace\nexusMaven\target\nexusMaven-0.0.1-release.war to D:\apache-maven-3.0.5\repository\com\song\wbgy\nexusMaven\0.0.1-release\nexusMaven-0.0.1-release.war

[INFO] Installing D:\eclipse\workspace\nexusMaven\pom.xml to D:\apache-maven-3.0.5\repository\com\song\wbgy\nexusMaven\0.0.1-release\nexusMaven-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

[转载]Maven初级入门笔记