maven 常用命令和配置文件解析(转)

依赖包查询

maven 仓库： 
http://repo1.maven.org/maven2/ 

maven 仓库搜索（对于依赖包坐标搜索）： 
http://mvnrepository.com

 

 

 

Maven2   的运行命令为   ：   mvn   ，

常用命令为  ：

      mvn dependency:sources 下载依赖包的源代码

             mvn  archetype :create   ：创建  Maven  项目

             mvn  compile  ：编译源代码

             mvn  test-compile  ：编译测试代码

             mvn  test   ：  运行应用程序中的单元测试

             mvn  site  ：  生成项目相关信息的网站

             mvn  clean   ：清除目标目录中的生成结果

             mvn  package  ：  依据项目生成  jar  文件

             mvn  install   ：在本地  Repository  中安装  jar

              mvn  eclipse:eclipse  ：生成  Eclipse  项目文件

生成项目

              建一个  JAVA  项目  ：  mvn  archetype :create -DgroupId=com.demo -DartifactId=App

           建一个  web  项目  ：  mvn  archetype :create -DgroupId=com.demo -DartifactId=web-app -Darchetype ArtifactId=maven-archetype -webapp

 

生成普通工程：

mvn archetype:create -DgroupId=com.sefer.employ -DartifactId=EmployJava -DpackageName=com.sefer.employ -Dversion=1.0

 

生成web工程：

mvn archetype:create -DgroupId=com.sefer.employ -DartifactId=EmployWebapp -DpackageName=com.sefer.employ -DarchetypeArtifactId=maven-archetype-webapp

 

生成  Eclipse  项目

普通  Eclipse  项目执行  ：  mvn  eclipse:eclipse

           Eclipse WTP  项目执行  ：  mvn  eclipse:eclipse  –Dwtpversion=1.0

               （  wtp1.0  以上版本均可用）

 

 

5个必须掌握的maven命令

 

1. mvn help:describe 你是否因为记不清某个插件有哪些goal而痛苦过,你是否因为想不起某个goal有哪些参数而苦恼,那就试试这个命令吧,它会告诉你一切的. 参数: 1. -Dplugin=pluginName 2. -Dgoal(或-Dmojo)=goalName:与-Dplugin一起使用,它会列出某个插件的goal信息,如果嫌不够详细,同样可以加-Ddetail.(注:一个插件goal也被认为是一个 “Mojo”) 下面大家就运行mvn help:describe -Dplugin=help -Dmojo=describe感受一下吧!

如：

mvn help:describe -Dcmd=install
mvn help:describe -Dcmd=help:describe
mvn help:describe -Dplugin=org.apache.maven.plugins:maven-help-plugin
mvn help:describe -DgroupId=org.apache.maven.plugins -DartifactId=maven-help-plugin

 

2. mvn archetype:generate 你是怎么创建你的maven项目的?是不是像这样:mvn archetype:create -DarchetypeArtifactId=maven-archetype-quickstart -DgroupId=com.ryanote -Dartifact=common,如果你还再用的话,那你就out了,现代人都用mvn archetype:generate了,它将创建项目这件枯燥的事更加人性化,你再也不需要记那么多的archetypeArtifactId,你只需输入archetype:generate,剩下的就是做”选择题”了.

 

3. mvn tomcat:run 用了maven后,你再也不需要用eclipse里的tomcat来运行web项目(实际工作中经常会发现用它会出现不同步更新的情况),只需在对应目录(如/ryanote)里运行 mvn tomat:run命令,然后就可在浏览器里运行http://localhost:8080/ryanote查看了.如果你想要更多的定制,可以在pom.xml文件里加下面配置: 01 02 03 04 org.codehaus.mojo 05 tomcat-maven-plugin 06 07 /web 08 9090 09 10 11 12 当然你也可以在命令里加参数来实现特定的功能,下面几个比较常用: 1. 跳过测试:-Dmaven.test.skip(=true) 2. 指定端口:-Dmaven.tomcat.port=9090 3. 忽略测试失败:-Dmaven.test.failure.ignore=true 当然,如果你的其它关联项目有过更新的话,一定要在项目根目录下运行mvn clean install来执行更新,再运行mvn tomcat:run使改动生效.

 

4. mvnDebug tomcat:run 这条命令主要用来远程测试,它会监听远程测试用的8000端口,在eclipse里打开远程测试后,它就会跑起来了,设断点,调试,一切都是这么简单.上面提到的那几个参数在这里同样适用.

 

5. mvn dependency:sources 故名思义,有了它,你就不用到处找源码了,运行一下,你项目里所依赖的jar包的源码就都有了

 

mvn dependency:sources -DdownloadSources=true -DdownloadJavadocs=true

(-DdownloadSources=true 下载源代码jar。 -DdownloadJavadocs=true 下载javadoc包。)

 

mvn -DdownloadSources=true -DdownloadJavadocs=true eclipse:eclipse

 

pom.xml   文件基本节点介绍

<project  >  ：文件的根节点  .
<modelversion  >  ：  pom.xml  使用的对象模型版本  .
<groupId  >  ：创建项目的组织或团体的唯一  Id.
<artifactId  >  ：项目的唯一  Id,  可视为项目名  .
<packaging  >  ：打包物的扩展名，一般有  JAR,WAR,EAR  等  
<version  >  ：产品的版本号  .
<name  >  ：项目的显示名，常用于  Maven  生成的文档。  
<url  >   ：组织的站点，常用于  Maven  生成的文档。  
<description  >  ：项目的描述，常用于  Maven  生成的文档。

 

 

在  POM 4  中，  <dependency>  中还引入了  <scope>  ，它主要管理依赖的部署。

