maven问题整理

refer: http://www.jdonee.com/category/%E6%8A%80%E6%9C%AF%E4%B8%93%E6%A0%8F
/maven/maven%E9%97%AE%E7%AD%94%E6%94%B6%E9%9B%86/

Maven常见问题解答(三)
2010 年 11 月 06 日, 上午 12:44
1、为什么我在私服中存在的某个版本的依赖，而Eclipse项目中引用该依赖不成功，报”miss ***.jar”错误？

在当前工程目录下运行”mvn eclipse:eclipse”，然后在Eclipse下刷新该工程。



2、引用某个过时的Java API导致Maven出现ERROR警告导致编译失败，该怎么处理？

1)升级Java compiler插件的版本至2.3.2及以后。

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
</plugin>

2)当然是修改你的API方法。



3、如何导出当前项目依赖的源码jar?

在当前项目下运行：

mvn dependency:copy-dependencies -Dclassifier=sources

默认会在${project.build.directory}/dependency里(一般是target目录下)。如果你要改变它的地址，就添加outputDirectory参数。比如要存放在d:dependency目录下，命令如下：

mvn dependency:copy-dependencies -Dclassifier=sources -DoutputDirectory=d:dependency

注：很有可能有些jar包没有提供源代码，导致你构建失败。那么你这种情况你可以通过excludeArtifactIds参数排除这些jar，多个jar直接用”,”分隔，命令如下：

mvn dependency:copy-dependencies -Dclassifier=sources -DexcludeArtifactIds=bcprov-jdk15,junit,……

关于dependency更多使用方式，请参阅Maven Dependency Plugin。



4、如何下载当前项目依赖的源码jar?

1)在当前项目下运行：

mvn dependency:sources

默认会安装在本地仓库。

2)如果你是在Eclipse环境下使用，通过“preferences”进入，点击“Maven”，勾选“Download Artifact Sources”。重启eclipse，构建工程时，就会下载依赖的源码jar。

原创文章，转载请注明： 转载自爱飞年代

本文链接地址: Maven常见问题解答(三)

文章的脚注信息由WordPress的wp-posturl插件自动生成

Popularity: 70% [?]

Category: Maven, Maven问答收集, 技术专栏 | 评论
Maven常见问题解答(二)
2010 年 11 月 05 日, 下午 8:33
1、POM的资源可继承吗？

当然可以，但只有在子POM没有任何资源的情况下。如果有，子POM只会应用当前的资源，并会覆盖父POM传递下来的相同资源。



2、Maven的继承顺序是怎样的？

1)parent pom

2)project pom

3)settings

4)命令行参数

其中后面的会覆盖前面的。



3、我在哪里可以获得Maven的Eclipse插件？

http://maven.apache.org/eclipse-plugin.html

这里还提供了一些关于如何使用该插件的Flash演示。



4、我该如何使用1.4.x的或1.5.x的JDK编译1.3的Java源代码？

您需要指定<compilerVersion>元素为1.3。

<project>

…

<build>

<plugins>

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-compiler-plugin</artifactId>

<configuration>

<verbose>true</verbose>

<fork>true</fork>

<executable><!– path-to-javac –></executable>

<compilerVersion>1.3</compilerVersion>

</configuration>

</plugin>

</plugins>

</build>

…

</project>

5、如何在我的pom文件中引用windows 或者unix 环境变量？

从Maven 2.0.1开始，你可以在你的pom.xml或者settings.xml文件使用如下表达式引用windows 和unix 环境变量。

${env.VARNAME}

所以，你想要引用你的主目录环境变量，可以使用：

${env.HOME}



6、如何使子项目不继承父项目的目标(如install)?

使用inherited 属性，设置插件的配置为false。举例来说，如果你想安装父项目，而不想安装子项目。你可以在当前项目的install插件中进行如下配置：

<plugin>
<artifactId>maven-install-plugin</artifactId>
<configuration>
<inherited>false</inherited>
</configuration>
</plugin>


7、如何指定当前WAR模块继承父项目组WAR模块下的公共文件?

从maven-war-plugin 2.0-beta-3及以后的版块开始支持合并war。你只要在你的war模块中添加另一个类型为WAR的依赖，它们就会自动完成合并。

