Maven常用命令

1、常用命令
mvn compile
编译主程序源代码，不会编译test目录的源代码。第一次运行时，会下载相关的依赖包，可能会比较费时。

mvn test-compile
编译测试代码，compile之后会生成target文件夹，主程序编译在classes下面，测试程序放在test-classes下。

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

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

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

mvn package
依据项目生成 jar 文件，打包之前会进行编译，测试。

mvn install
在本地 Repository 中安装 jar。

mvn eclipse:eclipse
生成 Eclipse 项目文件及包引用定义，注意，需确保定义Classpath Variables: M2_REPO，指向本地maven类库目录。

 

 

使maven2在下载依赖包的同时下载其源代码包的方法：

使用maven命令：

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

 

 

2、pom.xml 说明

<?xml version="1.0" encoding="UTF-8"?>
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.tutorial.struts2</groupId>
    <artifactId>tutorial</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>Struts 2 Starter</name>
    <url>http://www.myComp.com</url>
    <description>Struts 2 Starter</description>
    <dependencies>
        <!-- Junit -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.4</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring</artifactId>
            <version>2.5.5</version>
        </dependency>
    </dependencies>
</project>

说明：
modelversion pom.xml 使用的对象模型版本
groupId 创建项目的组织或团体的唯一 Id
artifactId> 项目唯一Id, 项目名
packaging 打包扩展名(JAR、WAR、EAR)
version 项目版本号
name 显示名，用于生成文档
url 组织站点，用于生成文档
description 项目描述，用于生成文档
dependency之scope 管理依赖部署，取值如下：
　　compile 缺省值，用于所有阶段，随项目一起发布；
　　provided 期望JDK、容器或使用者提供此依赖。如servlet.jar；
　　runtime 只在运行时使用；
　　test 只在测试时使用，不随项目发布；
　　system 需显式提供本地jar，不在代码仓库中查找；


3、创建Maven Web项目
 mvn archetype:generate -DgroupId=com.demo -DartifactId=web-app -DarchetypeArtifactId=maven-archetype-webapp
groupId 组织名，对应项目的package；artifactId 项目名；archetypeArtifactId 项目类型

 

mvn -Declipse.workspace=c:\eclipse\workspace eclipse:add-maven-repo  

 

为给eclipse指定工作空间。"c:\eclipse\workspace "即eclipse的workspace

mvn eclipse:eclipse

为项目造成eclipse工程文件。即将maven项目转化为一个eclipse工程

mvn –o war:exploded 离线发布修改过的jsp等工程文件

mvn –o package –Dmaven.test.skip=true  

离线打包工程，不含测试代码

mvn compile hibernate3:hbm2ddl  会通过hibernate映射文件创建数据库表。 mvn –o appfuse:gen –Dentity=Teacher mvn –o appfuse:install –Dentity=Teacher 通过appfuse框架自动生成与实体类对应的dao,service,action,test、jsp等程序文件 mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=D:\Test\ssh\WebRoot\WEB-INF\lib\jta.jar 将本地jar包安装到应用中去。"D:\Test\ssh\WebRoot\WEB-INF\lib\jta.jar"即本地包

Maven2 的运行命令为 ： mvn ，
常用命令为 ：

             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 -DarchetypeArtifactId=maven-archetype-webapp

 

生成 Eclipse 项目

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

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

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

 

 

 

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\
-DarchetypeArtifactId=maven-archetype-archetype

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

       修改其中内容

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

       安装此项目 ： mvn install

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

mvn archetype:create -DgroupId=com.mergere.mvnbook \
-DartifactId=proficio-example\
-DarchetypeGroupId=com.xxx.mvn\
-DarchetypeArtifactId= prof-archetype \
-DarchetypeVersion=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 加入说明就可以了

Xml代码
<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
解决办法 ：(临时)在控制面板中将区域与语言选项中，把当地语言设为英语
（为什么我还会出现这个问题？请指教）