关于maven的pom文件配置问题

<project>
  <modelVersion>4.0.0</modelVersion>

<!--maven2.0必须是这样写，现在是maven2唯一支持的版本-->

 <!-- 基础设置-->

  <groupId>...</groupId> 项目或者组织的唯一标志，并且配置时生成路径也是由此生成，如org.myproject.mojo生成的相对路径为：/org/myproject/mojo

  <artifactId>...</artifactId>  项目的通用名称
  <version>...</version>  项目的版本
  <packaging>...</packaging> 打包机制，如pom,jar,maven-plugin,ejb,war,ear,rar,par

  <name>...</name>用户描述项目的名称，无关紧要的东西，可选

  <url>...</url>应该是只是写明开发团队的网站，无关紧要，可选

  <dependencies>...</dependencies>    依赖关系
  <parent>...</parent>  继承
 <dependencyManagement>...</dependencyManagement> 是用于帮助管理chidren的dependencies的

  <modules>...</modules>   对于多模块的project,outer-module没有必需考虑inner-module的dependencies,当列出modules的时候，modules的顺序是不重要的，因为maven会自动根据依赖关系来拓扑排序，

  <properties>...</properties> 是为pom定义一些常量，在pom中的其它地方可以直接引用。如定义编码方式

  <!--构建设置-->

  <build>...</build>

  <reporting>...</reporting>

  <!-- 更多项目信息-->

  <name>...</name>   项目除了artifactId外，可以定义多个名称
  <description>...</description>  项目描述
  <url>...</url>   项目url
  <inceptionYear>...</inceptionYear>  
创始年份
  <licenses>...</licenses>  列出本工程直接的licenses，而不要列出dependencies的licenses

  <organization>...</organization>   配置组织信息，很多工程都受到某些组织运行，这里设置基本信息
  <developers>...</developers>  配置开发者信息:
  <contributors>...</contributors>

  <!-- 环境设置-->

 <issueManagement>...</issueManagement>  bug跟踪管理系统,
 <ciManagement>...</ciManagement>

 <mailingLists>...</mailingLists> 

  <scm>...</scm>

 <prerequisites>...</prerequisites>

 <repositories>...</repositories> pom里面的仓库与setting.xml里的仓库功能是一样的。主要的区别在于，pom里的仓库是个性化的。比如一家大公司里的setting文件是公用的，所有项目都用一个setting文件，但各个子项目却会引用不同的第三方库，所以就需要在pom里设置自己需要的仓库地址。

 <pluginRepositories>...</pluginRepositories>  与Repositories具有类似的结构，只是Repositories是dependencies的home，而这个是plugins的home。

  <distributionManagement>...</distributionManagement>  管理distribution和supporting files。 
  <profiles>...</profiles>   pom4.0的一个新特性就是具有根据environment来修改设置的能力
</project>

 

 

 

 

 

 

 

 

 

 

 

 

 

 

构建设置

build设置:

defaultGoal:默认的目标，必须跟命令行上的参数相同，如：jar:jar,或者与时期parse相同,例如install

directory:指定buildtarget目标的目录，默认为$(basedir}/target,即项目根目录下的target

finalName:指定去掉后缀的工程名字，例如：默认为${artifactId}-${version}

filters:用于定义指定filter属性的位置，例如filter元素赋值filters/filter1.properties,那么这个文件里面就可以定义name=value对，这个name=value对的值就可以在工程pom中通过${name}引用，默认的filter目录是${basedir}/src/main/fiters/

resources:描述工程中资源的位置 

 