如果你想要获得更具体的操作，请查阅使用Maven WAR插件实现多Web应用间的重迭运用。



8、怎么在Maven2里配置相当于war插件的maven.war.src的目录结构？

<build>
…
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<configuration>
<warSourceDirectory><!– 目录地址–></warSourceDirectory>
</configuration>
</plugin>
</plugins>
…
</build>
查看war插件的可配置属性可获得更多信息。



9、如何指定Eclipse插件生成的输出目录放入到.classpath文件里？

<build>
...
<pluginManagement>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-eclipse-plugin</artifactId>
<configuration>
<outputDirectory>target-eclipse</outputDirectory>
</configuration>
</plugin>
</plugins>
</pluginManagement>
...
</build>


10、如何为一个可执行jar添加主运行类？

配置maven-jar-plugin，然后添加主类：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<configuration>
<archive>
<manifest>
<mainClass>com.mycompany.app.App</mainClass>
</manifest>
</archive>
</configuration>
</plugin>


11、我能禁止使用传递依赖吗？

很抱歉，不能，不过你可以在项目里排除相关的依赖。

下面是一个关于排除依赖的示例：

<project>
…
<dependency>
<groupId><!– group id –></groupId>
<artifactId><!– artifact id –></artifactId>
<version><!– version –></version>
<scope><!– scope –></scope>
<exclusions>
<exclusion><!–排除的依赖都写着这里–>
<groupId><!– groupId –></groupId>
<artifactId><!– artifactId–></artifactId>
</exclusion>
</exclusions>
</dependency>
</project>


12、Maven中有没有方法在每次构建时不通过编辑pom或者配置文件就能够指定不同的输出目录吗？

当然有，你可以通过配置<properties>来完成这项工作。

要做到这一点，你只需在pom文件添加以下片段：

<project>
...
<build>
<directory>${directory}</directory>
<outputDirectory>${directory}/classes</outputDirectory>
<testOutputDirectory>${directory}/test-classes</testOutputDirectory>
</build>
<properties>
<directory>target</directory> <!-- 设置默认 -->
</properties>
...
</project>
现在你可以在命令行使用directory属性作为一个命令行参数来为它在运行时指定一个输出目录：

mvn -Ddirectory=tmp package

这样，${basedir}/tmp文件夹将作为新的输出目录。



13、我web项目中的自定义目录布局中有了一个web.xm文件，但是为什么我还是获得“Deployment descriptor <Path>WEB-INFweb.xml does not exist”错误呢？

你可以通过maven-war-plugin在你的Web应用中指定你web.xml文件的路径。

<build>
…
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<configuration>
<webXml><!– web.xml的路径 –></webXml>
</configuration>
</plugin>
</plugins>
</build>


14、我该如何在打包的Jar中过滤某些文件呢?

所有编译过的class文件总会放入打包的jar中。但是，你能配置通过使用compiler 插件的excludes 参数排除一些无须打包的文件。

<project>
…
<build>
…
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<excludes>
<exclude>**/NotNeeded*.java</exclude>
</excludes>
</configuration>
</plugin>
</plugins>
…
</build>
</project>



15、如何在deploy阶段期间部署我的二进制文件？

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<executions>
<execution>
<phase>install</phase>
<goals>
<goal>assembly</goal>
</goals>
<configuration>
<!– 这里输入你的配置 –>
</configuration>
</execution>
</executions>
</plugin>
然后执行”mvn deploy” 。



16、如何在surefire插件增加一个配置来阻止测试过程运行多次？

可以在插件的executions元素外声明如下配置：

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.0</version>
<configuration>
<systemProperties>
<property>
<name>net.sourceforge.cobertura.datafile</name>
<value>C:cobertura.ser</value>
</property>
</systemProperties>
</configuration>
</plugin>


17、如何使用不同的配置文件来执行assembly插件？

你可以在pom.xml文件里增加如下配置：

