Maven 专题之一 (转自http://blog.csdn.net/maoxiang)

1  maven和ant的比较
 第一：每次和别人说maven的时候，很多会认为是全新的东西而不肯放弃ant。其实，ant脚本是可以直接运行在maven中的。
如果要说maven和ant有什么差别，我觉得最大的差别就是在于maven的编译以及所有的脚本都有一个基础，就是POM（project object model）。这个模型定义了项目的方方面面，然后各式各样的脚本在这个模型上工作，而ant完全是自己定义，显然maven更胜一筹。
第二：Maven对所依赖的包有明确的定义，如使用那个包，版本是多少，一目了然。而ant则通常是简单的inclde 所有的jar。导致的最终结果就是，你根本无法确定JBoss中的lib下的common－logging 是哪个版本的，唯一的方法就是打开 META－INF 目录下MANIFEST.MF。估计JBoss迟早会转向Maven的。
第三：Maven是基于中央仓库的编译，即把编译所需要的资源放在一个中央仓库里，如jar，tld，pom，等。当编译的时候，maven会自动在仓库中找到相应的包，如果本地仓库没有，则从设定好的远程仓库中下载到本地。这一切都是自动的，而ant需要自己定义了。这个好处导致的结果就是，用maven编译的项目在发布的时候只需要发布源码，小得很，而反之，ant的发布则要把所有的包一起发布，显然maven又胜了一筹。
第四：maven有大量的重用脚本可以利用，如生成网站，生成javadoc，sourcecode reference，等。而ant都需要自己去写。试试 maven site 的效果。
第五：maven目前不足的地方就是没有象ant那样成熟的GUI界面，不过mavengui正在努力中。目前使用maven最好的方法还是命令行，又快又方便。
 
最后，总结一下，转向maven会为你节省更多的时间。
 
2. build.properties 和project.properties
  build.properties 用来方编译信息比较好，project.properties用来放项目信息比较好。
Build.properties的实例，把他放在用户目录下（C:/Documents and Settings/user），就可以使用所有项目都共享这个信息。
maven.repo.local=f:/java/repository
maven.repo.remote=http://mirrors.sunsite.dk/maven/
 
#maven.proxy.host=127.0.0.1
#maven.proxy.port=80
 
maven.compile.target = 1.4
maven.compile.source = 1.4
 
3 如何进行多个项目的开发。
 
在用Maven进行一个项目下有多个子项目开发的时候，常用的就是MulitProject 脚本 <maven:reactor >。
 
举例来看，下图就是一个项目中的子项目，该子项目又有两个子项目，只要在project中定义了继承关系，1.0能够将maven.xml中的脚本及project.properties 和build.properties中的属性 传播到子项目中去，这个特性好像在RC版本中没有完全实现。
 
 知道了Maven 的这些特性，就可以将大量的公共脚本写在maven。xml中，子项目就可以很方便的调用了。
 
         <!--==================================================================-->
<!-- Hibernate Doclet-->
<!--==================================================================-->
<goal description="xdoclet for hibernate " name="project:hibernate-xdoclet">
<taskdef name="hibernatedoclet"
classname="xdoclet.modules.hibernate.HibernateDocletTask"
classpathref="maven.dependency.classpath"/>
<echo>+---------------------------------------------------+</echo>
<echo>| Hibernate Doclet......                                       |</echo>
<echo>+---------------------------------------------------+</echo>
<mkdir dir="${project.xdoclet.hibernate.destDir}"/>
<hibernatedoclet destdir="${project.xdoclet.hibernate.destDir}"
mergedir="${project.xdoclet.hibernate.mergeDir}"
excludedtags="${project.xdoclet.hibernate.excludedtags}"
addedtags="${project.xdoclet.hibernate.addedtags}"
force="${project.xdoclet.hibernate.force}"
verbose="${project.xdoclet.hibernate.verbose}">
<fileset dir="${project.xdoclet.hibernate.srcDir}">
<include name="**/*.java"/>
</fileset>
<hibernate version="2.0"/>
<!--
<jbossservice
transactionStrategy="${project.xdoclet.hibernate.jbossservice.transactionStrategy}"
userTransactionName ="${project.xdoclet.hibernate.jbossservice.userTransactionName}"
serviceName="${project.xdoclet.hibernate.jbossservice.serviceName}"
jndiName="${project.xdoclet.hibernate.jbossservice.jndiName}"
dataSource="${project.xdoclet.hibernate.jbossservice.dataSource}"
dialect="${project.xdoclet.hibernate.jbossservice.dialect}"
showSql="${project.xdoclet.hibernate.jbossservice.showSql}"
templateFile="${project.xdoclet.hibernate.jbossservice.templateFile}"
/>
-->
<hibernatecfg
transactionManagerLookup="${project.xdoclet.hibernate.cfg.transactionManagerLookup}"
transactionStrategy="${project.xdoclet.hibernate.cfg.transactionStrategy}"
userTransactionName
="${project.xdoclet.hibernate.cfg.userTransactionName}"
jndiName="${project.xdoclet.hibernate.cfg.jndiName}"
dataSource="${project.xdoclet.hibernate.cfg.dataSource}"
dialect="${project.xdoclet.hibernate.cfg.dialect}"
showSql="${project.xdoclet.hibernate.cfg.showSql}" />
</hibernatedoclet>
</goal>
 
在任何一个子项目中，就可以直接调用project:hibernate-xdoclet脚本了。就可以
 
<maven:reactor 的不足在于，如果你这样定义
<maven:reactor basedir="${basedir}" postProcessing="true"
includes="portal/project.xml,common/project.xml" goals="project:deploy"
banner="Deploying Service:" ignoreFailures="false" />
 
本来原意是想让Portal早于common进行编译，不过reactor实际将先编译common，再编译portal。因为他是以名称来决定编译次序，显然是不好的，因为多个子项目之间往往是有先后关系。解决的方法就是，定义多个reactor 了。
 
4 定义自己的maven.xml 模板。
 maven的脚本是基于AOP的，也就是你可以在任何一个goal之前和之后插入自己的代码，所以maven的脚本没有固定的写法。
这里有我写过的一个maven模板。
<?xml version="1.0" encoding="gb2312"?>
<project default="project:deploy" xmlns:maven="jelly:maven"
xmlns:j="jelly:core" xmlns:util="jelly:util">
<!-- 一般项目分为四个里程碑：初始化、精化、构建、部署 -->
<preGoal name="project:deploy">
<attainGoal name="project:inception"/>
<attainGoal name="project:elaboration"/>
<attainGoal name="project:construction"/>
<attainGoal name="project:transition"/>
</preGoal>
<goal name="project:deploy">
</goal>
<!--完成一些初始化工作 -->
<goal name="project:inception">
<attainGoal name="clean"/>
</goal>
<!-- 主要是xdoclet 产生各种文件-->
<goal name="project:elaboration">
    <attainGoal name="project:ejb-xdoclet"/>
</goal>
<!-- 编译项目-->
<goal name="project:construction">
<!-- 调用war 插件 -->
<attainGoal name="war:war"/>
</goal>
<!--
对编译好的项目进行组合准备部署
-->
<goal name="project:transition">
</goal>
</project>
 
5 很多公共脚本都不正常
这是很正常的事情，事实上很多脚本 xdoclet，middlegen等都存在一定的问题，如果出现这种情况，最直接的办法就是把它们的脚本自己封装一遍，做成适合自己的脚本。
比如，xdoclet 1.2之前的脚本就不太好用，我就到maven的cache目录（C:/Documents and Settings/user/.maven/cache），找到想修改的插件目录，里面都会有plugin.jelly,它是一个xml文件，里面就是脚本了，然后copy到自己的maven.xml中，就可以直接调用了。
以下，是我写的自己常用的web xdoclet脚本
 
         <!--==================================================================-->
<!-- WEB Doclet-->
<!--==================================================================-->
<goal description="xdoclet for web " name="project:web-xdoclet" >
<taskdef name="webdoclet" classname="xdoclet.modules.web.WebDocletTask"
classpathref="maven.dependency.classpath"/>
<echo>+---------------------------------------------------+</echo>
<echo>| Running WebDoclet...... |</echo>
<echo>+---------------------------------------------------+</echo>
<mkdir dir="${project.xdoclet.web.destDir}"/>
<webdoclet destdir="${project.xdoclet.web.destDir}"
mergedir="${project.xdoclet.web.mergeDir}"
excludedtags="${project.xdoclet.web.excludedtags}"
addedtags="${project.xdoclet.web.addedtags}"
force="${project.xdoclet.web.force}"
verbose="${project.xdoclet.web.verbose}">
<fileset dir="${project.xdoclet.web.srcDir}">
<include name="**/*.java"/>
</fileset>
<deploymentdescriptor servletspec="${project.xdoclet.web.version}"
destdir="${project.xdoclet.web.webxml.dir}"
xmlencoding="${project.xdoclet.web.xmlencoding}"
templateFile="${project.xdoclet.web.templateFile}" />
<strutsconfigxml
destdir="${project.xdoclet.web.strutsconfigxml.dir}"
xmlencoding="${project.xdoclet.web.strutsconfigxml.xmlencoding}"
version="${project.xdoclet.web.strutsconfigxml.version}"
templateFile="${project.xdoclet.web.strutsconfigxml.templateFile}"
/>
<jsptaglib jspversion="${project.xdoclet.web.jsptaglib.version}"
destdir="${project.xdoclet.web.jsptaglib.dir}"
shortname="${project.xdoclet.web.jsptaglib.shortname}"
validateXml="${project.xdoclet.web.jsptaglib.validatexml}"
xmlencoding="${project.xdoclet.web.jsptaglib.xmlencoding}"
filename="${project.xdoclet.web.jsptaglib.filename}"
templateFile="${project.xdoclet.web.jsptaglib.templateFile}" />
<!--
<jbosswebxml destdir="${project.xdoclet.web.jbosswebxml.dir}"
mergeDir="${project.xdoclet.web.jbosswebxml.dir}"/>
-->
</webdoclet>
</goal>
 
这个脚本可以生成web.xml struts-config.xml  tld jboss-web.xml ，自己可以根据需要很方便的修改了。其实不难看出，这些都是ant脚本。所以，如果没有合适的插件，最好的方法就是自己动手写一个。
 
6 无法运行maven，报错为 缺少根组件。
 这个错误是因为你采用的编辑器（比如：ultraedit）在<?xml 前添加了多余的字符，导致xml解析器无法处理xml文件，这个错误常常遇到。解决的方法就是把内容copy下来，重新paste到新的文件，覆盖老文件。或者用别的编辑器把多余字符去掉。