服务热线:13616026886

技术文档 欢迎使用技术文档,我们为你提供从新手到专业开发者的所有资源,你也可以通过它日益精进

位置:首页 > 技术文档 > JAVA > 新手入门 > 基础入门 > 查看文档

maven的pom结构


几个英文词汇的翻译对照,有误请指正

repository 资源库
project 项目
artifact 构件(可以理解为jar文件去掉版本号和.jar的文件名)

看看我们在《maven安装使用》中创建的project,里面有一个project.xml文件和project.properties文件。project.xml文件被称作maven管理项目的核心,并起了个名字project object model (pom),该 xml 文件格式由位于 maven 安装目录中的 xml 模式(maven-project.xsd)定义。

下面我们看看pom的框架示例:(以jetspeed-1为示例)

******主 project.xml 框架:******
<?xml version="1.0" encoding="iso-8859-1"?>

<!-- 根元素-->
<project>
  <!-- pom版本 -->
  <pomversion>3</pomversion>

  <!-- project标志. 和版本号在build中生成文件目录名。例如jar文件遵从<id>-<version>约定 . -->
  <id>jetspeed</id>

  <!-- project名,用于生成javadoc时的title-->
  <name>jakarta-jetspeed</name>

  <!-- 版本号 -->
  <currentversion>1.5</currentversion>

  <!---------------------------------------------------- -->
  <!-- 项目管理部分                                                   -->
  <!---------------------------------------------------- -->

  <!---------------------------------------------------- -->
  <!-- 项目相关性部分                                                -->
  <!---------------------------------------------------- -->

  <!---------------------------------------------------- -->
  <!-- 项目build和reports部分                                       -->
  <!---------------------------------------------------- -->
</project>


******项目管理部分******
  <!---------------------------------------------------- -->
  <!-- 项目管理部分                                                   -->
  <!---------------------------------------------------- -->

  <!-- 管理project的组织,只需名字,可以有多个组织的attributes -->
  <organization>
  <name>apache software foundation</name>
  <logo>images/apache-portals.gif</logo>
  <url>http://www.apache.org/</url>
  </organization>

  <!-- (optional) 起始年份,四位数字,在生成copyright信息时引用 -->
  <inceptionyear>2000</inceptionyear>

  <!-- (optional) 项目主package -->
  <package>org.apache.jetspeed</package>

  <!-- (optional) 项目logo位置 (可以使用url) -->
  <logo>/images/logo.gif</logo>

  <!-- (optional) gump 资源库id. 只在使用gump时有用. -->
  <gumprepositoryid>jakarta</gumprepositoryid>

  <!-- (optional) project 描述,用于生成站点主页,在项目中使用maven --usage可以查看这个描述,其中至可以使用html标签,但是主页最好还是使用xdocs/index.xml -->
  <description>...</description>

  <!-- (optional) project 描述,仅限一行  -->
  <shortdescription>...</shortdescription>

  <!-- (optional) project站点url -->
  <url>http://portals.apache.org/jetspeed-1/</url>

  <!-- (optional) 问题跟踪系统url -->
  <issuetrackingurl>http://nagoya.apache.org/jira/secure/browseproject.jspa?id=10493</issuetrackingurl>

  <!-- (optional) project站点地址. -->
  <siteaddress>portals.apache.org</siteaddress>

  <!-- (optional) project-site部署目录(physical location) -->
  <sitedirectory>/www/portals.apache.org/jetspeed-1/</sitedirectory>

  <!-- (optional) 项目source-repository信息 -->
  <repository>
    <connection>scm:cvs:pserver:anoncvs@cvs.apache.org:/home/cvspublic:jakarta-jetspeed</connection>
    <url>http://cvs.apache.org/viewcvs/jakarta-jetspeed/</url>
  </repository>

  <!-- (optional) mailing list信息 -->
  <mailinglists>
    <mailinglist>
 <name>jetspeed user list</name>
 <subscribe>jetspeed-user-subscribe@jakarta.apache.org</subscribe>
 <unsubscribe>jetspeed-user-unsubscribe@jakarta.apache.org</unsubscribe>
 <archive>http://nagoya.apache.org:8080/eyebrowse/summarizelist?listname=jetspeed-user@jakarta.apache.org</archive>
    </mailinglist>
    ......
 </mailinglists>

  <!-- 参加开发的人员 -->
  <developers>
    <developer>
 <name>dave blackett (jetspeed logos)</name>
 <id/>
 <email>blackett@black.com</email>
 <organization/>
    </developer>
    ......
  </developers>