<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<executions>
<execution>
<id>1</id>
<phase>install</phase>
<goals>
<goal>assembly</goal>
</goals>
<configuration>
<descriptor>src/main/descriptors/bin.xml</descriptor>
<finalName>${project.build.finalName}-bin</finalName>
</configuration>
</execution>
<execution>
<id>2</id>
<phase>install</phase>
<goals>
<goal>assembly</goal>
</goals>
<configuration>
<descriptor>src/main/descriptors/src.xml</descriptor>
<finalName>${project.build.finalName}-src</finalName>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
...
</build>
然后执行mvn install，它将通过不同的配置执行assembly插件两次。



18、如何使用antrun插件生成源代码？

下面是你要在该插件的选项中生成源代码的步骤。注意：很有可能只有最新的SVN插件版本才支持。

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-antrun-plugin</artifactId>
<dependencies>
<!– 你脚本执行必须的依赖 –>
</dependencies>
<executions>
<execution>
<id>generate-sources</id>
<phase>generate-sources</phase>
<configuration>
<tasks>
<!– 这里嵌入你的ant任务，也可以委托给一个build.xml–>
<path id=”classpath”>
<path refid=”maven.compile.classpath”/>
<path refid=”maven.plugin.classpath”/>
</path>
<ant antfile=”${basedir}/build.xml” dir=”${basedir}” inheritRefs=”true”>
<target name=”generate-sources”/>
</ant>
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
</executions>
</plugin>
19、如何在Maven中针对多个阶段，执行ant 任务多次？

executions标签可以指定多个execution元素，ant的执行目标中可以针对不同的Maven阶段绑定不同的ID。

<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<id>one</id>
<phase>generate-sources</phase>
<configuration>
<tasks>
<echo message=” start generate-sources!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!”/>
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
<execution>
<id>two</id>
<phase>package</phase>
<configuration>
<tasks>
<echo message=” start packaging!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!”/>
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
</executions>
</plugin>
20、为什么我没有在我的项目站点里获得生成的index.html页面？

这个原因通常是配置maven-project-info-reports plugin时忽略了”index”报告。

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-project-info-reports-plugin</artifactId>
<reportSets>
<reportSet>
<reports>
<report>index</report> <!–这里–>
<report>dependencies</report>
<report>cim</report>
<report>scm-list</report>
<report>issue-tracking</report>
</reports>
</reportSet>
</reportSets>
</plugin>
21、如何把静态的X(HTML)文件整合到我生成的站点里？

通过如下步骤你就能达到目的：

1)把你的静态页面放入到资源目录下，${basedir}/src/site/resources。

2)创建你的site.xml,并放入到${basedir}/src/site。xml示例：

<project name="Maven War Plugin">
<bannerLeft>
<name>Maven War Plugin</name>
<src>http://maven.apache.org/images/apache-maven-project.png</src>
<href>http://maven.apache.org/</href>
</bannerLeft>
<bannerRight>
<src>http://maven.apache.org/images/maven-small.gif</src>
</bannerRight>
<body>
<links>
<item name="Maven 2" xhref="http://maven.apache.org/maven2/"/>
</links>
<menu name="Overview">
<item name="Introduction" xhref="introduction.html"/>
<item name="How to Use" xhref="howto.html"/>
</menu>
${reports}
</body>
</project>
3)修改”menu”来链接静态页面，然后通过静态页的名称来创建选项和站点地图。

<menu name="Overview">
<item name="Introduction" xhref="introduction.html"/>
<item name="How to Use" xhref="howto.html"/>
<item name="<put-name-here>" xhref="<filename-of-the-static-page>"/>
</menu>
22、怎样从一个mojo里获取一个插件的依赖？

public class MyMojo extends AbstractMojo
{
/**
* @parameter expression="${plugin.artifacts}"
* @required
*/
private List pluginArtifacts;
public void execute()
throws MojoExecutionException
{
...
for ( Iterator i = pluginArtifacts.iterator(); i.hasNext(); )
{
Artifact pluginArtifact = (Artifact) i.next();
}
...
}
}
23、怎样从一个Mojo里获取项目的来源？

