Maven 使用点滴

项目坐标：

<groupId>com.alibaba</groupId>
<artifactId>dubbo-parent</artifactId>
<version>2.5.4-SNAPSHOT</version>
<packaging>jar</packaging>

项目的打包格式也是Maven坐标的重要组成部分，但是它不是项目唯一标识符的一个部
分。一个项目的groupId:artifactId:version使之成为一个独一无二的项目；你不能同
时有一个拥有同样的groupId, artifactId和version标识的项目。

项目依赖：

<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.apache.geronimo.specs</groupId>
<artifactId>geronimo-servlet_2.4_spec</artifactId>
<version>1.0</version>
<scope>provided</scope>
</dependency>
</dependencies>

依赖范围三种：compile，test，和provided

compile（编译范围）：compile是默认的范围；如果没有提供一个范围，那该依赖的范围就是编译范围。编译范围依赖在所有的classpath中可用，同时它们也会被打包。

test（测试范围）：test范围依赖 在一般的 编译和运行时都不需要，它们只有在测试编译和测试运行阶段可用。

provided（已提供范围）：provided依赖只有在当JDK或者一个容器已提供该依赖之后才使用。已提供范围的依赖在编译classpath（不是运行时）可用。它们不是传递性的，也不会被打包。

排除并替换一个传递性依赖：

<dependencies>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate</artifactId>
<version>3.2.5.ga</version>
<exclusions>
<exclusion>
<groupId>javax.transaction</groupId>
<artifactId>jta</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.geronimo.specs</groupId>
<artifactId>geronimo-jta_1.1_spec</artifactId>
<version>1.1</version>
</dependency>
</dependencies>


【编译插件】

<build>
//默认测试源码目录和测试编译输出目录的位置，默认不用设置
<testSourceDirectory>src/test/java</testSourceDirectory>
<testOutputDirectory>target/test-classes</testOutputDirectory>
//默认源码目录和编译输出目录的位置，默认不用设置
<sourceDirectory>src/main/java</sourceDirectory>
<outputDirectory>target/classes</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.5</source>
<target>1.5</target>
<encoding>UTF-8</encoding>
<compilerVersion>1.5</compilerVersion>
<verbose>true</verbose>
</configuration>
</plugin>
</plugins>
</build>

Java源代码遵循Java 1.5，目标为Java 1.5 JVM

【忽略单元测试失败】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<testFailureIgnore>true</testFailureIgnore>
</configuration>
</plugin>
</plugins>
</build>

插件参数表达式：

mvn test -Dmaven.test.failure.ignore=true


【跳过单元测试】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<skip>true</skip>
</configuration>
</plugin>
</plugins>
</build>

插件参数表达式：

mvn install -Dmaven.test.skip=true