******项目相关性部分******与一个中央构件资源库一起使用,将消除几个常见的构建问题

  <!---------------------------------------------------- -->
  <!-- 项目相关性部分                                                -->
  <!---------------------------------------------------- -->

  <!--build过程中maven依据之建立classpath,并且maven会到remote repository自动下载这些dependencies ,如type是jar,下载的文件就是<artifactid>-<version>.jar-->
  <dependencies>

    <!-- 项目依赖jar文件 "activation-1.0.1.jar",文件在maven repository
   的activation/jars子目录,并且如果资源库中找不到,maven会在自动从maven.repo.remote下载(《maven安装使用》中提到的修改是因为maven的缺省设置远程资源库无法连接上)-->
  <dependency>
   <id>activation</id>
   <version>1.0.1</version>
   <properties>
    <war.bundle.jar>true</war.bundle.jar>
   </properties>
  </dependency>
  </dependencies>


groupid 告诉 maven 资源库内哪个子目录中包含相关性文件。
artifactid 告诉 maven 该构件的唯一标识。如果是jar文件,可以理解为去掉后缀和版本号的文件名 。
version 表示相关性的版本号。
jar  (可选的)表示相关性的 jar 文件。在绝大多数情况下,可以从相关性的 <artifactid> 和 <version> 构造 jar 文件的名称。
type  (可选的)相关性的类型;如 jar 和分发版等。缺省值是 jar。
url  可选的)相关性项目的 url,在相关性是在因特网上找到的第三方库时非常有用。
properties dependency还有properties可以设定,具体要参照各自引用的plugin


******项目构建部分******
  <!---------------------------------------------------- -->
  <!-- 项目build和reports部分                                       -->
  <!---------------------------------------------------- -->

  <build>
    <!-- (optional) 定义源文件位置. -->
    <sourcedirectory>src/java</sourcedirectory>

    <!-- (optional) 定义单元测试源文件位置. -->
    <unittestsourcedirectory>test/java</unittestsourcedirectory>

    <!-- (optional) 单元测试用例文件模式. -->
    <unittest>
 <!-- 排除测试 -->
       <excludes>
          <exclude>org/apache/jetspeed/services/registry/testregistrycategories.java</exclude>
   ......
       </excludes>
       <!-- 包含测试 -->
 <includes>
    <include>**/test*.java</include>
  </includes>
  <!-- 单元测试使用的资源 -->
  <resources>
      <resource>
          <!-- 资源位置,project.xml的相对路径 -->
   <directory>${basedir}/src/java</directory>
   <!-- 排除文件 -->
   <excludes>
    <exclude>**/*.java</exclude>
   </excludes>
   <!-- 包含文件 -->
   <includes>
    <include>org/apache/jetspeed/modules/localization/jetspeedlocalization_*.properties</include>
   </includes>
       </resource>   
       .......
  </resources>
   </unittest>

   <!-- 项目使用的资源,结构与单元测试使用的资源结构相同 -->
 <resources>
     <resource>
 ......
      </resource>   
      .......
 </resources>

  <!-- (optional) 使用maven site生成站点的时候被引用,并以指定的顺序排列在导航条内,report指定生成报告的plugin -->
  <reports>
    <report>
 <report>maven-tasklist-plugin</report>
 <report>maven-changelog-plugin</report>
 <report>maven-javadoc-plugin</report>
    </report>
  </reports>
</build>

这里只是对project.xml文件大致的说明,pom的详细说明在
http://maven.apache.org/reference/project-descriptor.html#resources
如果有兴趣,可以仔细观摩

扫描关注微信公众号