Maven

maven的学习

基本内容

pom包括了所有的项目信息：

• groupid：项目或者组织的唯一标志，并且配置时生产的路径也是由此生成，如org.codehaus.mojo生成的相对路径为：/org/codehaus/mojo
• artifactid:项目的通用名称
• version:项目的版本
• packageing:打包的机制,如pom,jar,maven-plugin,ejb,war,ear,rar,par
• classifier:分类

pom关系：

主要为依赖、继承、合成

xml代码：

<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.0</version>
<type>jar</type>
<scope>test</scope>
<optional>true</optional>
</dependency>
...
</dependencies>


• groupid,artifactid,version:描述了依赖的项目唯一标志
• type:相应的依赖产品包形式，如jar，war
• scope:用于限制相应的依赖范围：
  
  1. compile:编译
  2. provided:类似于编译，但支持你期待jdk或者容器提供，类似于classpath
  3. runtime:在执行时，需要使用
  4. test:用于test任务时使用
  5. system:需要外在提供相应得元素。通过systempath来取得
• systemPath:仅用于方位为system。提供相应的路径
• optional:标注可选，当项目自身也是依赖时。用于连续依赖时使用

独占性

外在告诉maven你只包括制定的项目，不包括相关的依赖。此因素主要用于解决版本冲突问题
xml

<dependencies>
<dependency>
<groupId>org.apache.maven</groupId>
<artifactId>maven-embedder</artifactId>
<version>2.0</version>
<exclusions>
<exclusion>
<groupId>org.apache.maven</groupId>
<artifactId>maven-core</artifactId>
</exclusion>
</exclusions>
</dependency>

继承关系

另一个强大的变化，maven带来的是项目继承。主要的设置：
定义父项目
xml代码：

<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.codehaus.mojo</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
<packaging>pom</packaging>
</project>

packaging类型，需要pom用于parent和合成多个项目。我们需要增加相应的值给父pom，用于子项目继承。主要的元素如下：

• 依赖型
• 开发者和合作者
• 插件列表
• 报表列表
• 插件执行使用相应的匹配ids
• 插件配置

• 子项目配置

  xml代码:
  
<project>
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.codehaus.mojo</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
<relativePath>../my-parent</relativePath>
</parent>
<artifactId>my-project</artifactId>
</project>


dependencyManagement

用于父项目配置共同的依赖关系，主要配置依赖包相同因素，如版本，scope。

合成（或者多个模块）

一个项目有多个模块，也叫多重，或者合成项目

<project>
<modelVersion>4.0.0</modelVersion>
<groupId>org.codehaus.mojo</groupId>
<artifactId>my-parent</artifactId>
<version>2.0</version>
<modules>
<module>my-project1</module>
<module>my-project2</module>
</modules>
</project>


build设置

主要用于编译设置,包括两个主要的元素，build和report

build

主要分为两部分，基本元素和扩展元素集合
注意：包括项目build和profile build

<project>
<build>...</build>
<profiles>
<profile>
<build>...</build>
</profile>
</profiles>
</project>


基本元素

<build>
<defaultGoal>install</defaultGoal>
<directory>${basedir}/target</directory>
<finalName>${artifactId}-${version}</finalName>
<filters>
<filter>filters/filter1.properties</filter>
</filters>
...
</build>


• defaultGoal:定义默认的目标或者阶段。如install
• directory:编译输出的目录
• finalName：生成最后的文件的形式
• filter：定义过滤，用于替换相应的属性文件，使用maven定义的属性。设置所有placehold的值。大概的意思，就是读哪个配置文件，从里面读取这个文件的配置信息。具体可以参考url：http://blog.csdn.net/q979076061/article/details/74178186

资源

你项目中需要指定的资源。如spring配置文件，log4j.properties

<project>
<build>
...
<resources>
<resource>
<targetPath>META-INF/plexu</stargetPath>
<filtering>false</filtering>
<directory>${basedir}/src/main/plexus</directory>
<includes>
<include>configuration.xml</include>
</includes>
<excludes>
<exclude>**/*.propertiesexclude
</excludes>
</resource>
</resources>
<testResources>
...
</testResources>
...
</build>
</project>


• resources:resource的列表，用于包括所有的资源
• targetPath:指定目标路径，用于放置资源，用于build
• filtering：是否替换资源中的属性placehold
• directory:资源所在的位置
• includes：样式，包括哪些资源
• excludes：排除的资源
• testResource：测试资源列表

插件

在build时，执行的插件，比较有用的部分，如使用jdk5.0编译等等

<project>
<build>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.0</version>
<extensions>false</extensions>
<inherited>true</inherited>
<configuration>
<classifier>test</classifier>
</configuration>
<dependencies>...</dependencies>
<executions>...</executions>
</plugin>
</plugins>
</build>
</project>


• extensions：true or false，是否装载插件扩展。默认是false
• inherited：true or false，是否此插件配置将会应用于poms，那些继承与此的项目
• configuration：指定插件配置
• dependencies：插件需要依赖的包
• executions：用于配置execution目标，一个插件可以有多个目标

<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<id>echodir</id>
<goals>
<goal>rungoal>
</goals>
<phase>verifyphase>
<inherited>falseinherited>
<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>


• id：规定execution的唯一标志
• goals：表示目标
• phase：表示阶段，目标将会在什么阶段执行
• inherited：和上面的元素一样，设置false maven将会季节执行继承给子插件
• configuration：表示此执行的配置属性

插件管理

pluginManagement：插件管理以听呀的方式包括插件元素，用于在特定的项目中配置。所有继承与此项目的子项目都能使用。主要定义插件的共同元素

扩展元素集合

主要包括以下的元素

directories

用于设置各种目录结构，如下

<build>
<sourceDirectory>${basedir}/src/main/java</sourceDirectory>
<scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>
<testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
<outputDirectory>${basedir}/target/classes</outputDirectory>
<testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
...
</build>


extensions

表示需要扩展的插件，必须包括进相应的build路径

<project>
<build>
...
<extensions>
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ftp</artifactId>
<version>1.0-alpha-3</version>
</extension>
</extensions>
...
</build>
</project>


reporting

用于在stie阶段输出报表。特定的maven插件能输出相应的定制和配置报表

<reporting>
<plugins>
<plugin>
<outputDirectory>${basedir}/target/site</outputDirectory>
<artifactId>maven-project-info-reports-plugin</artifactId>
<reportSets>
<reportSet></reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>


report sets

用于配置不同的目标，应用于不同的报表

<reporting>
<plugins>
<plugin>
...
<reportSets>
<reportSet>
<id>sunlinkid>
<reports>
<report>javadoc</report>
<reports>
<inherited>true</inherited>
<configuration>
<links>
<link>http://java.sun.com/j2se/1.5.0/docs/api/</link>
</links>
</configuration>
</reportSet>
</reportSets>
</plugin>
</plugins>
</reporting>


实例：