]]>
]]>
一个简单的而完全可操作的pom.xml如下所C：
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion> <!--maven2-->
<groupId>ctzj_bss</groupId> <!-- q个目所属组的idQ一般是目所在的公司或组l的域名 -->
<artifactId>NRC</artifactId> <!-- 目的id,和groupId一L成这个项目的一个唯一idQ以用在别的maven2工程?-->
<packaging>jar</packaging> <!-- 最后这个工E的打包cd,在这里是打成jar?-->
<version>1.0</version> <!-- 版本?-->
<name>kenan nrc batch</name> <!-- 目? 区别于artifactId-->
<description>insert a nrc in kenan db</description> <!-- 目描述,会出现在生成的工E站点上 -->
<build> <!-- 目的构Z?-->
<sourceDirectory>src</sourceDirectory>
<testSourceDirectory>test</testSourceDirectory>
<outputDirectory>target\classes</outputDirectory>
<testOutputDirectory>target\test-classes</testOutputDirectory>
<directory>target</directory> <!-- 构徏后生成文?jar,site{?所在位|?-->
</build>
<dependencies> <!-- 目的依赖外接包,maven的优势之一 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<reporting> <!-- 目报表,有很多插件可供选择 -->
<outputDirectory>target/site</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
</plugins>
</reporting>
</project>
在你配置了你的pom文g后，你就可以使用如下命o来运行maven2
mvn compiler:compile ~译你的原文?br /> mvn jar:jar 打包
mvn site:site 生成目站点
接下来逐个介绍pom.xml的各个要?br /> developor,organization and mail lit
build
dependencies
reporting
1.developor,organization and mail list
可以在pom中加入开发h员列?目所属组l信?邮g列表,q些信息会出现在生成的项目站点上
<organization>
<name>CTZJ BSS</name>
</organization>
<developers>
<developer>
<name>Chen Lin</name>
<organization>ZJHCsoft</organization>
<email>chenlin@zjhcsoft.com</email>
</developer>
</developers>
<mailingLists>
<mailingList>
<name>${pom.name} Dev List</name>
</mailingList>
<mailingList>
<name>${pom.name} User List</name>
</mailingList>
</mailingLists>
2. build
配置目的构Z?主要有指定目?包括源代码、测试源代码、输出目录、资源目录等.如果没有Ҏ需求以上的pom已经_?br />
3. dependencies
配置目要用到的jar?自认为maven对jar包的理是它的一个重要特?下面是一个jar包的配置:
<dependency>
<groupId>concurrent</groupId>
<artifactId>concurrent</artifactId>
<version>1.3.4</version>
<scope>compile</scope>
</dependency>
groupId: 没有特定的含?一般来自同一l织的jar包会有相同的groupId?br /> artifactId: q个jar的id,一般是q个jar包的名称
version: jar包的版本?一般情况下,artifactId-version.jar是q个jar包的文g?br /> scope: q个jar所影响的范?compile指它会在~译源代码时用到.q有test,provide,runtime{?br />
如果你不知道jar包的groupId和artifactIdQ可以到http://www.mavenregistry.com/ q行查询
一旦指定后,当你q行~译Ӟ它就会到你的本地资源?br />
?如果你引入本地包Q则需要先行将它安装到本地资料?repository),使用如下命o
mvn install:install-file -DgroupId=%groupId% -DartifactId=%artifactId% -DgeneratePom=true -Dfile=%file% -Dpackaging=jar -Dversion=%version%
4. reporting
通过使用相应的report plug-in可以生成各种各样的report.如javadoc,junit test report,代码查等
常用的常见有
<plugin>
<groupId>org.apache.maven.plugins</groupId> <!--java doc -->
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId> <!-- 代码?-->
<artifactId>maven-checkstyle-plugin</artifactId>
<configuration>
<configLocation>config/sun_checks.xml</configLocation>
</configuration>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId> <!-- test l果报表 -->
<artifactId>surefire-report-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId> <!-- 源代码的HTML?-->
<artifactId>jxr-maven-plugin</artifactId>
</plugin>
在maven的官方网站有可以扑ֈ更多的report plugin
最后一个比较完整的pom.xml看v来像q样Q?br />
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<name>CutoverModule</name>
<groupId>ctzj_batch</groupId>
<artifactId>eai_cutover</artifactId>
<url>http://134.98.83.137:8081/scarab/issues</url>
<inceptionYear>2006</inceptionYear>
<organization>
<name>CTZJ BSS</name>
<url>http://www.zjhcsoft.com</url>
</organization>
<version>1.0</version>
<description>97 cutover batch module:invoke eai-adapter to update the phone number or value of
c4/c5</description>
<developers>
<developer>
<name>Chen Lin</name>
<organization>ZJHCSoft</organization>
<email>chenlin@zjhcsoft.com</email>
</developer>
</developers>
<mailingLists>
<mailingList>
<name>${pom.name} Dev List</name>
</mailingList>
</mailingLists>
<build>
<sourceDirectory>src</sourceDirectory>
<testSourceDirectory>test</testSourceDirectory>
<outputDirectory>target\classes</outputDirectory>
<testOutputDirectory>target\test-classes</testOutputDirectory>
<directory>target</directory>
<plugins>
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<version>2.1</version>
</plugin>
<plugin>
<artifactId>maven-resources-plugin</artifactId>
<version>2.1</version>
</plugin>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0</version>
</plugin>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.1.2</version>
</plugin>
<plugin>
<artifactId>maven-jar-plugin</artifactId>
<version>2.0</version>
</plugin>
<plugin>
<artifactId>maven-install-plugin</artifactId>
<version>2.1</version>
</plugin>
</plugins>
</build>
<ciManagement>
<system>continuum</system>
<url>http://localhost:8080/continuum/servlet/continuum</url>
</ciManagement>
<scm>
<connection>scm:local|E:/eclipseworkshop|EAIBatch</connection>
</scm>
<dependencies>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>Eaiadapter</artifactId>
<version>1.0</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>ta</artifactId>
<version>1.0</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>ctzj_batch</groupId>
<artifactId>grnds-common</artifactId>
<version>4.1</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>concurrent</groupId>
<artifactId>concurrent</artifactId>
<version>1.3.4</version>
<scope>compile</scope>
</dependency>
</dependencies>
<reporting>
<outputDirectory>target/site</outputDirectory>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-checkstyle-plugin</artifactId>
<configuration>
<configLocation>config/sun_checks.xml</configLocation>
</configuration>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>surefire-report-maven-plugin</artifactId>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jxr-maven-plugin</artifactId>
</plugin>
</plugins>
</reporting>
</project>
]]>
]]>
]]>
Maven和ANT是Apache 推出的大名鼎鼎的Build和工E管理工P国内有h他做了汉化工作Qƈ推出了maven手册汉化工作Q其中手册已l完工，对广大程序员可是一大帮助?a href="http://http//maven.huangdong.com/">q入该网?/a>
用户手册
- Maven使用者邮件列?/a>上发?
感谢选择Maven!
?/a>
Maven最早始于Jarkarta Turbine目Q目的是Z化构E。这个项目下面有 几个子项目，每个子项目都有自qAnt文gQ但是区别很，而且生成的JAR 文g都要check in到CVS中。我们希望有一U标准的方式来构些项目，一U可?清晰描述目的方式，一U易于发布项目信息的方式Q一U在多个目之间׃nJARs 的方式?
q个l果是产生了一个可以用于构建、管理Q何基于java的项目。我们希望我们创?的这个工具可以让Java开发者的日常工作更加LQƈ有助于理解基于java的项?
目对象模型
Maven是基于项目对象模?POM)的概念而创建的。在q个模型中，所有由Maven产生?artifact都是清晰定义的项目模型的l果。构建，文档Q源码度量，源码交叉引用和其?M由Maven plug-in提供的东襉K是由POM来控制的?
POM 处理机制
q篇文档单的描述了Maven执行q程中是如何处理POM的。这里有一些简单的POM例子 来展C承机制和插值机制?
POM 插值机?/a>
POM(通常以project.xml的名字出?现在已经被当作Jelly脚本来处理了。大部分?候，用户无须兛_project.xml文g是不是真正的Jelly脚本Q但是，如果需要的话， 也可以用内|倹{我也不愿看到逻辑控制语句出现在project.xml中，但是׃ project.xml实际上已l是一个隐含的jelly的脚本，所以它会有_的灵zL?-)?下面是一个简单的例子?
3
maven
maven
Maven
1.0-b5-dev
Apache Software Foundation
http://jakarta.apache.org/
/images/jakarta-logo-blue.gif
2001
org.apache.${pom.artifactId}
/images/${pom.artifactId}.jpg
Maven is a project that was created in ${pom.inceptionYear}.
${pom.name} is a Java Project Management Tool
POM l承机制
现在有一U简单方式可以用于在POM中进行承，下面是一个简单的例子Q?
project.xml
super-extendo
super-extendo
Super Extendo
**/*Test*.java
**/TestAll.java
**/*Abstract*.java
目前对POM父对象的解析q相对较弱，现在对一层以上的l承q没有做qQ何测试。尽如此， 单层l承加上插值机制已l能够给带来很多好处。这些机制的意图在于化构建的q问题?
你可以这样定义主模板Q?
3
commons
commons-master
Commons Master Maven POM
Apache Software Foundation
http://www.apache.org
jakarta
http://jakarta.apache.org/commons/${pom.artifactId}.html
http://nagoya.apache.org/
jakarta.apache.org
/www/jakarta.apache.org/commons/${pom.artifactId}/
/www/jakarta.apache.org/builds/jakarta-commons/${pom.artifactId}/
scm:cvs:pserver:anoncvs@cvs.apache.org:/home/cvspublic:jakarta-commons/${pom.artifactId}
http://cvs.apache.org/viewcvs/jakarta-commons/${pom.artifactId}/
...
子POM对象可以q样定义Q?
commons-betwixt
commons-betwixt
Betwixt
...
q样你就可以在父POM对象中，子POM对象?{pom.artifactId}替换q去。有许多目?构徏都以怼的方式进行构建，q样一来，对于目的公共部分，你就可以使用一个主模板Q?然后在子POM对象project.xml中定义有区别的部分，而这部分内容通常很少?
q种机制实q可以简化那些需要生多个JAR包的目。由于project.xml和标准Ant构徏 不会怺q扰Q我计划在公共部分测试承机制?
如果你对使用q种机制QDVSL报告会变成什么样感到疑惑Q我要说Q你很上路。我已经修改 了DVSL报告来适应POM本nQ这是说DVSL转换是基于java对象的。在使用l承和插值机制的 时候，Z正确的生DVSL报告Q这是很有必要的。象上面列出的子模板是无法工作的Q我?需要全面的解析POM。我能说的是Q它可以工作了！我所使用的处理方式可能不是最有效率的 方式Q但仍有提升的空间。因为POM只会被处理一?不管怎么_q就它的原理Q我可能漏了 某些东西)Q然后到处用，臛_q就是我以前试图做的事情Q所以我们很有可能会取得q?
如果你不使用l承和插|那么一切照常工作。maven站点本n一切okQ有几个刚部|的站点 已经使用了我昨晚提交的东西了?
使用插g
Maven是一个很紧凑的内核，围绕着它的是许许多多的插g。Maven所有的功能都是由插件来提供 的?
maven.xml文g
目中的maven.xml文g是Maven在执行过E中要用的“定制”文g?
在这个文件中Q你可以加入Maven构徏中需要的额外处理。或者在Maven?#8220;目标”前后附加自己 的代码，如jar ?test?
Maven使用Jelly 脚本语言, M合法的jelly标签都可以在maven.xml中用?
Maven所采用的goal功能是由werkz标签库提供。更多的信息L wiki面.
单的maven.xml例子
注意׃Mavenq未~省的定?compile'目标Q下面这个例子没法运行?
q是一个简单的maven.xml例子
${goals}
Now attaining goal number ${goalNumber}, which is ${goal}
你可能会注意到这里一些有意思的东西Q下面我们将逐一解释?
project节点
project节点, , 是Q?maven.xml 文g的根节点?
目节点有一个缺省的属性：default="nightly-build"Q如果用户只是简单键?没有参数的maven命oQMaven׃用nightly-build 目标作ؓ~省目标?
接下来是几个名字I间的声明，如：- xmlns:j="jelly:core"
所有以j:作ؓ前缀的节点，Jelly都会把它视ؓ在core标识?预定义的标签库? - xmlns:u="jelly:util"
所有以u:作ؓ前缀的节点，Jelly都会把它视ؓ在标识下 预定义的标签库?
所有在maven.xml文g使用的Jelly标签库，?strong>必须在project节点中定义，q且 分配一个名U空间前~?
Maven已经预先包含了jeez标签库作为空前缀。这个标{ֺ在一个名U空间内包含?ant ?werkz 标签库。这PMwerkz或ant标签都无dU空?卛_使用Q同时也化了ant的迁U过E?
目标
goal是一?a > werkz 标签Q类gAnt的targetQ它是包含了一pd可执行标{容器?
׃jeez 标签库已l由maven预先注册了，一个目?goal)可以包含M合法?Ant 标签?
Z执行在maven.xml中定义的目标Q你只需要在命o行中为Maven指定目标名即可。要执行例子中定 义的nightly-build你只需执行命o:
maven nightly-build
Maven插g定义的目标需要在目标前加上插件名Q这样一来，׃会和你自qgoal冲突Q如 jar:jar是 jar 插g定义的目标，用于创徏目的jar包?
Jelly~程
在每个目标里Q由Jelly标签提供功能Q让我们来看看例子里的这些代码?
set
q行是一个jelly的core标签setQ它使用了project节点中定义的前缀 j:
set标签讄了一个由var属性定义的Jelly变量Q值由 value 指定。和Ant的proerties不一PJelly变量在被赋值后仍可以改变?
mkdir
{同于Antd mkdir, 用于创徏目录Q目录名由变?${maven.build.dir}指定?
tokenize
${goals}
q行执行的是Jelly tokenize 标签。这是Jelly util 标签库中标签Q?q个标签库已l在目节点中预先定义：u:
tokenize标签在将节点中的内容分离成一个listQ用于后l的处理?
- var 属性就是将被于新list的变量?
- delim 属性是用于分割字符串中的分隔符?
- 在这个例子中Qtokenize 标签中节点值是一个变量：goals, 在前几行中，q是一个由逗号分隔、compile ?test 的字W串?
forEach
Now attaining goal number ${goalNumber}, which is ${goal}
forEach标签提供单@环功能，节点值就是@环体?
- items 属性是一个表辑ּQ是在@环过E中需要遍历的值集合?
- 集合中的D逐个取出Q存攑֜var 属性指定的变量中。你可以?forEach 循环体访问这个变量?
- indexVar 属性指定了一个计数器(起始基数?)变量Q用于在处理 q程中计数?
forEach 标签的节点DZ一些在处理q程中的关于目标的文本，q?attainGoal werkz 标签来获?执行?)q些目标?
Maven 配置
属性的处理机制
Maven按下面的序依次dproperties文gQ?- ${project.home}/project.properties
- ${project.home}/build.properties
- ${user.home}/build.properties
d的属性遵?#8220;最后的定义有效”原则。也是_Maven依次dproperties文gQ以新的定义 覆盖旧的定义?{user.home}/build.properties是Maven最后处理的文g。我们把 q些文gUCؓMaven处理的标准属性文仉?
另外Q上qproperties文g处理完毕后，Maven才会开始处理系l属性。所以，如果在命令行中??Dproperty=valueq样的Ş式来指定的属性，它会覆盖先前定义的同名属性?
插g的属?/a>
上述属性文件处理完后，Maven才会开始调用插Ӟ但是 PluginManager 会禁止插?覆盖已经讄的属性倹{这和Maven一般的属性处理方式是相反的，q是因ؓ插g只能在Maven内部?其他部分初始化完毕后才能处理Q但是我们又希望以这样顺序去处理属性：
- 处理Plug-in ~省属?
- 处理${project.home}/project.properties
- 处理${project.home}/build.properties
- 处理${user.home}/build.properties
q样一来，即插g处于属性处理链的后端，也能覆盖插g的Q何缺省属性。例如，Checkstyle插g 定义了如下~省属性：
maven.checkstyle.format = sun
你可能已l猜出来了，Checksytle插g把Sun的编码规范作为缺省的格式。但是我们仍然可以在标准属?文g集的M一个文件中覆盖q个属性。所以如果在${project.home}/project.properties 文g定义了如下属性|
maven.checkstyle.format = turbine
Checkstyle׃使用Turbine的编码规范?
行ؓ属?/a>
下面的这些属性可以改变Maven?#8220;行ؓ方式”?
属?
描述
~省?
maven.build.dest
目录名，存放~译生成的类
${maven.build.dir}/classes
maven.build.dir
存放构徏l果的目录，如类文gQ文档，单元试报告{等?
注意Q?/strong> ?{user.home}/build.properties文g中改变maven.build.dir 的缺省值或怼得到一?较ؓ个性化的目录布局。但是，q会q扰Maven׃源码开始的~译工作Q因为它假设jar?会被创徏?{basedir}/target/目录中?
${basedir}/target
maven.build.src
源码目录
${maven.build.dir}/src
maven.conf.dir
配置文g目录
${basedir}/conf
maven.docs.dest
html格式报告的输出目?
${maven.build.dir}/docs
maven.docs.omitXmlDeclaration
产生的文档所应包含的xml声明_如：
false
maven.docs.outputencoding
生成文档的缺省编?
ISO-8859-1
maven.docs.src
用户提供的文档目?
${basedir}/xdocs
maven.gen.docs
xdocs文档转换成html后的输出目录
${maven.build.dir}/generated-xdocs
maven.home.local
maven用于写入用户信息的本机目录，如解开插g包、缓冲数据?
${user.home}/.maven
maven.mode.online
是否q接internet
true
maven.plugin.dir
插g的存攄?
${maven.home}/plugins
maven.plugin.unpacked.dir
用于展开安装插g的目?
${maven.home.local}/plugins
maven.repo.central
在进行dist:deploy处理的时候，发行包所要部|的目标机器
login.ibiblio.org
maven.repo.central.directory
在进行dist:deploy处理的时候，发行包所要部|的目标目录?
/public/html/maven
maven.repo.local
本机repositoryQ用于存储下载的jar包?
${maven.home.local}/repository
maven.repo.remote
q程repositoryQ如果本机repository没有的jar包，maven会从q里下蝲?
http://www.ibiblio.org/maven
maven.repo.remote.enabled
是否使用q程repository?
true
maven.scp.executable
用于安全拯的可执行E序
scp
maven.src.dir
基础源代码目?
${basedir}/src
maven.ssh.executable
q程命o可执行程?
scp
使用代理
如果你只能通过代理讉KQ不要紧QMavenZ提供了下列属性：
代理属?
描述
maven.proxy.host
代理的IP地址
maven.proxy.port
代理端口
maven.proxy.username
如果代理需要认证的话，在这里填写用户名?User name if your proxy requires authentication.
maven.proxy.password
如果代理需要认证的话，在这里填写密码?
如果你实在需要代理，最好在${user.home}/build.properties文g中指定?
## ----------------------------------------------------------
## ${user.home}/build.properties
## ----------------------------------------------------------
.
.
maven.proxy.host = my.proxyserver.com
maven.proxy.port = 8080
maven.proxy.username = username
maven.proxy.password = password
.
.
使用多个q程Repositories
你可以在MMaven可以处理的属性文件中指定使用多个q程RepositoriesQ如Q?
maven.repo.remote = http://www.ibiblio.org/maven/,http://www.mycompany.com/maven/
目讄
开始一个新目
如果你是W一ơ用MavenQ或者开始一个新的项目，你可以用GenApp来自动创建Maven目树?
maven -Dpackage=com.mycompany.app genapp
执行该命令后Q屏q显C如下：
__ __
| / |__ Jakarta _ ___
| |/| / _ V / -_) ' ~ intelligent projects ~
|_| |___,_|_/___|_||_| v. 1.0-beta-9
[mkdir] Created dir: /genapp/src/java/com/mycompany/app
[copy] Copying 1 file to /genapp/src/java/com/mycompany/app
[mkdir] Created dir: /genapp/src/test/com/mycompany/app
[copy] Copying 3 files to /genapp/src/test/com/mycompany/app
[copy] Copying 2 files to /genapp
[copy] Copying 1 file to /genapp/src/conf
BUILD SUCCESSFUL
Total time: 3 seconds
执行完毕Q即生成下面的完整项目目录树Q?
.
|-- project.properties
|-- project.xml
`-- src
|-- conf
| `-- app.properties
|-- java
| `-- com
| `-- mycompany
| `-- app
| `-- App.java
`-- test
`-- com
`-- mycompany
`-- app
|-- AbstractTestCase.java
|-- AppTest.java
`-- NaughtyTest.java
构徏
Maven采用了集中管理库的理c所有用于构建的jar包都是从集中理的中心库上取出。目前， 我们的中心库攑֜q儿 Ibiblio. 在一个典型的Maven目中，构徏所需?jar包会从中心库下蝲。Maven只会取回依赖链条上缺q包。如果你使用Maven来构建几个项目， q些目可能会共享一些依赖包QMaven可以在Q意个目中共享同一个包Q而无d同一pȝ 中保持一个jar包的多个拯?
构徏生命周期
在CVS中存放jar文g
我们不推荐你在CVS中存放jar包。Maven提倡在本机repository中存攄于构建共享的jar包或 和其他项目包。许多项目都依赖于诸如XML解析器、标准例E，q在Ant构徏中，l常会被复制 多䆾。在Maven中，q些标准例程存攑֜本地repository中，供Q何项目构Z用?
重蝲已声明的依赖?/a>
你可能会发现Q在某些情况下允讔R载POM中已l声明的依赖包会很方便，甚至很有必要?你可能会希望使用文gpȝ中的某个JAR包，或者你希望单重新指定某个包的版本。对?q样的情况，Maven提供了一U简单的方式Q允怽选择构徏所需的jar包。我们严重徏?) 你设|本机repositoryQ但是在单至上，或在由ant构徏q移的情况下QJAR包重载特?会显得非常方ѝ?
Z使用JAR包重载特性，你必dmaven.jar.override 属性设|ؓ on?只要讄了这个属性，可以在Mmaven处理的属性文件中重蝲JAR包?
关于JAR重蝲的指令有两种。第一U允怽指定某个特定的包的\径，作ؓJAR包；的二U?允许你指定某个特定的JAR包（q个jar包必dl存在于本机repositoryQ。下面是q两 U方式：
maven.jar.artifactId = [path]
maven.jar.artifactId = [version]
下面是一个用JAR重蝲指o的属性文件例子：
# ------------------------------------------------------------------------
# M A V E N J A R O V E R R I D E
# ------------------------------------------------------------------------
maven.jar.override = on
# ------------------------------------------------------------------------
# Jars set explicity by path.
# ------------------------------------------------------------------------
maven.jar.a = ${basedir}/lib/a.jar
maven.jar.b = ${basedir}/lib/b.jar
# ------------------------------------------------------------------------
# Jars set explicity by version.
# ------------------------------------------------------------------------
maven.jar.classworlds = 1.0-beta-1
使用SNAPSHOT依赖
在Maven中，SNAPSHOP是某个特定项目的最新构建的jar包。如果你的项目依赖于另一个频J变?的项目，你可以在你的POM中声明SNAPSHOP依赖Q以保持与那个项目的同步。例如，在你的POM?q样写，你可以与Jelly保持 同步更新?
...
commons-jelly
commons-jelly
SNAPSHOT
...
上述语句的含义是QL使用Maven repository中最新的Jelly构徏包。SNAPSHOT依赖 MD依赖p|。在q种情况下，Maven׃去Maven repository取得一个SNAPSHOT 依赖包的拯。如果你正在ȝ工作QMaven׃发出警告Q?#8220;SNAPSHO依赖包可能已l?q期”?
多项目构建和Reactor
在Maven中，Reactor是一个用于控制多目构徏的工兗Reactor用Werkz?q根据每个项?各自定义的依赖关pL安排构徏序。Reactor的意囑֜于：鼓励创徏/重构h更小、更松散?更有一致性单元的目。r源于面向lg~程Q在向组件编E中Q整个系l由许多松散的个?构成Q这些个体需要聚合v来作Z个整体进行部|Ӏ?
Reactor可以为某个项目集执行一个Q意编排的目标列表。所以，如果使用Reactor的话Q它 可以用来做项目站点生成，Ljar包生成这L事情?
目前 db.apache.org 站点是攉了其子项目的 丰富信息、ƈ与一pd?a >Velocity 模板合成的。这一q程是由 Jelly Velocity 标签库来完成的?a > q里是其中的机制Q有兴趣可以看看?
Plexus(一个基于Avalon的容?lg的manifest是遍历所有Plexuslg、ƈ聚合而成的。这?使用的还是Velocity模板和Jelly Volocity标签库?q里是其中的机制Q有兴趣可以看看?
q里是一个用Reactor标签Q遍历一pdlgQ最后生项目站点的例子Q?
... Do whatever you want with the harvested information ...
如果你需要聚合N个项目的文档QŞ成一个统一的视图，你可以参?db.apache.org站点Q它从所有的子项目中攉 信息Q最lŞ成一个有D条，邮g列表Q开发者列表和源码repositoryl一的站炏V这解决 了在攉子项目信息过E中的冗余、易于生错误的问题。db.apache.org的子目只需x 自n的信息，却可以自动的集成到高层的目站点中?
ȝ构徏
如果你需要离U构建，你得在命令行中用离UK项Q?
maven -o jar:jar
q等同于Q?
maven -Dmaven.mode.online=false jar:jar
或者你可以?a >属性文?/a>中设|?maven.mode.online 属性ؓfalse?
在联机模式下QmavenL下蝲 SNAPSHOT 依赖? 请参?使用SNAPSHOT依赖。如果本机repository 上的当前版本比服务器上的q要斎ͼ你也怸想maven覆盖你的当前版本。如果不想下载，你可?讄属性：
maven.repo.remote.enabled=false
在maven beta 9版本中，q个属性ƈ没有起作?新版本已l解决了q个问题)。可以这h清空 maven.repo.remote 属性：
maven.repo.remote.enabled=
在命令行或属性文件中讄都一栗?
在下面的情Ş中，你需要同时设|maven.repo.remote.enabled=false maven.mode.online=trueQ希望javadoc插g?-link"选项起作用，而又不希?下蝲M(包括snapshot)包?
命o行选项介绍
如果你用命o行来构徏Q这里提供了一个关于命令行选项的快速参考?
Options:
-D,--define arg 定义一个系l属?
-E,--emacs 输出z的日志信息
-X,--debug 输出debug信息
-b,--nobanner 止 logo banner
-d,--dir arg 讄指定的工作目?
-e,--exception 输出异常堆栈信息
-f,--find arg 通过搜寻目文g来确定执行的目文g及其工作目录
-g,--goals 昄可用的目?
-h,--help 昄帮助信息
-i,--info 昄pȝ信息
-o,--offline ȝ构徏
-p,--pom arg 指定目文g
-v,--version 昄版本?
试
试资源
通常情况下，你需要在试c\径上为测试指定某些资源。你可以在POM中?
下面的例子说明了如何递归的包含在${basedir}/src/test目录中所有以.xml?properties为扩展名 的文Ӟ
...
...
...
${basedir}/src/test
**/*.xml
**/*.properties
下面的例子说明了如何递归的包含在${basedir}/src/test目录中所有以.xml?properties为扩展名 的文Ӟ但naughty.properties文g除外。请注意增加的project/build/unitTest/resources/excludes 节点Q?
...
...
...
${basedir}/src/test
**/*.xml
**/*.properties
naughty.properties
q行一个单独的试
下面的命令运行了一个单独的试Q?
maven -Dtestcase=org.foo.bar.MyTest test:single-test
打包
JAR 资源
...
${basedir}/src/conf
*.xml
*.properties
${basedir}/src/messages
org/apache/maven/messages
messages*.properties
部v
固化SNAPSHOT依赖
在开发时使用SNAPSHOT依赖包非常方便，但是在部|的时候，你需要把所有的SNAPSHOT依赖?固定下来Q以便发布一个包含固定jar的版本。如果你发布了一个含SNAPSHOT依赖包的目Q?q些SNAPSHOT在项目发布后发生了变_你可能很快就会发现这个版本没法儿工作?
当SNAPSHOT以时间戳为版本号部v到Maven上时QMaven可以识别foo-SNAPSHOT.jar实际上相?于foo-20030101.010101.jar。当部v的时L_你可以用下面的命令，让Maven把SNAPSHOT 版本号变为时间戳版本受?
maven convert-snapshots
Maven会提供交互的方式让你选择哪个SNAPSHOPT依赖包应该固化下来。这一q程l束后，Maven ׃把刚才你的选择写会你的POM?
如果你希望Maven单的、尽可能最好的固化SNAPSHOT依赖包，你可以用下面的命令：
maven convert-snapshots-auto
拯依赖JAR?/a>
在maven.xmlq样写下面的语句是最单的拯依赖包的Ҏ?
...
...
用deploy:copy-deps标签你就可以单的把项目所有的依赖包拷贝到M 目录Q如果希望排除某个依赖包Q需要给Z个依赖包的id列表Q列表中依赖包就不会被拷贝?
...
...
命名U定
q部分将要的描述目对象模型(POM)中命名约定。本文档希望可以统一各式各样jar包命?ҎQ这些jar包一般ؓjava开发者社区广泛用?
规则和指?/a>
目
一个项目必ȝ一个唯一的的标识Q标识由a-z写字母和连U号构成Q其首字母必M写字母 开头?
bar
foo
...
所有项目间的引用都qid和包id构成。到现在为止Q在POM与此相关的是下面要Q上面提到的Q）谈到的项目的 依赖声明?
目的名U应该易于阅读，可用于文档?
bar
foo
The Grand Master Foo
...
目应该有一个组标识Q组标识是名U的基础部分?
bar
foo
The Grand Master Foo...
所有项目发布的包都应基于项目唯一的标识，q且攑֜Z目的组id的目录中。对于上面的 目来说Q假定发布的包是jarcd的包Q我们就会有如下目录l构Q?
repository
|
+-- bar
|-- distribution
`-- jar
|-- foo-1.0.jar
`-- foo-2.0.jar
依赖
一个理想的典型依赖声明的例子可能会象这P
yourProject
yourArtifact
Your Groovey Machine
...
bar
foo
1.0
q样一来，依赖于id为foo1.0 版本的bar目 属于org.foo.barl。这个依赖会被解析ؓ本地repository中jar文g。上?的情形假定发布的包是Z包id命名的。因此对于上qC赖，Maven׃采用 foo-1.0.jar作ؓjar名?
像用户反映的那Pq种理想的方式ƈ不能适应所有的目。有几种情Ş我们必须考虑调整 理想的依赖机Ӟ- 发布的jar包的q未使用目作ؓ基础名，如xercesImpl是所有发布的jar包的基础?它与gump id和maven中的id都不一栗?
- 发布的jar包没有用Q何版本声明，如许多commonslgq没有把版本号作为包名的一部分?
- 有些目x有用项目id作ؓ基础名也没有版本声明。例如，最坏的情Ş是Java Activation Framework 的jar包，它没有遵循其他Sun的命名规则，也没有在jar包中声明 版本P甚至在manifest中都没有M版本信息?
在多数情形下QQ何例外的情况都可以用 (可选节?、或者是重命名来解决?现在Q许多Jarkata的品在repository已经被重命名Q因为在不久的未来，l大多数的Jarkarta?目用mavenq行构徏。但q不是公司政{，我们不需要解x有情늚问题?
发布多个包的目
Maven的依赖机制完全支持Q何Ş式的多项目包?Maven's dependency mechanism completely supports multiple project artifacts of any given type.
下面的代码包含了ant的主jar包和optional包加上hypothetical包?
ant
ant
1.4.1
ant
ant-optional
1.4.1
ant
poorly-named
1.4.1
所以A), B) ?C)实际上是指向属于同一l的单个包的指针Q这是_一个单独的依赖是Ҏ个组中的某个 包的引用。目前artifact如果没有特别说明的话Q一般指的是jar包。但是依赖也可能是一个war文g或一?发行包。我们试囑֜提供多数情况?构徏大多需要jar?使用的缺省方式的同时Q也֏灉|性?
q程Repository布局
q部分文档将对Maven的远Erepositories做一个概要的说明。目前，主repository位于 IbiblioQ但是你也可以自己创Z 个远ErepositoriesQ其l果描述可以在这部分文档中找到?
M独立的项目在repository都有自己的目录。每个项目有一个唯一的项目id和同名目录， 目的发行包放在这个目录中?
目的目录中可以存放各种各样的artifactsQ目前最为广泛用的两种cd是jar包和发行?下面是一个远Erepository快照Q?
repository
|
|-- ant
| |-- distribution
| `-- jars
| |-- ant-1.4.1.jar
| `-- ant-optional-1.4.1.jar
+-- jsse
|-- distribution
`-- jars
|-- jsse.jar
|-- jcert.jar
`-- jnet.jar
本地Repository布局
应该有一个接口集合的紧凑实现使本地repository目录l构更加随意一些。现在我只?了一个类来实玎ͼ昑־有些臃肿。我q是认ؓ本地和远Erepositories应保持相同的l构 但是Z使用更乐于用，我开始设计一些接口，用于满用户自己安排自己本地Repository 布局Q相似的q程Repositor也在设计中。尽目前本地repository仍与q程repository 完全一_我希望听到更多的用户反馈Q以促进q些接口的开发，或者完全抛弃它?
生成目站点
Maven可以为项目生一个完成的web站点。这个web站点包含各U各栗由许多Maven插g 产生的报告，如javadocsQ代码度量，单元试QchanglogQ及其它... 本节文档接下来的 部分阐qMaven支持的站点定刉项?
颜色
考虑C致性，~省情况下，所有Maven产生的站炚w使用怼的外观。这使用户一眼就?认出由Maven产生的站点，产生熟悉的感觉，更加方便信息的获取。当ӞMaven开发组?考虑到用户可能会希望定制他们的站炏V修改Maven产生的站点，最单的Ҏ是指定你?使用的颜色搭配。这只需要在project.properties单的讄适当的属?卛_。下面是所有可用的属性描q在 xdoc plugin?
风格
如果你感觉颜色太q于单，无法满你的要求Q你可以用自qstylesheet。ؓ了重??{basedir}/xdocs/stylesheets/中的maven.css stylesheetQ你可以通过讄maven.javadoc.stylesheet 属性来指定你的 javadoc风格?
报告
最后，如果你希望定制哪些报告需要自动生，你需要在你的目描述中包?reports 标签库?到目前ؓ止，如果没有reports标签指定Q所有插件报告都会生。这个标{?允许你选择产生哪些报告而排斥另外一些报告，而且允许你安排顺序?
目前的标?报告集在xdoc中是编码实现的Q它们是Q?
maven-changelog-plugin
maven-changes-plugin
maven-checkstyle-plugin
maven-developer-activity-plugin
maven-file-activity-plugin
maven-javadoc-plugin
maven-jdepend-plugin
maven-junit-report-plugin
maven-jxr-plugin
maven-license-plugin
maven-linkcheck-plugin
maven-pmd-plugin
maven-tasklist-plugin
如果你希望生缺省的报告Q但是还惛_加或删除一两个Q最好的Ҏ是：l?xdoc:register-reports目标写一个前|目?postGoal)?br />
排除所有Maven产生的内?/a>
某些情况下，用户需要构建只有文档的站点Q或是构合许多子目的站点，但不希望 在站点上有个整体“目文档”D条。设|?maven.xdoc.includeProjectDocumentation属性gؓno 卛_解决q一问题。缺省的QMaven会包?#8220;目文档”D条，下面挂的是许多Maven 生成的报告?"
]]> - xmlns:j="jelly:core"
2. make first Maven 78
cmd: mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
notice: archetype==template -D看cmd-> mvn -help
生一个pom.xml(project object model)文g
maven工程产生Q?br /> mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
文档产生Q?br />
mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
-DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-site
格式(大概)如下
project
modelVersion使用pom的版本号
groupId lID 如org.apache.maven.plugins或com.sourceware
artifactId cM工程名unique
packaging打包(jar或war,ear由artifactId的extension?br />
version该工E的版本?br />
name昄名称在文档里
url url在文档里
description描述在文档里
更详l的见maven.htm(?
mvn的命令在maven-command.htm?/p>
MAVEN与ANT整合如下
<project>
<modelVersion>4.0.0</modelVersion>
<artifactId>my-test-app</artifactId>
<groupId>my-test-group</groupId>
<version>1.0-SNAPSHOT</version>
<build>
<plugins>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<phase>generate-sources</phase>
<configuration>
<tasks>
<!--
Place any ant task here. You can add anything
you can add between <target> and </target> in a
build.xml.
-->
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
So a concrete example would be something like the following:
<project>
<modelVersion>4.0.0</modelVersion>
<artifactId>my-test-app</artifactId>
<groupId>my-test-group</groupId>
<version>1.0-SNAPSHOT</version>
<build>
<plugins>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<phase>generate-sources</phase>
<configuration>
<tasks>
<exec
dir="${basedir}"
executable="${basedir}/src/main/sh/do-something.sh"
failonerror="true">
<arg line="arg1 arg2 arg3 arg4" />
</exec>
</tasks>
</configuration>
<goals>
<goal>run</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
]]>
]]>
声明:本节内容来源?a href="http://www.aygfsteel.com/jbob/" target="_top">blogjava|站jbob的blog 本节的版权归原作者所有，不适用本手册的版权x?/em>
maven是一个java目理工具Q深化了antQ但又有自己一整套的项目集成策略。目前的版本?.0.2?
-
maven|站 下蝲maven2Q解压羃
-
配置环境变量:maven_home、path
-
cmd-> mvn --version 查是否安装成?[昄版本P则说明安装成功]
-
配置,Maven的配|分Z个层?
-
- pom.xml:针对某个目的配|?/p>
-
Installation
-
User -针对某个用户的配|?/p>
我们首先配置主要是userU别的，主要包括两点:讄本地的资源库和代理服务器[如果需要的话] ?maven_home%/conf/setting.xml中配|?
<localRepository>d:/repo</localRepository>
<proxy>
<id>proxy1</id>
<active>true</active>
<protocol>http</protocol>
<username></username>
<password></password>
<host>222.136.91.1</host>
<port>80</port>
<nonProxyHosts></nonProxyHosts>
</proxy>
修改之后copy一份到${home}/.m2
-
-
建立新的目
mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
-
首先Q程序会从远E下载必要的jar包到你的localRepository,x们刚刚设|的[d:/repo]
-
然后Q会在当前目录下面生成my-app文g夹，包括单的包结构[java,test]和一个HelloWorldE序及测?以及pom.xml文g?
注意Qpom.xml contains the Project Object Model (POM) for this project.The POM is the basic unit of work in Maven?
-
-
~译
mvn compile
W一ơ运行会下蝲很多jar?而且机器负荷会很重。运行这个命令需要在pom.xml相同目录下面, q个~译只编译主E序Q不会编译test下面的程序。如果需要单独编译test,误行：
mvn test-compile
compile之后会生成target文g夹，ȝ序编译在classes下面Q测试程序放在test-classes?/p>
-
试
mvn test
会自动先~译再运行测?/p>
-
打包
mvn package
打包之前会进行编译，试
-
安装
mvn install
会将package之后的jar包copy?/p> <local-repository>/com/mycompany/app/my-app/1.0-SNAPSHOT/my-app-1.0-SNAPSHOT.jar
-
其他
mvn site
注意,q可?
deploy site
在pom.xml中加?/p>
<distributionManagement>
<site>
<id> website </id>
< url> scp://www.mycompany.com/www/docs/project/ </url>
</site>
</distributionManagement>
当然你需要设|server
mvn site-deploy
mvn clean
mvn idea:idea [为IDE工具idea生成目文g]
-
Resource
${basedir}/src/main/resources都会~译到jar文g?而且该目录下的内容将直接位于jar文g的顶部?/p>
试用资源文?> ${basedir}/src/test/resourcesQ引用时如下例：
InputStream is = getClass().getResourceAsStream( "/test.properties" );
文g位于 ${basedir}/src/test/resources/test.properties?/p>
-
如何filter我们的资源文?/p>
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
因ؓ原来默认的filter为false所以要加上上面的代?/p>
eg:我们在src/main/resources下面建立application.properties文g
# application.properties
application.name=${pom.name}
application.version=${pom.version}
q行Qmvn process-resources 在target/classes下面的application.propertiesl果为：
# application.properties
application.name=Maven Quick Start Archetype
application.version=1.0-SNAPSHOT
q就是所谓的filter。当然filterq可以用其他的外部文Ӟ不一定来自pom.xml[ ${pom.name} ]以及setting.xml[ ${settings.localRepository }]
e.g src/main/filters/filter.properties:
# filter.properties
my.filter.value=hello!
pom.xml:
< build >
< filters >
< filter > src/main/filters/filter.properties </ filter >
</ filters >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build ># application.properties
application.name=${pom.name}
application.version=${pom.version}
message=${my.filter.value}
q样在运行mvn process-resources 会得到类似的效果,当然我们也可以直接在pom.xml中定义：
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
< properties >
< my .filter.value > hello </ my.filter.value >
</ properties >效果同样Q这样就不需要外部文件了。另外filterq可以来自系l设|以及可以自定义Q?/p>
# application.properties
java.version=${java.version}
command.line.prop=${command.line.prop}
-
jar包依?/p>
我们在mvn install后在local repo中生成的jar包也可以被其他项目所引用
<dependency>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1.0-SNAPSHOT</version>
<scope>compile</scope>
</dependency>注意scope,q里是compile,如果使用junitQscope是test?/p>
举例说明Q如果我们的project需要用到log4j包，那么我们可以 先google--"site:www.ibiblio.org maven2 log4j"。Index of /maven2/log4j/log4j 下面有maven-metadata.xml 描述了groupId,artifactId,version{等。获取了q些信息之后Q你 可以在pom.xml中添加依?/p>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
<scope>compile</scope>
</dependency> -
如何发布我的jar包到我的remote repository
你需要在setting.xml中间讄server:
<servers>
<server>
<id>mycompany-repository</id>
<username>jvanzyl</username>
<!-- Default value is ~/.ssh/id_dsa -->
<privateKey>/path/to/identity</privateKey>
<passphrase>my_key_passphrase</passphrase>
</server>
</servers>然后在pom.xml中设|远Eurl:
<distributionManagement>
<repository>
<id>mycompany-repository</id>
<name>MyCompany Repository</name>
<url>scp://repository.mycompany.com/repository/maven2</url>
</repository>
</distributionManagement>
你可以从http://m2eclipse.codehaus.orgupdate安装Maven2的Eclipse插gQ具?安装步骤L该网站提供的Flash Demo: http://m2eclipse.codehaus.org/Installing_Maven_2.0_plugin_for_Eclipse.html
该插件的使用L该网站提供的Flash Demo: http://m2eclipse.codehaus.org/Maven_2.0_Plugin_for_Eclipse.html
关于openfan目的Maven操作请参看后l章节?/p>
]]>
- 下蝲maven 2 [链接]Q解压羃?
- 配置环境变量Qmaven_home, path
- cmd-> mvn --version 查是否安装成?[昄版本P则说明安装成功]
- 配置
Maven的配|分Z个层?br />
Project - pom.xmlQ针Ҏ个项目的配置
Installation
User -针对某个用户的配|?br />
我们首先配置主要是userU别的，主要包括两点
讄本地的资源库和代理服务器[如果需要的话]
?maven_home%/conf/setting.xml中配|?
<localRepository>d:/repo</localRepository>
<proxy>
<id>proxy1</id>
<active>true</active>
<protocol>http</protocol>
<username></username>
<password></password>
<host>222.136.91.1</host>
<port>80</port>
<nonProxyHosts></nonProxyHosts>
</proxy>
- 建立新的目
mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
首先Q程序会从远E下载必要的jar包到你的localRepository,x们刚刚设|的[d:/repo]
然后Q会在当前目录下面生成my-app文g夹，包括单的包结构[java,test]和一个HelloWorldE序及测试?br /> 以及pom.xml文g?br /> 注意Qpom.xml contains the Project Object Model (POM) for this project.
The POM is the basic unit of work in Maven?br /> - ~译
mvn compile
W一ơ运行会下蝲很多jar包。而且机器负荷会很重?br /> q行q个命o需要在pom.xml相同目录下面
q个~译指挥~译ȝ序，不会~译test下面的程序?br /> 如果需要单独编译test,误?mvn test-compile
compile之后会生成target文g夹，ȝ序编译在classes下面Q测试程序放在test-classes?br /> - 试
mvn test. 会自动先~译在运行测?br /> - 打包
mvn package
打包之前会进行编译，试 - 装[install]
mvn install
会将package之后的jar包copy?br /> <local-repository>/com/mycompany/app/my-app/1.0-SNAPSHOT/my-app-1.0-SNAPSHOT.jar - 其他
mvn site
注意Q还可以deploy site
在pom.xml中加? < distributionManagement >
< site >
< id > website </ id >
< url > scp://www.mycompany.com/www/docs/project/ </ url >
</ site >
</ distributionManagement >
当然你需要设|server
mvn site-deploy
mvn clean
mvn idea:idea [为IDE工具idea生成目文g] -
Resource
${basedir}/src/main/resources都会~译到jar文g?br /> ?{basedir}/src/main/resources 下的内容会直接位于jar文g的顶?br /> 试用资源文?> ${basedir}/src/test/resources
引用时参照此例：
InputStream is = getClass().getResourceAsStream( "/test.properties" );
文g位于 ${basedir}/src/test/resources/test.properties?/p> -
如何filter我们的资源文?br /> 在pom.xml中修改：
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
因ؓ原来默认的filter为false所以要加上上面的代?br /> e.g
我们在src/main/resources下面建立application.properties文g
# application.properties
application.name=${pom.name}
application.version=${pom.version}
q行Qmvn process-resources
在target/classes下面Q?br /> application.properties:
# application.properties
application.name=Maven Quick Start Archetype
application.version=1.0-SNAPSHOT
q就是所谓的filter.
当然filterq可以用其他的外部文Ӟ不一定来自pom.xml[ ${pom.name} ]以及setting.xml[ ${settings.localRepository }]
e.g
src/main/filters/filter.properties
# filter.properties
my.filter.value=hello!
pom.xml < build >
< filters >
< filter > src/main/filters/filter.properties </ filter >
</ filters >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
# application.properties
application.name=${pom.name}
application.version=${pom.version}
message=${my.filter.value}
q样在运行mvn process-resources 会得到类似的效果?/p>当然我们也可以直接在pom.xml中定义：
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
< properties >
< my .filter.value > hello </ my.filter.value >
</ properties >
效果同样Q这样就不需要外部文件了另外filterq可以来自系l设|以及可以自定义Q?br /> # application.properties
java.version=${java.version}
command.line.prop=${command.line.prop} - jar包依?br />
我们在mvn install后在local repo中生成的jar包也可以被其他项目所引用
注意scope,q里是compile,如果使用junitQscope是test.<dependency>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1.0-SNAPSHOT</version>
<scope>compile</scope>
</dependency>
举例说明
如果我们的project需要用到log4j包，那么我们可以先google--"site:www.ibiblio.org maven2 log4j".
Index of /maven2/log4j/log4j 下面有maven-metadata.xml 描述了groupId,artifactId,version{等?br /> 获取了这些信息之后，你就可以在pom.xml中添加依赖了
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
<scope>compile</scope>
</dependency>
14 如何发布我的jar包到我的remote repository
你需要在setting.xml中间讄server
然后在pom.xml中设|远Eurl<servers>
<server>
<id>mycompany-repository</id>
<username>jvanzyl</username>
<!-- Default value is ~/.ssh/id_dsa -->
<privateKey>/path/to/identity</privateKey>
<passphrase>my_key_passphrase</passphrase>
</server>
</servers>
<distributionManagement>
<repository>
<id>mycompany-repository</id>
<name>MyCompany Repository</name>
<url>scp://repository.mycompany.com/repository/maven2</url>
</repository>
</distributionManagement>
使用maven2 构徏 Webapp应用E序
Z以下框架Q?br /> spring,hibernate,webwork.2.2.2
1. mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
2. dmain/java test/java 文g?br /> 3. 构徏pom.xml.d相关依赖Q?br /> 注意以下几点Q?br /> spring:使用id:org.springframework
hibernate: org.hibernate
中途会出现错误。因为jta下蝲不到Q因为licenese的原?br /> jta需要自׃载：java.sun.com/products/jta
下蝲回来?使用jar命o打包 攑ֈ本地Repo?br /> 4.配置pom
<resources>
<resource>
<directory>src/main/resources</directory>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
<testResources>
<testResource>
<directory>src/test/resources</directory>
</testResource>
<testResource>
<directory>src/main/webapp</directory>
<includes>
<include>**/*.xml</include>
</includes>
</testResource>
</testResources>
5.我们用到了jetty6来自动化部v
<plugins>
<plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>maven-jetty6-plugin</artifactId>
<version>6.0.0beta14</version>
</plugin>
</plugins>
mvn package 之后可以mvn jetty6:run
启动之后Q可以在另一个进E mvn compile.冒死可以热交?br /> 在mvn jetty6:run的console Ctrl+c可以停止q程
Q?文g攄位置Q?br /> resource/ Q?br /> log4j.xml ,webwork相关Qehcache.xml, spring配置文g的properties文gQ比如jdbc.properties
webapp/web-inf Q?br /> applicationContext,web.xml
hbm攑֜java里面
7. 其他相关
在webwork2.2中，不再需要通过ActionAutoWiringInterceptor来给Action注入Spring的bean(q种方式仍然保留在xwork1.1?Q改用了另一U更加方便的方式WebWorkSpringObjectFactoryQ配|方式如下：
在webwork.properties中加入如下配|内容：webwork.objectFactory=spring
#以下配置可?br /> #webwork.objectFactory.spring.autoWire=nameq样可以了Q?br /> 在Action中声明需要某Spring beanQ就会自动注入进来?/p>autowire的方式有四种QnameQtypeQautoQconstructorQ默认方式是nameQautowire语义是Spring的语?br /> 另外不推荐用spring理action
使用maven2 构徏 Webapp应用E序
Z以下框架Q?br /> spring,hibernate,webwork.2.2.2
1. mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-webapp -DarchetypeArtifactId=maven-archetype-webapp
2. dmain/java test/java 文g?br /> 3. 构徏pom.xml.d相关依赖Q?br /> 注意以下几点Q?br /> spring:使用id:org.springframework
hibernate: org.hibernate
中途会出现错误。因为jta下蝲不到Q因为licenese的原?br /> jta需要自׃载：java.sun.com/products/jta
下蝲回来?使用jar命o打包 攑ֈ本地Repo?br /> 4.配置pom
<resources>
<resource>
<directory>src/main/resources</directory>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
<testResources>
<testResource>
<directory>src/test/resources</directory>
</testResource>
<testResource>
<directory>src/main/webapp</directory>
<includes>
<include>**/*.xml</include>
</includes>
</testResource>
</testResources>
5.我们用到了jetty6来自动化部v
<plugins>
<plugin>
<groupId>org.mortbay.jetty</groupId>
<artifactId>maven-jetty6-plugin</artifactId>
<version>6.0.0beta14</version>
</plugin>
</plugins>
mvn package 之后可以mvn jetty6:run
启动之后Q可以在另一个进E mvn compile.冒死可以热交?br /> 在mvn jetty6:run的console Ctrl+c可以停止q程
Q?文g攄位置Q?br /> resource/ Q?br /> log4j.xml ,webwork相关Qehcache.xml, spring配置文g的properties文gQ比如jdbc.properties
webapp/web-inf Q?br /> applicationContext,web.xml
hbm攑֜java里面
7. 其他相关
在webwork2.2中，不再需要通过ActionAutoWiringInterceptor来给Action注入Spring的bean(q种方式仍然保留在xwork1.1?Q改用了另一U更加方便的方式WebWorkSpringObjectFactoryQ配|方式如下：
在webwork.properties中加入如下配|内容：webwork.objectFactory=spring
#以下配置可?br /> #webwork.objectFactory.spring.autoWire=nameq样可以了Q?br /> 在Action中声明需要某Spring beanQ就会自动注入进来?/p>autowire的方式有四种QnameQtypeQautoQconstructorQ默认方式是nameQautowire语义是Spring的语?br /> 另外不推荐用spring理action
]]>
声明:本节内容来源?a href="http://www.aygfsteel.com/jbob/" target="_top">blogjava|站jbob的blog 本节的版权归原作者所有，不适用本手册的版权x?/em>
maven是一个java目理工具Q深化了antQ但又有自己一整套的项目集成策略。目前的版本?.0.2?
-
maven|站 下蝲maven2Q解压羃
-
配置环境变量:maven_home、path
-
cmd-> mvn --version 查是否安装成?[昄版本P则说明安装成功]
-
配置,Maven的配|分Z个层?
-
- pom.xml:针对某个目的配|?/p>
-
Installation
-
User -针对某个用户的配|?/p>
我们首先配置主要是userU别的，主要包括两点:讄本地的资源库和代理服务器[如果需要的话] ?maven_home%/conf/setting.xml中配|?
<localRepository>d:/repo</localRepository>
<proxy>
<id>proxy1</id>
<active>true</active>
<protocol>http</protocol>
<username></username>
<password></password>
<host>222.136.91.1</host>
<port>80</port>
<nonProxyHosts></nonProxyHosts>
</proxy>
修改之后copy一份到${home}/.m2
-
-
建立新的目
mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
-
首先Q程序会从远E下载必要的jar包到你的localRepository,x们刚刚设|的[d:/repo]
-
然后Q会在当前目录下面生成my-app文g夹，包括单的包结构[java,test]和一个HelloWorldE序及测?以及pom.xml文g?
注意Qpom.xml contains the Project Object Model (POM) for this project.The POM is the basic unit of work in Maven?
-
-
~译
mvn compile
W一ơ运行会下蝲很多jar?而且机器负荷会很重。运行这个命令需要在pom.xml相同目录下面, q个~译只编译主E序Q不会编译test下面的程序。如果需要单独编译test,误行：
mvn test-compile
compile之后会生成target文g夹，ȝ序编译在classes下面Q测试程序放在test-classes?/p>
-
试
mvn test
会自动先~译再运行测?/p>
-
打包
mvn package
打包之前会进行编译，试
-
安装
mvn install
会将package之后的jar包copy?/p> <local-repository>/com/mycompany/app/my-app/1.0-SNAPSHOT/my-app-1.0-SNAPSHOT.jar
-
其他
mvn site
注意,q可?
deploy site
在pom.xml中加?/p>
<distributionManagement>
<site>
<id> website </id>
< url> scp://www.mycompany.com/www/docs/project/ </url>
</site>
</distributionManagement>
当然你需要设|server
mvn site-deploy
mvn clean
mvn idea:idea [为IDE工具idea生成目文g]
-
Resource
${basedir}/src/main/resources都会~译到jar文g?而且该目录下的内容将直接位于jar文g的顶部?/p>
试用资源文?> ${basedir}/src/test/resourcesQ引用时如下例：
InputStream is = getClass().getResourceAsStream( "/test.properties" );
文g位于 ${basedir}/src/test/resources/test.properties?/p>
-
如何filter我们的资源文?/p>
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
因ؓ原来默认的filter为false所以要加上上面的代?/p>
eg:我们在src/main/resources下面建立application.properties文g
# application.properties
application.name=${pom.name}
application.version=${pom.version}
q行Qmvn process-resources 在target/classes下面的application.propertiesl果为：
# application.properties
application.name=Maven Quick Start Archetype
application.version=1.0-SNAPSHOT
q就是所谓的filter。当然filterq可以用其他的外部文Ӟ不一定来自pom.xml[ ${pom.name} ]以及setting.xml[ ${settings.localRepository }]
e.g src/main/filters/filter.properties:
# filter.properties
my.filter.value=hello!
pom.xml:
< build >
< filters >
< filter > src/main/filters/filter.properties </ filter >
</ filters >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build ># application.properties
application.name=${pom.name}
application.version=${pom.version}
message=${my.filter.value}
q样在运行mvn process-resources 会得到类似的效果,当然我们也可以直接在pom.xml中定义：
< build >
< resources >
< resource >
< directory > src/main/resources </ directory >
< filtering > true </ filtering >
</ resource >
</ resources >
</ build >
< properties >
< my .filter.value > hello </ my.filter.value >
</ properties >效果同样Q这样就不需要外部文件了。另外filterq可以来自系l设|以及可以自定义Q?/p>
# application.properties
java.version=${java.version}
command.line.prop=${command.line.prop}
-
jar包依?/p>
我们在mvn install后在local repo中生成的jar包也可以被其他项目所引用
<dependency>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<version>1.0-SNAPSHOT</version>
<scope>compile</scope>
</dependency>注意scope,q里是compile,如果使用junitQscope是test?/p>
举例说明Q如果我们的project需要用到log4j包，那么我们可以 先google--"site:www.ibiblio.org maven2 log4j"。Index of /maven2/log4j/log4j 下面有maven-metadata.xml 描述了groupId,artifactId,version{等。获取了q些信息之后Q你 可以在pom.xml中添加依?/p>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
<scope>compile</scope>
</dependency> -
如何发布我的jar包到我的remote repository
你需要在setting.xml中间讄server:
<servers>
<server>
<id>mycompany-repository</id>
<username>jvanzyl</username>
<!-- Default value is ~/.ssh/id_dsa -->
<privateKey>/path/to/identity</privateKey>
<passphrase>my_key_passphrase</passphrase>
</server>
</servers>然后在pom.xml中设|远Eurl:
<distributionManagement>
<repository>
<id>mycompany-repository</id>
<name>MyCompany Repository</name>
<url>scp://repository.mycompany.com/repository/maven2</url>
</repository>
</distributionManagement>
你可以从http://m2eclipse.codehaus.orgupdate安装Maven2的Eclipse插gQ具?安装步骤L该网站提供的Flash Demo: http://m2eclipse.codehaus.org/Installing_Maven_2.0_plugin_for_Eclipse.html
该插件的使用L该网站提供的Flash Demo: http://m2eclipse.codehaus.org/Maven_2.0_Plugin_for_Eclipse.html
关于openfan目的Maven操作请参看后l章节?/p>
]]>
]]>