<resource> 

       <targetPath>META-INF/plexus</targetPath> 

       <filtering>false</filtering> 

       <directory>${basedir}/src/main/plexus</directory> 

        <includes> 

          <include>configuration.xml</include> 

        </includes> 

        <excludes> 

         <exclude>**/*.properties</exclude> 

        </excludes> 

      </resource>

 

targetPath:指定build资源到哪个目录，默认是basedirectory

filtering:指定是否将filter文件(即上面说的filters里定义的*.property文件)的变量值在这个resource文件有效,例如上面就指定那些变量值在configuration文件无效。

directory:指定属性文件的目录，build的过程需要找到它，并且将其放到targetPath下，默认的directory是${basedir}/src/main/resources

includes:指定包含文件的patterns,符合样式并且在directory目录下的文件将会包含进project的资源文件。

excludes:指定不包含在内的patterns,如果inclues与excludes有冲突，那么excludes胜利，那些符合冲突的样式的文件是不会包含进来的。

testResources:这个模块包含测试资源元素，其内容定义与resources类似，不同的一点是默认的测试资源路径是${basedir}/src/test/resources,测试资源是不部署的。

 

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>

extensions:trueor false, 决定是否要load这个plugin的extensions，默认为true.

inherited:是否让子pom继承，ture orfalse默认为true.

configuration:通常用于私有不开源的plugin,不能够详细了解plugin的内部工作原理，但使plugin满足的properties

dependencies:与pom基础的dependencies的结构和功能都相同，只是plugin的dependencies用于plugin,而pom的denpendencies用于项目本身。在plugin的dependencies主要用于改变plugin原来的dependencies，例如排除一些用不到的dependency或者修改dependency的版本等，详细请看pom的denpendencies.

executions:plugin也有很多个目标，每个目标具有不同的配置，executions就是设定plugin的目标，

<execution> 

           <id>echodir</id> 

           <goals> 

             <goal>run</goal> 

           </goals> 

           <phase>verify</phase> 

           <inherited>false</inherited> 

           <configuration> 

             <tasks> 

               <echo>Build Dir: ${project.build.directory}</echo> 

             </tasks> 

           </configuration> 

          </execution> 

id:标识符

goals:里面列出一系列的goals元素，例如上面的rungoal

phase:声明goals执行的时期，例如：verify

inherited:是否传递execution到子pom里。

configuration:设置execution下列表的goals的设置，而不是plugin所有的goals的设置

 

pluginManagement配置：

pluginManagement的作用类似于denpendencyManagement,只是denpendencyManagement是用于管理项目jar包依赖，pluginManagement是用于管理plugin。与pombuild里的plugins区别是，这里的plugin是列出来，然后让子pom来决定是否引用。

例如：

<pluginManagement> 

     <plugins> 

        <plugin> 

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

         <artifactId>maven-jar-plugin</artifactId> 

         <version>2.2</version> 

          <executions> 

           <execution> 

             <id>pre-process-classes</id> 

             <phase>compile</phase> 

             <goals> 

               <goal>jar</goal> 

             </goals> 

             <configuration> 

               <classifier>pre-process</classifier> 

             </configuration> 

            </execution> 

          </executions> 

        </plugin> 

      </plugins> 

    </pluginManagement> 
子pom引用方法： 
在pom的build里的plugins引用： 

    <plugins> 

      <plugin> 

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

        <artifactId>maven-jar-plugin</artifactId> 

      </plugin> 

    </plugins>

 

build里的
bbec
directories:

 

<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>

这几个元素只在parent build element里面定义，他们设置多种路径结构，他们并不在profile里，所以不能通过profile来修改

 

build 里面的Extensions： 
它们是一系列build过程中要使用的产品，他们会包含在runningbulid‘s classpath里面。他们可以开启extensions，也可以通过提供条件来激活plugins。简单来讲，extensions是在build过程被激活的产品 

    <extensions> 

      <extension> 

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

        <artifactId>wagon-ftp</artifactId> 

       <version>1.0-alpha-3</version> 

      </extension> 

    </extensions> 

 

reporting设置:

reporting包含site生成阶段的一些元素，某些mavenplugin可以生成reports并且在reporting下配置。例如javadoc,mavensite等，在reporting下配置的reportplugin的方法与build几乎一样，最不同的是build的plugingoals在executions下设置，而reporting的configuresgoals在reporttest。

excludeDefaults:是否排除sitegenerator默认产生的reports

outputDirectory，默认的dir变成:${basedir}/target/site

reportsets:设置executiongoals,相当于build里面的executions,不同的是不能够bind
areport to another phase,只能够是site

<reporting> 

    <plugins> 

      <plugin> 

        ... 

        <reportSets> 

          <reportSet> 

           <id>sunlink</id> 

           <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> 

reporting里面的厄reportSets和build里面的executions的作用都是控制pom的不同粒度去控制build的过程，我们不单要配置plugins，还要配置那些plugins单独的goals。