使用Maven构造Turbine项目

一 关于Maven

    它是一个命令行构建工具.本身配置比较简单.主要是几个环境变量的设置.

在${Maven.home}/bin/下有个批处理文件maven.bat,其中:

@REM ----------------------------------------------------------------------------

@REM JAVA_HOME - 一个JDK的主目录.

@REM MAVEN_HOME - Maven安装主目录位置.

@REM 可选的环境变量

@REM MAVEN_HOME_LOCAL - 覆盖Maven工作所产生的文件的缺省路径

@REM MAVEN_BATCH_ECHO - 设为'on'使能批处理命令的反馈

@REM MAVEN_BATCH_PAUSE - 设为'on',在结束前等待一个键的按下.

@REM MAVEN_OPTS - Maven运行时要传给Java VM的参数.例如,在调试Maven本身时,使用 set MAVEN_OPTS=-Xdebug -Xnoagent -Djava.compiler=NONE -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000

@REM ----------------------------------------------------------------------------

 

 

这个批提供了调用外部文件的设置:

if exist "%HOME%/mavenrc_pre.bat" call "%HOME%/mavenrc_pre.bat"

if exist "%HOME%/mavenrc_post.bat" call "%HOME%/mavenrc_post.bat"

为了修改一些配置和加入我们自己的配置项,我们使用mavenrc_pre.bat,其内容为:

把MAVEN_HOME_LOCAL指向i:/maven_plugin,可以使Maven在构建项目时所下载的插件放在这个目录中,而不是缺省的%HOME%/.maven中了.

set MAVEN_HOME_LOCAL=i:/maven_plugin

set MAVEN_BATCH_ECHO=off

set MAVEN_BATCH_PAUSE=off

由于%HOME%是用户的主目录,不想把这两个批处理那里,而想和Maven放在一起,则修改上面%HOME%为"%MAVEN_HOME%:

if exist "%MAVEN_HOME%/mavenrc_pre.bat" call "%MAVEN_HOME%/mavenrc_pre.bat"

if exist "%MAVEN_HOME%/mavenrc_post.bat" call "%MAVEN_HOME%/mavenrc_post.bat"

此外,MAVEN_HOME_LOCAL还有其它的修改方式,那就是在build.properties中指定,其中的有关项为:

maven.home.local Maven用于写一些用户相关的细节所到的本机目录,例如,未打包的插件和缓存数据,缺省为${user.home}/.maven

maven.plugin.dir Maven能找到它自己的插件的地方,缺省为${maven.home}/plugins

maven.plugin.user.dir Maven只为特定用户查找的插件位置,缺省为${maven.home.local}/plugins

maven.plugin.unpacked.dir 处理用的为打包插件的位置,缺省为   ${maven.home.local}/cache

maven.repo.local 本机上的repository,Maven用来保存下载的制品,如(jars etc),缺省为${maven.home.local}/repository

 

 

二 开始用Maven

   1 准备构建配置文件build.properties,其内容为:

   maven.appserver.home =D:/jakarta-tomcat- 5.5.6

   turbine.app.name=your appname

#如果不想生成演示页面,则设为false

turbine.app.setup.demo=true

   2 运行maven turbine:setup,生成项目.也可以带有参数,如

   maven -Dturbine.app.name=helloworld -Dmaven.appserver.home=D:/jakarta-tomcat- 5.5.6 turbine:setup

   如果命令行中有这两个参数,则不需要第一步的工作,因为对于maven来说,这两个参数是必须要有的!

   其中:maven.appserver.home用于在发布应用时,把打包的部署文件发布到该项指定的目录中的容器环境.

   turbine.app.name则是你的项目名称.

   在运行了这个命令后,当前目录下会产生以你指定的your appname为名字的目录,在进入这个目录后,我们可以进行第三步了.

   3 运行maven turbine:deploy.

   它根据2步中生成的setup.properties,project.properties,project.xml来生成可供发布的制品.项目中使用到的库,都定义在project.xml中,可以根据自己的项目需要裁剪这个文件. 经过裁剪后,运行这个任务产生发布.

   为了解决执行过程中出现的问题,先看看project.xml中的主要项:   

   <dependency>

      <groupId>turbine</groupId>

      <artifactId>turbine</artifactId>

      <version> 2.3.1</version>

      <type>jar</type>

      <properties>

        <war.bundle>true</war.bundle>

      </properties>

   </dependency>

   dependency元素定义了项目中依赖的库,该库位于${maven.home.local}/repository:

   <groupId>/jars/<artifactId>-<version>.<type>

         turbine/jars/  turbine   - 2.3.1    .jar

   上面展示了插件文件和元素dependency中子元素的对应关系.

  如果无法下载所需插件,或自己下载,或使用本机上有的,然后可以按照这种方式创建一个符合项目要求的插件来供它使用.