Chinaunix首页 | 论坛 | 博客

IT民工窝棚qbq.blog.chinaunix.net

首页　| 　博文目录　| 　关于我

qbq

  • 博客访问： 30462916
  • 博文数量： 708
  • 博客积分： 12163
  • 博客等级： 上将
  • 技术积分： 8240
  • 用 户 组： 普通用户
  • 注册时间： 2007-12-04 20:59
文章分类

全部博文（708）

推荐博文
相关博文
maven 配置篇 之pom.xml

分类： Java

2009-11-18 14:09:14

什么是pom?
    pom作为项目对象模型。通过xml表示maven项目，使用pom.xml来实现。主要描述了项目：包括配置文件；开发者需要遵循的规则，缺陷管理系统，组织和licenses，项目的url，项目的依赖性，以及其他所有的项目相关因素。
快速察看：
xml 代码
 
  1. <project>  
  2.   <modelVersion>4.0.0modelVersion>  
  3.   
  4.     
  5.   <groupId>...groupId>  
  6.   <artifactId>...artifactId>  
  7.   <version>...version>  
  8.   <packaging>...packaging>  
  9.   <dependencies>...dependencies>  
  10.   <parent>...parent>  
  11.   <dependencyManagement>...dependencyManagement>  
  12.   <modules>...modules>  
  13.   <properties>...properties>  
  14.   
  15.     
  16.   <build>...build>  
  17.   <reporting>...reporting>  
  18.   
  19.     
  20.   <name>...name>  
  21.   <description>...description>  
  22.   <url>...url>  
  23.   <inceptionYear>...inceptionYear>  
  24.   <licenses>...licenses>  
  25.   <organization>...organization>  
  26.   <developers>...developers>  
  27.   <contributors>...contributors>  
  28.   
  29.     
  30.   <issueManagement>...issueManagement>  
  31.   <ciManagement>...ciManagement>  
  32.   <mailingLists>...mailingLists>  
  33.   <scm>...scm>  
  34.   <prerequisites>...prerequisites>  
  35.   <repositories>...repositories>  
  36.   <pluginRepositories>...pluginRepositories>  
  37.   <distributionManagement>...distributionManagement>  
  38.   <profiles>...profiles>  
  39. project>  

基本内容：
    POM包括了所有的项目信息。
maven 相关：
pom定义了最小的maven2元素，允许groupId,artifactId,version。所有需要的元素
  • groupId:项目或者组织的唯一标志，并且配置时生成的路径也是由此生成，如org.codehaus.mojo生成的相对路径为：/org/codehaus/mojo
  • artifactId: 项目的通用名称
  • version:项目的版本
  • packaging: 打包的机制，如pom, jar, maven-plugin, ejb, war, ear, rar, par
  • classifier: 分类
POM关系：
主要为依赖，继承，合成
  依赖关系：
 
xml 代码
 
  1. <dependencies>  
  2.     <dependency>  
  3.       <groupId>junitgroupId>  
  4.       <artifactId>junitartifactId>  
  5.       <version>4.0version>  
  6.       <type>jartype>  
  7.       <scope>testscope>  
  8.       <optional>trueoptional>  
  9.     dependency>  
  10.     ...  
  11.   dependencies>  

  • groupId, artifactId, version:描述了依赖的项目唯一标志
可以通过以下方式进行安装：
  • 使用以下的命令安装：
  • mvn install:install-file –Dfile=non-maven-proj.jar –DgroupId=some.group –DartifactId=non-maven-proj –Dversion=1
  • 创建自己的库,并配置，使用deploy:deploy-file
  • 设置此依赖范围为system，定义一个系统路径。不提倡。
  • type:相应的依赖产品包形式，如jar，war
  • scope:用于限制相应的依赖范围，包括以下的几种变量：
  • compile ：默认范围，用于编译
  • provided：类似于编译，但支持你期待jdk或者容器提供，类似于classpath
  • runtime:在执行时，需要使用
  • test:用于test任务时使用
  • system:需要外在提供相应得元素。通过systemPath来取得
  • systemPath: 仅用于范围为system。提供相应的路径
  • optional: 标注可选，当项目自身也是依赖时。用于连续依赖时使用
   独占性    
   外在告诉maven你只包括指定的项目，不包括相关的依赖。此因素主要用于解决版本冲突问题
 
