关于maven的pom文件配置问题

来源：互联网发布：mac合盖放歌编辑：程序博客网时间：2024/05/29 13:11

<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来决定是否引用。

例如：

     <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里的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。

0 0