Maven 常用命令, 备忘

Maven在现在的Java项目中有非常重要的地位, Maven已经不是Ant这样仅仅用于构建,
首先, 它是一个构建工具, 把源代码编译并打包成可发布应用的构件工具
其次, 它是一个依赖管理工具, 集中管理项目与各种公有库, 私有库及其版本的依赖, 大大减轻代码库的数据量
再次, 它是一个项目管理工具, 管理一整个项目里面各模块的结构关系
除此以外, Maven还可以运行测试, 运行部署, 生成各种IDE的项目目录, 生成报告，生成Web站点, 等等.

Maven 命令行选项说明
使用 - 选项时，和后面的参数之间可以不要空格。而使用--选项时，和后面的参数之间必须有空格。如下面的例子：

 $ mvn help:describe -Dcmd=compiler:compile
 $ mvn install --define maven.test.skip=true
 $ mvn clean package -Pdevelopment -DskipTests

Maven常用命令

. 创建Maven的普通java项目
mvn archetype:create -DgroupId=groupId -DartifactId=artifactId
Updated: 在实际执行中, 出现"Cannot create instance of interface org.apache.maven.artifact.repository. ArtifactRepository" 错误, 后来使用的命令是
mvn archetype:generate -DgroupId=groupId -DartifactId=artifactId -DpackageName=com.somedomain.fukushima
. 创建Maven的Web项目
mvn archetype:create -DgroupId=packageName -DartifactId=webappName -DarchetypeArtifactId=maven-archetype-webapp

. 编译源代码 mvn compile

. 编译测试代码 mvn test-compile

. 运行测试 mvn test

. 产生site mvn site

. 打包, 安装, 部署
mvn package
mvn install
mvn deploy
mvn package –Dmaven.test.skip=true //打包时不执行测试
mvn deploy -Dmaven.test.skip=true -U -e // 跳过测试, 强制更新, 显示异常
mvn clean package -Pproduction -DskipTests // 跳过测试, 使用产品环境profile
. 在本地Repository中添加 mvn install
mvn install:install-file -Dfile=${jar包文件位置} -DgroupId=${groupId} -DartifactId=${artifactId} -Dversion=${版本号} -Dpackaging=jar -DgeneratePom=${是否同时创建pom文件}

. 清除产生的项目 mvn clean

. 生成IDE项目
mvn eclipse:eclipse   //生成Eclipse项目
mvn eclipse:clean      //清除Eclipse设置信息
mvn idea:ide              //转换成idea项目

. 生成idea项目 mvn idea:idea

. 运行测试类, 以及运行测试类中指定的方法
mvn test //运行全部测试
mvn test -Dtest=[ClassName]
运行测试类中指定的方法：(这个需要maven-surefire-plugin:2.7.3以上版本才能支持)
mvn test -Dtest=[ClassName]#[MethodName]
//[MethodName]为要运行的方法名，支持*通配符，范例：
mvn test -Dtest=MyClassTest#test1
mvn test -Dtest=MyClassTest#*test*
// 可以一次运行多个步骤, 例如
mvn clean package -Dmaven.test.skip=true -Pdevelopment
// 可以不编译全部, 只编译指定的模块(-pl参数)以及指定的模块所依赖的模块(-am)
mvn clean package -Dmaven.test.skip=true -Pdevelopment -pl web -am
// -pl其实是路径, 而且可以带多级路径, 例如在 foo 目录下有 bar1 bar2 bar3 模块, bar2模块下还有bar2-app模块, 如果只需要编译bar2-app及其依赖模块, 则在foo目录下, 执行
mvn clean install -DskipTests -pl bar2/bar2-server -am -e
// 其中 -e 是打开debug

. 显示一个插件的详细信息(configuration, goals等):
mvn help:describe -Dplugin=pluginName –Ddetail

. 只打jar包: mvn jar:jar  

. 只测试而不编译，也不测试编译：mvn test -skipping compile -skipping test-compile
      ( -skipping 的灵活运用，当然也可以用于其他组合命令)  

. 清除eclipse的一些系统设置:mvn eclipse:clean  

17. 查看模块内部的依赖树: mvn dependency:tree

Maven命令行参数

1. 激活profile 使用 -P 参数, 后面可不加空格, 如果需要激活多个profile, 可以使用逗号分隔

mvn package –P profileTest2,highlight

2. 使用-f参数更改默认pom.xml, 使用 -s 更改默认settings.xml

mvn package –f pom-new.xml -s /home/tomcat/settings.xml

maven中scope的作用

依赖范围控制哪些依赖在哪些classpath 中可用，哪些依赖包含在一个应用中。让我们详细看一下每一种范围：
 
compile （编译范围）
compile是默认的范围；如果没有提供一个范围，那该依赖的范围就是编译范围。编译范围依赖在所有的classpath 中可用，同时它们也会被打包。
 
provided （已提供范围）
provided 依赖只有在当JDK 或者一个容器已提供该依赖之后才使用。例如， 如果你开发了一个web 应用，你可能在编译classpath 中需要可用的Servlet API 来编译一个servlet，但是你不会想要在打包好的WAR 中包含这个Servlet API；这个Servlet API JAR 由你的应用服务器或者servlet 容器提供。已提供范围的依赖在编译classpath （不是运行时）可用。它们不是传递性的，也不会被打包。
 
runtime （运行时范围）
runtime 依赖在运行和测试系统的时候需要，但在编译的时候不需要。比如，你可能在编译的时候只需要JDBC API JAR，而只有在运行的时候才需要JDBC
驱动实现。
 
test （测试范围）
test范围依赖 在一般的编译和运行时都不需要，它们只有在测试编译和测试运行阶段可用。

system （系统范围）
system范围依赖与provided 类似，但是你必须显式的提供一个对于本地系统中JAR 文件的路径。这么做是为了允许基于本地对象编译，而这些对象是系统类库的一部分。这样的构件应该是一直可用的，Maven 也不会在仓库中去寻找它。如果你将一个依赖范围设置成系统范围，你必须同时提供一个systemPath 元素。注意该范围是不推荐使用的（你应该一直尽量去从公共或定制的 Maven 仓库中引用依赖）。