xml 代码
 
  1. <dependencies>  
  2.     <dependency>  
  3.       <groupId>org.apache.mavengroupId>  
  4.       <artifactId>maven-embedderartifactId>  
  5.       <version>2.0version>  
  6.       <exclusions>  
  7.         <exclusion>  
  8.           <groupId>org.apache.mavengroupId>  
  9.           <artifactId>maven-coreartifactId>  
  10.         exclusion>  
  11.       exclusions>  
  12.     dependency>  

表示项目maven-embedder需要项目maven-core，但我们不想引用maven-core

继承关系
    另一个强大的变化,maven带来的是项目继承。主要的设置：
定义父项目
xml 代码
 
  1. <project>  
  2.   <modelVersion>4.0.0modelVersion>  
  3.   <groupId>org.codehaus.mojogroupId>  
  4.   <artifactId>my-parentartifactId>  
  5.   <version>2.0version>  
  6.   <packaging>pompackaging>  
  7. project>  

    packaging 类型，需要pom用于parent和合成多个项目。我们需要增加相应的值给父pom，用于子项目继承。主要的元素如下：
  • 依赖型
  • 开发者和合作者
  • 插件列表
  • 报表列表
  • 插件执行使用相应的匹配ids
  • 插件配置
  • 子项目配置
xml 代码
 
  1. <project>  
  2.   <modelVersion>4.0.0modelVersion>  
  3.   <parent>  
  4.     <groupId>org.codehaus.mojogroupId>  
  5.     <artifactId>my-parentartifactId>  
  6.     <version>2.0version>  
  7.     <relativePath>../my-parentrelativePath>  
  8.   parent>  
  9.   <artifactId>my-projectartifactId>  
  10. project>  

relativePath可以不需要，但是用于指明parent的目录，用于快速查询。

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

合成（或者多个模块）
    一个项目有多个模块，也叫做多重模块，或者合成项目。
如下的定义：
xml 代码
 
  1. <project>  
  2.   <modelVersion>4.0.0modelVersion>  
  3.   <groupId>org.codehaus.mojogroupId>  
  4.   <artifactId>my-parentartifactId>  
  5.   <version>2.0version>  
  6.   <modules>  
  7.     <module>my-project1<module>  
  8.     <module>my-project2<module>  
  9.   modules>  
  10. project>  


build 设置
    主要用于编译设置，包括两个主要的元素，build和report
  build
    主要分为两部分，基本元素和扩展元素集合
注意：包括项目build和profile build
xml 代码
 
  1. <project>  
  2.     
  3.   <build>...build>  
  4.   <profiles>  
  5.     <profile>  
  6.         
  7.       <build>...build>  
  8.     profile>  
  9.   profiles>  
  10. project>  


基本元素
xml 代码
 
  1. <build>  
  2.   <defaultGoal>installdefaultGoal>  
  3.   <directory>${basedir}/targetdirectory>  
  4.   <finalName>${artifactId}-${version}finalName>  
  5.   <filters>  
  6.     <filter>filters/filter1.propertiesfilter>  
  7.   filters>  
  8.   ...  
  9. build>  

  • defaultGoal: 定义默认的目标或者阶段。如install
  • directory: 编译输出的目录
  • finalName: 生成最后的文件的样式
  • filter: 定义过滤，用于替换相应的属性文件，使用maven定义的属性。设置所有placehold的值

资源(resources)
    你项目中需要指定的资源。如spring配置文件,log4j.properties