目前  <scope>  可以使用  5  个值：

compile  ：缺省值，适用于所有阶段，会随着项目一起发布。

provided  ：类似  compile  ，期望  JDK  、容器或使用者会提供这个依赖。如  servlet.jar  。

runtime  ：只在运行时使用，如  JDBC  驱动，适用运行和测试阶段。

test  ：只在测试时使用，用于编译和运行测试代码。不会随项目发布。

          system   ：类似   provided   ，需要显式提供包含依赖的   jar   ，   Maven   不会在   Repository   中查找它。

定义自己的结构

新建一个  archetype   项目  ：

mvn  archetype :create/ 
-DgroupId=cn.prof/ 
-DartifactId=prof-archetype / 
-Darchetype ArtifactId=maven-archetype -archetype

        主要的模板文件  ：  archetype -resources/pom.xml

        修改其中内容

        修改  META-INF/maven/archetype .xml  中定义了相关的  sources

        安装此项目  ：  mvn  install

执行下面的命令创建新目录的项目：

mvn  archetype :create -DgroupId=com.mergere.mvn book / 
-DartifactId=proficio-example/ 
-Darchetype GroupId=com.xxx.mvn / 
-Darchetype ArtifactId=  prof-archetype  / 
-Darchetype Version=1.0-SNAPSHOT

目录说明

Maven2  Directory
目录	二级目录	三级目录	四级目录	说明
pom.xml		Maven2  的项目设置文件
src/		源码目录
main/		项目主体目录根
java/		源代码目录
resources/		所需资源目录
filters/		资源过滤文件目录
assemby/		Assembly descriptors
config/		配置文件根目录
webapp/		web  应用目录
WEB-INF/	WEB-INF  目录
test/		项目测试目录根
java/		测试代码目录
resources/		测试所需资源目录
filters/		测试资源过滤文件目录
site/		与site  相关的资源目录
target/		输出目录根
classes/			项目主体输出目录
test_classes/		项目测试输出目录
site/		项目site  输出目录

 

    在Maven2中有了明确的生命周期概念，而且都提供与之对应的命令，使得项目构建更加清晰明了。主要的生命周期阶段：

 

    validate，验证工程是否正确，所有需要的资源是否可用。 
compile，编译项目的源代码。 
test-compile，编译项目测试代码。 
test，使用已编译的测试代码，测试已编译的源代码。 
package，已发布的格式，如jar，将已编译的源代码打包。 
integration-test，在集成测试可以运行的环境中处理和发布包。 
verify，运行任何检查，验证包是否有效且达到质量标准。 
install，把包安装在本地的repository中，可以被其他工程作为依赖来使用 
deploy，在整合或者发布环境下执行，将最终版本的包拷贝到远程的repository，使得其他的开发者或者工程可以共享。 
generate-sources，产生应用需要的任何额外的源代码，如xdoclet。 
如果要执行项目编译，那么直接输入：mvn compile即可，对于其他的阶段可以类推。阶段之间是存在依赖关系（dependency）的，如test依赖test-compile。在执行 mvn test时，会先运行mvn test-compile，然后才是mvn test 

因为maven2 是有生命周期这一概念的，所以如果你执行package，相应的以前步骤，如compile,test等都会自动执行。 
刚开始执行会比较慢，需要从maven2远程库中下载所有的文件到本地。如果你的本地没有相应的依赖包，则每次maven都会去远程下载，所以配置一个镜像库就比较重要了。

碰到的问题

1.        当  M2eclipse  插件装上之后，会报这个错

Eclipse is running in a JRE, but a JDK is required

Some Maven plugins may not work when importing projects or updating source folders.

解决办法  ：查看  eclipse/readme/readme_eclipse.html  里面有详细说明，在  Selecting a workspace  这一节

创建一个快捷方式，设定目标位置为  D:/eclipse_jee/eclipse.exe -vm D:/Java/jdk1.5.0_10/bin/javaw

因为默认  vm  为  jdk/jre/bin/javaw  ，直接改到  jdk  下，错误即可消除

 

2.        使用命令  mvn  eclipse:eclipse  –Dwtpversion=1.0  之后，导入的项目  Project Facet  的  java  还是  1.4  ，而我  Eclipse  上设置的是  5.0

解决办法  ：在  pom.xml  中  plugins  加入说明就可以了

< plugins >
        < plugin >
           < artifactId > maven-compiler-plugin </ artifactId >
           < configuration >
               < source > 1.5 </ source >
               < target > 1.5 </ target >
           </ configuration >
        </ plugin >
</ plugins >

< plugins >           < plugin >              < artifactId > maven-compiler-plugin </ artifactId >              < configuration >                  < source > 1.5 </ source >                  < target > 1.5 </ target >              </ configuration >           </ plugin >   </ plugins >

 

 

3.   在使用命令mvn  eclipse:eclipse 之后，import到Eclipse，然后在Eclipse项目上点右键，选择插件Maven>Enable Dependency Management后，会报重复引用依赖的错误
解决办法 ：再执行mvn  eclipse:eclipse然后刷新Eclipse的项目，取消掉maven插件的引用依赖，错误就会消除

 

4.   Failure executing javac, but could not parse the error:
编译器 (1.5.0_10) 中出现异常。 如果在 Bug Parade 中没有找到该错误，请在 Java Developer Connection (http://java.sun.com/webapps/bugreport )  对该错误进行归档。 请在报告中附上您的程序和以下诊断信息。谢谢您的合作。
java.nio.BufferOverflowException
解决办法 ：(临时)在控制面板中将区域与语言选项中，把当地语言设为英语
（为什么我还会出现这个问题？请指教）