【打包war项目】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.1.1</version>
<configuration>
<webResources>
<resource>
<directory>src/main/webapp</directory>
<excludes>
<exclude>**/*.jpg</exclude>
</excludes>
</resource>
</webResources>
</configuration>
</plugin>
</plugins>
</build>

【生成可执行jar】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>1.4</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<mainClass>com.hainiubl.App</mainClass>
</transformer>
</transformers>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>

可以让用户配置Main-Class的值，然后在打包的时候将值填入/META-INF/MANIFEST.MF文件。关于项目的依赖，它将依赖JAR文件全部解压后，再将得到的.class文件连同当前项目.class文件一起合并到最终的jar包。 可以通过java -jar app.jar 直接执行jar包

【制作项目分发包】

<build>
<plugins>
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<configuration>
<appendAssemblyId>false</appendAssemblyId>
<descriptors>
<descriptor>src/main/assemble/assembly.xml</descriptor>
</descriptors>
</configuration>
<executions>
<execution>
<id>make-assembly</id>
<phase>package</phase>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

assembly.xml 文件：

<assembly 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/assembly-1.0.0.xsd">
<id>package</id>
<formats>
<format>zip</format>
</formats>
<includeBaseDirectory>true</includeBaseDirectory>
<fileSets>
<fileSet>
<directory>src/main/bin</directory>
<outputDirectory>/</outputDirectory>
</fileSet>
<fileSet>
<directory>src/main/conf</directory>
<outputDirectory>conf</outputDirectory>
</fileSet>
</fileSets>
<dependencySets>
<dependencySet>
<outputDirectory>lib</outputDirectory>
<scope>runtime</scope>
</dependencySet>
</dependencySets>
</assembly>

该分发包可能包含了项目的可执行文件、源代码、readme、平台脚本等等。支持各种主流的格式如zip、tar.gz、jar和war等，具体打包哪些文件是高度可控的。
使用一个名为assembly.xml的元数据文件来表述打包，它的single目标可以直接在命令行调用，也可以被绑定至生命周期。

【运行任何本地的系统程序】

<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>exec-maven-plugin</artifactId>
<version>1.2.1</version>
<executions>
<execution>
<goals>
<goal>java</goal>
</goals>
</execution>
</executions>
<configuration>
<mainClass>com.hainiubl.App</mainClass>
</configuration>
</plugin>
</plugins>
</build>

它能让你运行任何本地的系统程序，就是使用 mvn exec:exec。除了exec目标之外，exec-maven-plugin还提供了一个java目标，该目标要求你提供一个mainClass参数，然后它能够利用当前项目的依赖作为classpath，在同一个JVM中运行该mainClass。你可以在POM中配置好exec-maven-plugin的相关运行参数，然后直接在命令运行 mvn exec:java 以查看运行效果。

【生成javadoc】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.7</version>
<executions>
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

【生成项目源码包】

<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.1.2</version>
<executions>
<execution>
<id>attach-sources</id>
<phase>verify</phase>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>


Maven默认生命周期阶段：

1.validate ：验证项目是否正确，以及所有为了完整构建必要的信息是否可用
2.generate-sources ：生成所有需要包含在编译过程中的源代码
3.process-sources ：处理源代码，比如过滤一些值
4.generate-resources ：生成所有需要包含在打包过程中的资源文件
5.process-resources ：复制并处理资源文件至目标目录，准备打包
6.compile ：编译项目的源代码
7.process-classes ：后处理编译生成的文件，例如对Java类进行字节码增强
8.generate-test-sources ：生成所有包含在测试编译过程中的测试源码
9.process-test-sources ：处理测试源码，比如过滤一些值
10.generate-test-resources ：生成测试需要的资源文件
11.process-test-resources ：复制并处理测试资源文件至测试目标目录
12.test-compile ：编译测试源码至测试目标目录
13.test ：使用合适的单元测试框架运行测试。这些测试应该不需要代码被打包或发布
14.prepare-package ：在真正的打包之前，执行一些准备打包必要的操作。这通常会产生一个包的展开的处理过的版本
15.package ：将编译好的代码打包成可分发的格式，如JAR，WAR，或者EAR
16.pre-integration-test ：执行一些在集成测试运行之前需要的动作。如建立集成测试需要的环境
17.integration-test ：如果有必要的话，处理包并发布至集成测试可以运行的环境
18.post-integration-test ：执行一些在集成测试运行之后需要的动作。如清理集成测试环境。
19.verify ：执行所有检查，验证包是有效的，符合质量规范
20.install 安装包至本地仓库，以备本地的其它项目作为依赖使用
21.deploy 复制最终的包至远程仓库，共享给其它开发人员和项目


打包类型相关生命周期：

1.JAR打包类型：JAR是默认的打包类型

生命周期阶段 目标
process-resources resources:resources
compile compiler:compile
process-test-resources resources:testResources
test-compile compiler:testCompile
test surefire:test
package jar:jar
install install:install
deploy deploy:deploy

2.POM打包类型：

生命周期阶段 目标
package site:attach-descriptor
install install:install
deploy deploy:deploy

3.WAR打包类型：

生命周期阶段 目标
process-resources resources:resources
compile compiler:compile
process-test-resources resources:testResources
test-compile compiler:testCompile
test surefire:test
package war:war
install install:install
deploy deploy:deploy

4.EAR打包类型：

生命周期阶段 目标
generate-resources ear:generate-application-xml
process-resources resources:resources
package ear:ear
install install:install
deploy deploy:deploy


[b]Maven属性[/b]

事实上有六种类型的Maven属性：

•1.内置属性：主要有两个常用内置属性——${basedir}表示项目根目录，即包含pom.xml文件的目录;${version}表示项目版本。

•2.POM属性：pom中对应元素的值。例如${project.artifactId}对应了<project><artifactId>元素的值，常用的POM属性包括：

${project.build.sourceDirectory}:项目的主源码目录，默认为src/main/java/.
${project.build.testSourceDirectory}:项目的测试源码目录，默认为/src/test/java/.
${project.build.directory}:项目构建输出目录，默认为target/.
${project.build.outputDirectory}:项目主代码编译输出目录，默认为target/classes/.
${project.build.testOutputDirectory}:项目测试代码编译输出目录，默认为target/testclasses/.
${project.groupId}:项目的groupId.
${project.artifactId}:项目的artifactId.
${project.version}:项目的version,于${version}等价
${project.build.finalName}:项目打包输出文件的名称，默认为
${project.artifactId}${project.version}.


•3.自定义属性：在pom中<properties>元素下自定义的Maven属性。例如

• <project>
• <properties>
• <my.prop>hello</my.prop>
• </properties>
• </project>


•4.Settings属性：与POM属性同理。如${settings.localRepository}指向用户本地仓库的地址。

•5.Java系统属性：所有Java系统属性都可以使用Maven属性引用，例如${user.home}指向了用户目录。可以通过命令行mvn help:system查看所有的Java系统属性

•6.环境变量属性：所有环境变量都可以使用以env.开头的Maven属性引用。例如${env.JAVA_HOME}指代了JAVA_HOME环境变量的值。也可以通过命令行mvn help:system查看所有环境变量。


[b]资源过滤[/b]

默认情况下，Maven属性只有在POM中才会被解析。资源过滤就是指让Maven属性在资源文件(src/main/resources、src/test/resources)中也能被解析。

在POM中添加下面的配置便可以开启资源过滤


• <build>
• <resources>
• <resource>
• <directory>${project.basedir}/src/main/resources</directory>
• <filtering>true</filtering>
• </resource>
• </resources>
• <testResources>
• <testResource>
• <directory>${project.basedir}/src/test/resources</directory>
• <filtering>true</filtering>
• </testResource>
• </testResources>
• </build>


从上面的配置中可以看出，我们其实可以配置多个主资源目录和多个测试资源目录。


Maven除了可以对主资源目录、测试资源目录过滤外，还能对Web项目的资源目录(如css、js目录)进行过滤。这时需要对maven-war-plugin插件进行配置


• <plugin>
• <groupId>org.apache.maven.plugins</groupId>
• <artifactId>maven-war-plugin</artifactId>
• <version>2.1-beta-1</version>
• <configuration>
• <webResources>
• <resource>
• <filtering>true</filtering>
• <directory>src/main/webapp</directory>
• <includes>
• <include>**/*.css</include>
• <include>**/*.js</include>
• </includes>
• </resource>
• </webResources>
• </configuration>
• </plugin>