xml 代码
 
  1. <project>  
  2.   <build>  
  3.     ...  
  4.     <resources>  
  5.       <resource>  
  6.         <targetPath>META-INF/plexustargetPath>  
  7.         <filtering>falsefiltering>  
  8.         <directory>${basedir}/src/main/plexusdirectory>  
  9.         <includes>  
  10.           <include>configuration.xmlinclude>  
  11.         includes>  
  12.         <excludes>  
  13.           <exclude>**/*.propertiesexclude>  
  14.         excludes>  
  15.       resource>  
  16.     resources>  
  17.     <testResources>  
  18.       ...  
  19.     testResources>  
  20.     ...  
  21.   build>  
  22. project>  


  • resources: resource的列表，用于包括所有的资源
  • targetPath: 指定目标路径，用于放置资源，用于build
  • filtering: 是否替换资源中的属性placehold
  • directory: 资源所在的位置
  • includes: 样式，包括那些资源
  • excludes: 排除的资源
  • testResources: 测试资源列表
插件
  在build时，执行的插件，比较有用的部分，如使用jdk 5.0编译等等
xml 代码
 
  1. <project>  
  2.   <build>  
  3.     ...  
  4.     <plugins>  
  5.       <plugin>  
  6.         <groupId>org.apache.maven.pluginsgroupId>  
  7.         <artifactId>maven-jar-pluginartifactId>  
  8.         <version>2.0version>  
  9.         <extensions>falseextensions>  
  10.         <inherited>trueinherited>  
  11.         <configuration>  
  12.           <classifier>testclassifier>  
  13.         configuration>  
  14.         <dependencies>...dependencies>  
  15.         <executions>...executions>  
  16.       plugin>  
  17.     plugins>  
  18.   build>  
  19. project>  

  • extensions: true or false，是否装载插件扩展。默认false
  • inherited: true or false，是否此插件配置将会应用于poms，那些继承于此的项目
  • configuration: 指定插件配置
  • dependencies: 插件需要依赖的包
  • executions: 用于配置execution目标，一个插件可以有多个目标。
如下：
   
xml 代码
 
  1. <plugin>  
  2.         <artifactId>maven-antrun-pluginartifactId>  
  3.   
  4.         <executions>  
  5.           <execution>  
  6.             <id>echodirid>  
  7.             <goals>  
  8.               <goal>rungoal>  
  9.             goals>  
  10.             <phase>verifyphase>  
  11.             <inherited>falseinherited>  
  12.             <configuration>  
  13.               <tasks>  
  14.                 <echo>Build Dir: ${project.build.directory}echo>  
  15.               tasks>  
  16.             configuration>  
  17.           execution>  
  18.         executions>  
  19.       plugin>  

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

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

扩展元素集合
主要包括以下的元素：
Directories
用于设置各种目录结构，如下：
 
xml 代码
 
  1. <build>  
  2.     <sourceDirectory>${basedir}/src/main/javasourceDirectory>  
  3.     <scriptSourceDirectory>${basedir}/src/main/scriptsscriptSourceDirectory>  
  4.     <testSourceDirectory>${basedir}/src/test/javatestSourceDirectory>  
  5.     <outputDirectory>${basedir}/target/classesoutputDirectory>  
  6.     <testOutputDirectory>${basedir}/target/test-classestestOutputDirectory>  
  7.     ...  
  8.   build>  


Extensions

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

xml 代码
 
  1. <project>  
  2.   <build>  
  3.     ...  
  4.     <extensions>  
  5.       <extension>  
  6.         <groupId>org.apache.maven.wagongroupId>  
  7.         <artifactId>wagon-ftpartifactId>  
  8.         <version>1.0-alpha-3version>  
  9.       extension>  
  10.     extensions>  
  11.     ...  
  12.   build>  
  13. project>  


Reporting
    用于在site阶段输出报表。特定的maven 插件能输出相应的定制和配置报表。
 
xml 代码
 
  1. <reporting>  
  2.     <plugins>  
  3.       <plugin>  
  4.         <outputDirectory>${basedir}/target/siteoutputDirectory>  
  5.         <artifactId>maven-project-info-reports-pluginartifactId>  
  6.         <reportSets>  
  7.           <reportSet>reportSet>  
  8.         reportSets>  
  9.       plugin>  
  10.     plugins>  
  11.   reporting>  


Report Sets
    用于配置不同的目标，应用于不同的报表
xml 代码
 
  1. <reporting>  
  2.     <plugins>  
  3.       <plugin>  
  4.         ...  
  5.         <reportSets>  
  6.           <reportSet>  
  7.             <id>sunlinkid>  
  8.             <reports>  
  9.               <report>javadocreport>  
  10.             reports>  
  11.             <inherited>trueinherited>  
  12.             <configuration>  
  13.               <links>  
  14.                 <link>link>  
  15.               links>  
  16.             configuration>  
  17.           reportSet>  
  18.         reportSets>  
  19.       plugin>  
  20.     plugins>  
  21.   reporting> 

更多的项目信息
  • name:项目除了artifactId外，可以定义多个名称
  • description: 项目描述
  • url: 项目url
  • inceptionYear:创始年份
Licenses
xml 代码
 
  1. <licenses>  
  2.   <license>  
  3.     <name>Apache 2name>  
  4.     <url>url>  
  5.     <distribution>repodistribution>  
  6.     <comments>A business-friendly OSS licensecomments>  
  7.   license>  
  8. licenses> 

Organization
配置组织信息
 
xml 代码
 
  1. <organization>  
  2.     <name>Codehaus Mojoname>  
  3.     <url>url>  
  4.   organization>  

Developers
配置开发者信息
xml 代码
 
  1. <developers>  
  2.     <developer>  
  3.       <id>ericid>  
  4.       <name>Ericname>  
  5.       <email>eredmond@codehaus.orgemail>  
  6.       <url>url>  
  7.       <organization>Codehausorganization>  
  8.       <organizationUrl>organizationUrl>  
  9.       <roles>  
  10.         <role>architectrole>  
  11.         <role>developerrole>  
  12.       roles>  
  13.       <timezone>-6timezone>  
  14.       <properties>  
  15.         <picUrl>picUrl>  
  16.       properties>  
  17.     developer>  
  18.   developers>  

Contributors
 
xml 代码
 
  1. <contributors>  
  2.    <contributor>  
  3.      <name>Noellename>  
  4.      <email>some.name@gmail.comemail>  
  5.      <url>url>  
  6.      <organization>Noelle Marieorganization>  
  7.      <organizationUrl>organizationUrl>  
  8.      <roles>  
  9.        <role>testerrole>  
  10.      roles>  
  11.      <timezone>-5timezone>  
  12.      <properties>  
  13.        <gtalk>some.name@gmail.comgtalk>  
  14.      properties>  
  15.    contributor>  
  16.  contributors>  

环境设置

Issue Management
    定义相关的bug跟踪系统，如bugzilla,testtrack,clearQuest等
 
xml 代码
 
  1. <issueManagement>  
  2.     <system>Bugzillasystem>  
  3.     <url>url>  
  4.   issueManagement>  

Continuous Integration Management
连续整合管理，基于triggers或者timings
 
xml 代码
 
  1. <ciManagement>  
  2.    <system>continuumsystem>  
  3.    <url>url>  
  4.    <notifiers>  
  5.      <notifier>  
  6.        <type>mailtype>  
  7.        <sendOnError>truesendOnError>  
  8.        <sendOnFailure>truesendOnFailure>  
  9.        <sendOnSuccess>falsesendOnSuccess>  
  10.        <sendOnWarning>falsesendOnWarning>  
  11.        <configuration><address>continuum@127.0.0.1address>configuration>  
  12.      notifier>  
  13.    notifiers>  
  14.  ciManagement>  

Mailing Lists
 
xml 代码
 
  1. <mailingLists>  
  2.    <mailingList>  
  3.      <name>User Listname>  
  4.      <subscribe>user-subscribe@127.0.0.1subscribe>  
  5.      <unsubscribe>user-unsubscribe@127.0.0.1unsubscribe>  
  6.      <post>user@127.0.0.1post>  
  7.      <archive>archive>  
  8.      <otherArchives>  
  9.        <otherArchive>otherArchive>  
  10.      otherArchives>  
  11.    mailingList>  
  12.  mailingLists>  


SCM
  软件配置管理，如cvs 和svn
 
xml 代码
 
  1. <scm>  
  2.     <connection>scm:svn:connection>  
  3.     <developerConnection>scm:svn:developerConnection>  
  4.     <tag>HEADtag>  
  5.     <url>url>  
  6.   scm>  

Repositories

配置同setting.xml中的开发库

Plugin Repositories
配置同 repositories

Distribution Management
用于配置分发管理，配置相应的产品发布信息,主要用于发布，在执行mvn deploy后表示要发布的位置
1 配置到文件系统
xml 代码
 
  1. <distributionManagement>  
  2. <repository>  
  3. <id>proficio-repositoryid>  
  4. <name>Proficio Repositoryname>  
  5. <url>file://${basedir}/target/deployurl>  
  6. repository>  
  7. distributionManagement>  

2 使用ssh2配置
xml 代码
 
  1. <distributionManagement>  
  2. <repository>  
  3. <id>proficio-repositoryid>  
  4. <name>Proficio Repositoryname>  
  5. <url>scp://sshserver.yourcompany.com/deployurl>  
  6. repository>  
  7. distributionManagement>  

3 使用sftp配置
xml 代码
 
  1. <distributionManagement>  
  2. <repository>  
  3. <id>proficio-repositoryid>  
  4. <name>Proficio Repositoryname>  
  5. <url>sftp://ftpserver.yourcompany.com/deployurl>  
  6. repository>  
  7. distributionManagement>  

4 使用外在的ssh配置
    编译扩展用于指定使用wagon外在ssh提供，用于提供你的文件到相应的远程服务器。
xml 代码
 
  1. <distributionManagement>  
  2. <repository>  
  3. <id>proficio-repositoryid>  
  4. <name>Proficio Repositoryname>  
  5. <url>scpexe://sshserver.yourcompany.com/deployurl>  
  6. repository>  
  7. distributionManagement>  
  8. <build>  
  9. <extensions>  
  10. <extension>  
  11. <groupId>org.apache.maven.wagongroupId>  
  12. <artifactId>wagon-ssh-externalartifactId>  
  13. <version>1.0-alpha-6version>  
  14. extension>  
  15. extensions>  
  16. build>  


5 使用ftp配置
xml 代码
 
  1. <distributionManagement>  
  2. <repository>  
  3. <id>proficio-repositoryid>  
  4. <name>Proficio Repositoryname>  
  5. <url>ftp://ftpserver.yourcompany.com/deployurl>  
  6. repository>  
  7. distributionManagement>  
  8. <build>  
  9. <extensions>  
  10. <extension>  
  11. <groupId>org.apache.maven.wagongroupId>  
  12. <artifactId>wagon-ftpartifactId>  
  13. <version>1.0-alpha-6version>  
  14. extension>  
  15. extensions>  
  16. build>  


repository 对应于你的开发库，用户信息通过settings.xml中的server取得

Profiles
类似于settings.xml中的profiles，增加了几个元素，如下的样式：
 
xml 代码
 
  1. <profiles>  
  2.     <profile>  
  3.       <id>testid>  
  4.       <activation>...activation>  
  5.       <build>...build>  
  6.       <modules>...modules>  
  7.       <repositories>...repositories>  
  8.       <pluginRepositories>...pluginRepositories>  
  9.       <dependencies>...dependencies>  
  10.       <reporting>...reporting>  
  11.       <dependencyManagement>...dependencyManagement>  
  12.       <distributionManagement>...distributionManagement>  
  13.     profile>  
  14.   profiles>  

阅读(1517) | 评论(0) | 转发(0) |
0

上一篇：Apache Ant Ivy Quick Start(快速入门)

下一篇：maven 配置篇 之 settings.xml

给主人留下些什么吧！~~
关于我们 | 关于IT168 | 联系方式 | 广告合作 | 法律声明 | 免费注册

Copyright 2001-2010 ChinaUnix.net All Rights Reserved 北京皓辰网域网络信息技术有限公司. 版权所有

感谢所有关心和支持过ChinaUnix的朋友们

16024965号-6