public class MyMojo extends AbstractMojo
{
/**
* @parameter expression="${project.compileSourceRoots}"
* @required
*/
private List sourceRoots;

public void execute() throws MojoExecutionException
{
...
for ( Iterator i = sourceRoots.iterator(); i.hasNext(); )
{
String sourceRoot = (String) i.next();
// Do what you want with these directories
}
}
}
24、如何在我的mojo里创建一个命令行参数(如-Dname=value )?

你可以在你的mojo里的参数字段中输入”expression=${<exp>}” 。

/**
* @parameter expression="${expression.name}"
*/
private String exp;
你现在就可以在命令行里运行参数：

“mvn -Dexpression.name=value install”



原创文章，转载请注明： 转载自爱飞年代

本文链接地址: Maven常见问题解答(二)

文章的脚注信息由WordPress的wp-posturl插件自动生成

Popularity: 100% [?]

Category: Maven, Maven问答收集, 技术专栏 | 1 条评论
Maven常见问题解答(一)
2010 年 11 月 05 日, 下午 8:06
1、如何阻止编译时出现”[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!”这样的警告?

出现类似这样的情况很多，这是因为如果你没有为编译的文件指定编码格式的话，它一般就会引用系统本身的编码，解决的办法也很简单，你只要在pom.xml(或者父项目的pom.xml)下的设置如下属性：

通用设置：

<project>

…

<properties>

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

</properties>

…

</project>

M3设置：

<project>

…

<properties>

<sourceEncoding>UTF-8</sourceEncoding>

</properties>

…

</project>



2、如何阻止把某些JAR包添加到WEB-INF/lib文件夹下？因为我只是想在编译时使用它！

把依赖的范围级别定义为provided，这样可以避免运行时依赖冲突。

3、如何确定我使用的是哪个版本的插件？

你可以使用Maven Help 插件的describe目标。比如你要查看install插件的当前版本：

mvn -Dplugin=install help:describe

如果想要更详细的信息，增加-Ddetail。

mvn -Dplugin=install help:describe -Ddetail

注意：这里的参数是插件的目标前缀，而不是构件的ID。比如 Maven Install Plugin的构件ID是：maven-install-plugin，而前缀是install。

4、我如何在一次Maven构建中使用ant任务？

目前有两个选择。

1)按照 instructions given in the Ant documentation自己实现。

2)如果你只需要在你的Maven构建里使用少量的ant脚本，那么你可以使用AntRun插件。



5、那么我如何在一次Ant构建中使用Maven的特性呢？

Maven Ant Tasks可以让Ant构建使用Maven的很多特性，诸如依赖管理、仓库部署等等。



6、我如何在Maven编译代码时自定义JVM的源代码和输出格式呢？

你必须在pom.xml文件里设置source和target参数。比如你要设置JVM的源代码和输出格式为1.5,那么在pom文件里可以如下设置：

…

<build>

…

<plugins>

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-compiler-plugin</artifactId>

<version>2.0.2</version>

<configuration>

<source>1.5</source>

<target>1.5</target>

</configuration>

</plugin>

</plugins>

…

</build>

…



7、我是否可以在Maven中创建自己的目录结构呢？

当然可以。通过配置<sourceDirectory>，<resources>和<build>部分的其它元素。此外，如果你不使用默认的文件/目录格式的话，你还必须修改相关插件的配置。

坦白讲，这是一件得不偿失的事情。



8、我如何查找Maven的源代码呢？

源代码可以通过Maven版本库找到。

如果要查阅更多信息，请点击Building Maven 2.0。



9、为何我不能正确下载Maven的依赖？

你很有可能是因为公司网络的原因限制下载，不过你可以为Maven配置一个代理。具体的操作可以参阅配置代理。

10、我想把一个Jar存放到我的本地仓库，该怎么做？

如果你了解Maven的仓库布局，它会直接复制jar过去，Maven会在下一次运行时自动发现。

如果你不了解Maven的仓库布局，你可以在命令行中使用如下的命令加载Jar文件(此命令为一行，切莫回车)。

mvn install:install-file -Dfile=<path-to-file> -DgroupId=<group-id> -DartifactId=<artifact-id> -Dversion=<version> -Dpackaging=<packaging> -DgeneratePom=true

其中: <path-to-file> 需加载的文件路径

<group-id> 该文件的组ID

