神马文学网Maven Weed
来源：百度文库 编辑：神马文学网 时间：2024/04/30 21:42:39
Maven Weed
学习、使用Maven的过程中，亲身遇到或看到的一些问题的解决方法。Maven有不少Bug，大家使用时一定要小心。(2007.02.10最后更新)
向本地仓库安装文件
mvn install:install-file -Dfile= -DgroupId= -DartifactId= -Dversion= -Dpackaging= -DgeneratePom=true -DcreateChecksum=true(需要使用maven-install-plugin 2.2-SNAPSHOT)
打包时，不在META-INF中生成maven目录
使用Maven打包(mvn package)时，默认地会在META-INF中生成一个目录maven，里面是一个pom和一个属性文件。如果不想生成这个目录，需要在POM中进行如下配置：
以对于一般应用程序打包，即制作jar包为例
org.apache.maven.plugins
maven-jar-plugin
false
如果你在打jar包（mvn package）时，报如下错误：
[INFO] Failed to configure plugin parameters for: org.apache.maven.plugins:maven-jar-plugin:2.0
Cause: Cannot find setter nor field in org.apache.maven.archiver.MavenArchiveConfiguration for ‘addMavenDescriptor‘ 这是由于maven-jar-plugin的版本不够高（很可能是2.0版本），需要升级到最新的2.1版本。运行命令mvn -U package，会先下载最新版本，再执行打包操作。
类似的，对于制作war，ear包，只需要将artifactId换成对应的plugin（ maven-war-plugin ， maven-ear-plugin ）就可以了。
Javadoc中文乱码
中文操作系统中，JDK1.5.0的Javadoc自动默认支持中文，而且页面中的条目名也都默认为中文显示（在之前的JDK中，这些条目名都默认为英文）。 如是在这种情况下使用命令mvn javadoc:javadoc生成Javadoc，则这些条目名将成为乱码。
解决方法：让javadoc插件使用UTF16或Unicode字符集。具体配置的形式如下：
org.apache.maven.plugins
maven-javadoc-plugin
UTF16
Scope
Scope表示了某个依赖关系的适用范围(作用域)，共有5个scope。
compile: 默认的适用范围，表示该依赖关系要应用于所有的classpath。
provided: 该适用范围非常像compile适用范围。但它表示该依赖关系已经由JDK或某个容量提供，如javax.servlet。
runtime：表示该依赖关系不用于编译阶段，而只使用于运行时阶段，如apache jakarta commons。
test：表示该依赖关系并不用于实际的应用程序本身，而是该应用的测试程序的编译与运行，如junit。
system：该依赖关系类似于provided，但必须显示地表示是哪一个容器提供了这个artifact。无法在仓库中找到该artifact。
注意：
[1]具有compile或runtime适用范围的依赖关系中的jar文件，制作war文件时将会被放入WEB-INF/lib目录中。
[2]不推荐使用system适用范围。
将mvn.bat配置为Eclipse外部工具
为了能够在Eclipse环境中运行mvn.bat，需要将它配置为一个外部工具(external tool)。在我的Eclipse Weed(配置外部工具)一文中已经提到了如何配置Eclipse External Tools(可先参见该文)。本主题将具体讲述如何将mvn.bat的package Build周期短语配置为外部工具。
[1]主菜单Run-->External Tools-->External Tools...
[2]先选中Program项，再点击左上角的New launch configuration按钮
[3]Name文本框中输入该外部工具的名称“MvnPackage”
[4]通过Browser File System...按钮，向Location文本框中输入mvn.bat文件的绝对路径
[5]通过Variables...按钮，选择project_loc，将向Working Directory文本框中输入${project_loc}
[6]在Augments文本域中输入package
这样当你选中一个pom.xml文件后，再运行该外部工具，就相当于对该POM文件文件执行mvn package命令。
制作war文件时，过滤文件
使用maven-war-plugin制作war文件时，它会先将所有可能用于制作war的内容放入target/artifactId-version目录(标准目录结构)下，然后再将这些文件进行打包。这样就有两种方法进行文件过滤：[1]使期望被过滤的文件一开始就不被放入 target/artifactId-version目录，即使它成为不可能的文件；[2]在制作war文件时，不将期望被过滤的文件加入包中。
[1]实现第一种方法，要对dependency进行配置。将不希望加入包的artifact放入exclusion参数中，如下脚本所示：
commons-configuration
commons-configuration
dom4j
dom4j
org.apache.maven.plugins
maven-war-plugin
2.0.1
WEB-INF/lib/dom4j-1.4.jar
当加载插件时抛NullPointerException
如果仓库中有某个插件的jar文件有问题，则会抛出这样的异常。遇到这样的问题时，必须将这个有问题的插件清除。
可以在执行参数中加上-X(如mvn -X compile)来获得加载插件的过程，从中可能会发现问题插件。如果还不行，则使用一个新的仓库，再次执行工程。
Install或Deploy源代码
true
org.apache.maven.plugins
Maven Weed
Maven Weed
Maven POM
Maven简介
Maven起步
关于Maven
Maven 2.0
Maven概述
Maven起步-教你开始使用Maven
maven入门介绍
Maven项目简介信息
Maven插件使用收集
maven 之pom.xml
[Maven 2] Repositories
Maven快速入门
项目管理工具: Maven
maven、nexus、m2eclipse
学习maven的使用
Maven学习笔记1
安装maven到Eclipse
maven 之pom.xml
Maven起步-教你开始使用Maven（复制）
Better Builds With Maven 学习笔记(使用Maven创建应用 )
我的Maven之旅(1)-为什么使用maven
学习、使用Maven的过程中，亲身遇到或看到的一些问题的解决方法。Maven有不少Bug，大家使用时一定要小心。(2007.02.10最后更新)
向本地仓库安装文件
mvn install:install-file -Dfile=
打包时，不在META-INF中生成maven目录
使用Maven打包(mvn package)时，默认地会在META-INF中生成一个目录maven，里面是一个pom和一个属性文件。如果不想生成这个目录，需要在POM中进行如下配置：
以对于一般应用程序打包，即制作jar包为例
如果你在打jar包（mvn package）时，报如下错误：
[INFO] Failed to configure plugin parameters for: org.apache.maven.plugins:maven-jar-plugin:2.0
Cause: Cannot find setter nor field in org.apache.maven.archiver.MavenArchiveConfiguration for ‘addMavenDescriptor‘ 这是由于maven-jar-plugin的版本不够高（很可能是2.0版本），需要升级到最新的2.1版本。运行命令mvn -U package，会先下载最新版本，再执行打包操作。
类似的，对于制作war，ear包，只需要将artifactId换成对应的plugin（ maven-war-plugin ， maven-ear-plugin ）就可以了。
Javadoc中文乱码
中文操作系统中，JDK1.5.0的Javadoc自动默认支持中文，而且页面中的条目名也都默认为中文显示（在之前的JDK中，这些条目名都默认为英文）。 如是在这种情况下使用命令mvn javadoc:javadoc生成Javadoc，则这些条目名将成为乱码。
解决方法：让javadoc插件使用UTF16或Unicode字符集。具体配置的形式如下：
Scope
Scope表示了某个依赖关系的适用范围(作用域)，共有5个scope。
compile: 默认的适用范围，表示该依赖关系要应用于所有的classpath。
provided: 该适用范围非常像compile适用范围。但它表示该依赖关系已经由JDK或某个容量提供，如javax.servlet。
runtime：表示该依赖关系不用于编译阶段，而只使用于运行时阶段，如apache jakarta commons。
test：表示该依赖关系并不用于实际的应用程序本身，而是该应用的测试程序的编译与运行，如junit。
system：该依赖关系类似于provided，但必须显示地表示是哪一个容器提供了这个artifact。无法在仓库中找到该artifact。
注意：
[1]具有compile或runtime适用范围的依赖关系中的jar文件，制作war文件时将会被放入WEB-INF/lib目录中。
[2]不推荐使用system适用范围。
将mvn.bat配置为Eclipse外部工具
为了能够在Eclipse环境中运行mvn.bat，需要将它配置为一个外部工具(external tool)。在我的Eclipse Weed(配置外部工具)一文中已经提到了如何配置Eclipse External Tools(可先参见该文)。本主题将具体讲述如何将mvn.bat的package Build周期短语配置为外部工具。
[1]主菜单Run-->External Tools-->External Tools...
[2]先选中Program项，再点击左上角的New launch configuration按钮
[3]Name文本框中输入该外部工具的名称“MvnPackage”
[4]通过Browser File System...按钮，向Location文本框中输入mvn.bat文件的绝对路径
[5]通过Variables...按钮，选择project_loc，将向Working Directory文本框中输入${project_loc}
[6]在Augments文本域中输入package
这样当你选中一个pom.xml文件后，再运行该外部工具，就相当于对该POM文件文件执行mvn package命令。
制作war文件时，过滤文件
使用maven-war-plugin制作war文件时，它会先将所有可能用于制作war的内容放入target/artifactId-version目录(标准目录结构)下，然后再将这些文件进行打包。这样就有两种方法进行文件过滤：[1]使期望被过滤的文件一开始就不被放入 target/artifactId-version目录，即使它成为不可能的文件；[2]在制作war文件时，不将期望被过滤的文件加入包中。
[1]实现第一种方法，要对dependency进行配置。将不希望加入包的artifact放入exclusion参数中，如下脚本所示：
当加载插件时抛NullPointerException
如果仓库中有某个插件的jar文件有问题，则会抛出这样的异常。遇到这样的问题时，必须将这个有问题的插件清除。
可以在执行参数中加上-X(如mvn -X compile)来获得加载插件的过程，从中可能会发现问题插件。如果还不行，则使用一个新的仓库，再次执行工程。
Install或Deploy源代码