<artifact-id> 该文件的构件ID

<version> 该文件的版本

<packaging> 该 文件的打包格式，如jar



11、如何跳过测试？

你可以在命令行增加-Dmaven.test.skip=true或-DskipTests=true参数，前者会跳过测试的编译和执行，后者仅仅跳过测试的执行。更多示例请查阅Surefire插件的跳过测试部分。



12、如何在Maven中运行一个单元测试？

在命令行增加-Dtest=MyTest参数。注：不能指定包名，如(org.apache.x.y.MyTest)



13、如何处理站点的特殊字符？

首先配置你的IDE使用正确的编码。如果使用Eclipse,在eclipse.ini中增加 -Dfile.encoding=ISO-8859-1。

在你的pom文件中配置你的输出编码：

…

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-site-plugin</artifactId>

<version>2.0-beta-6</version>

<configuration>

<outputEncoding>UTF-8</outputEncoding>

</configuration>

</plugin>

…

然后在MAVEN_OPTS中增加跟IDE一样的编码格式，如MAVEN_OPTS=”-Dfile.encoding=ISO-8859-1″。本人不推荐直接修改Maven的BIN目录下的mvn文件，而是添加一个环境变量MAVEN_OPTS。



14、如何在我的依赖中添加tools.jar？

下面的代码可以把tools.jar包含在Windows, Linux 和 Solaris系统的JDKs中(Mac OS X和其它免费的JDKs中已经包含了)。

…

<profiles>

<profile>

<id>default-tools.jar</id>

<activation>

<property>

<name>java.vendor</name>

<value>Sun Microsystems Inc.</value>

</property>

</activation>

<dependencies>

<dependency>

<groupId>com.sun</groupId>

<artifactId>tools</artifactId>

<version>1.4.2</version>

<scope>system</scope>

<systemPath>${java.home}/../lib/tools.jar</systemPath>

</dependency>

</dependencies>

</profile>

</profiles>

…

15、Maven编译了我的测试类，但是为什么不运行呢？

测试一般都是由Surefire插件运行的。Surefire插件用来配置运行某些测试类，你很有可能无意中指定了${test}这样的值。检查你的settings.xml和pom.xml文件，看有没有命名为”test”的属性，如下列方式：

…

<properties>

<property>

<name>test</name>

<value>some-value</value>

</property>

</properties>

…

或者

…

<properties>

<test>some-value</test>

</properties>

…

16、Maven的SNAPSHOT(快照)构件存放在哪里？

如果你想要使用Maven或者插件的快照来进行构建，那么你应该要访问Maven快照仓库。

你可能需要通过快照仓库使用指南更新你的settings文件。



17、Maven 的XSD schemas存放在哪里？

Maven XSD 存放在这里，Maven Settings XSD 存放在这里。

你的IDE很有可能支持pom.xml和settings.xml的编辑。你很有可能需要指定以下内容：

<project xmlns=”http://maven.apache.org/POM/4.0.0″

xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=”http://maven.apache.org/POM/4.0.0

http://maven.apache.org/xsd/maven-4.0.0.xsd“>

…

</project>

<settings xmlns=”http://maven.apache.org/SETTINGS/1.0.0″

xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance”

xsi:schemaLocation=”http://maven.apache.org/SETTINGS/1.0.0

http://maven.apache.org/xsd/settings-1.0.0.xsd“>

…

</settings>



18、如果Maven不能正常工作，我该如何获取帮助？

Maven官方编制了一个可用帮助列表。



19、如何在Maven构建时产生调试或者错误信息呢？

你可以在Maven构建是调用-X(必须大写)或者-e参数。如果你要了解更多信息，在命令行执行：mvn –help



20、Mojo是什么？

Mojo是Maven中一个普通的持久化对象。每一个Mojo都是Maven中的一个执行目标，一个插件一般包含一个或者多个相关的Mojo。



21、怎样在公共Maven仓库中寻找依赖？

你可以使用下列搜索引擎：

http://repository.apache.org

http://www.artifact-repository.org

http://mvnrepository.com

http://www.mvnbrowser.com

http://www.jarvana.com

http://mavensearch.net