BlogJava-道非道 非常道-文章分类-项目工具http://www.blogjava.net/gen-sky/category/51819.html勤思、谨言、慎行、厚积、薄发zh-cnMon, 28 May 2012 08:35:32 GMTMon, 28 May 2012 08:35:32 GMT60[扩展] maven 参考资料 http://www.blogjava.net/gen-sky/articles/326743.html星期五星期五Wed, 21 Jul 2010 07:15:00 GMThttp://www.blogjava.net/gen-sky/articles/326743.htmlhttp://www.blogjava.net/gen-sky/comments/326743.htmlhttp://www.blogjava.net/gen-sky/articles/326743.html#Feedback0http://www.blogjava.net/gen-sky/comments/commentRss/326743.htmlhttp://www.blogjava.net/gen-sky/services/trackbacks/326743.html [2]Maven POM文件参考结构. http://maven.apache.org/ref/current/maven-model/maven.html
[3]Super POM. http://maven.apache.org/guides/introduction/introduction-to-the-pom.html
[4]Maven主要插件的列表. http://maven.apache.org/plugins
[5]Maven基本使用指南. http://maven.apache.org/guides/index.html
[6]Better Build with Maven. http://www.mergere.com/m2book_download.jsp -- 强烈推荐
[7]介绍Maven2. http://www.javaworld.com/javaworld/jw-12-2005 /jw-1205-maven_p.html
[8]揭秘Maven2 POM. http://www.javaworld.com/javaworld/jw-05-2006/jw-0529-maven.html
[9]Maven让事情变得简单. http://www-128.ibm.com/developerworks/cn/java/j-maven
[10]Maven文档集. http://docs.codehaus.org/display/MAVENUSER/Home
[11]有效利用Maven2的站点生成功能. http://www.matrix.org.cn/resource/article/44/44491_Maven2.html

星期五 2010-07-21 15:15 发表评论
]]>[入门] maven的简单教程 （二） 常用命令、创建工程http://www.blogjava.net/gen-sky/articles/326742.html星期五星期五Wed, 21 Jul 2010 07:08:00 GMThttp://www.blogjava.net/gen-sky/articles/326742.htmlhttp://www.blogjava.net/gen-sky/comments/326742.htmlhttp://www.blogjava.net/gen-sky/articles/326742.html#Feedback0http://www.blogjava.net/gen-sky/comments/commentRss/326742.htmlhttp://www.blogjava.net/gen-sky/services/trackbacks/326742.html     1. 创建 App 工程
mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=app
    2. 创建 webApp 工程
       D:\>mvn archetype:create -DgroupId=ce.demo.mvn -DartifactId=webapp          -DarchetypeArtifactId=maven-archetype-webapp

二、关键字
    Project：任何您想build的事物，Maven都可以认为它们是工程。这些工程被定义为工程对象模型(POM，Poject Object Model)。一个工程可以依赖其它的工程；一个工程也可以由多个子工程构成。
    POM：POM(pom.xml)是Maven的核心文件，它是指示Maven如何工作的元数据文件，类似于Ant中的build.xml文件。POM文件位于每个工程的根目录中。
    GroupId：groupId是一个工程的在全局中唯一的标识符，一般地，它就是工程名。groupId有利于使用一个完全的包名，将一个工程从其它有类似名称的工程里区别出来。
    Artifact：artifact是工程将要产生或需要使用的文件，它可以是jar文件，源文件，二进制文件，war文件，甚至是pom文件。每个artifact都由groupId和artifactId组合的标识符唯一识别。需要被使用(依赖)的artifact都要放在仓库(见Repository)中，否则Maven无法找到(识别)它们。
    Dependency：为了能够build或运行，一个典型的Java工程会依赖其它的包。在Maven中，这些被依赖的包就被称为dependency。dependency一般是其它工程的artifact。
    Plug-in：Maven是由插件组织的，它的每一个功能都是由插件提供的。插件提供goal(类似于Ant中的target)，并根据在POM中找到的元数据去完成工作。主要的Maven插件要是由Java写成的，但它也支持用Beanshell或Ant脚本写成的插件。
    Repository：仓库用于存放artifact，它可以是本地仓库，也可以是远程仓库。Maven有一个默认的远程仓库--central，可以从http://www.ibiblio.org/maven/下载其中的artifact。在Windows平台上，本地仓库的默认地址是User_Home".m2"repository。
    Snapshot：工程中可以(也应该)有一个特殊版本，它的版本号包括SNAPSHOT字样。该版本可以告诉Maven，该工程正处于开发阶段，会经常更新(但还未发布)。当其它工程使用此类型版本的artifact时，Maven会在仓库中寻找该artifact的最新版本，并自动下载、使用该最新版。


三、常用命令
   1.mvn clean – 消除工程(包括所有子工程)中产生的所有输出。这本文的实例中，实际上是删除target目录。由于之前的操作只有app工程产生了target目录，而webapp并没有，所以将只会删除app工程中的target目录。
   2.mvn package – 将工程制作成相应的包，app工程是作成jar包(app-1.0.jar)，webapp工程是作成war包(webapp-1.0.war)。打开webapp-1.0.war包，可以发现app-1.0.jar被放到了WEB-INF的lib目录中。
   3.创建Maven项目：mvn archetype:create
   4.编译源代码：mvn compile
   5.编译测试代码：mvn test-compile
   6.运行测试：mvn test
   7.产生site：mvn site
   8.打包：mvn package
   9.在本地Repository中安装jar：mvn install
   10. mvn eclipse:eclipse ：生成 Eclipse 项目文件

   





























星期五 2010-07-21 15:08 发表评论
]]>[入门] maven的简单教程 （一）http://www.blogjava.net/gen-sky/articles/326731.html星期五星期五Wed, 21 Jul 2010 05:42:00 GMThttp://www.blogjava.net/gen-sky/articles/326731.htmlhttp://www.blogjava.net/gen-sky/comments/326731.htmlhttp://www.blogjava.net/gen-sky/articles/326731.html#Feedback0http://www.blogjava.net/gen-sky/comments/commentRss/326731.htmlhttp://www.blogjava.net/gen-sky/services/trackbacks/326731.html一、前言
     推荐二遍文章
 
   Maven 2.0:编译、测试、部署、运行
   http://www.ideagrace.com/html/doc/2006/06/14/00847.html

   Maven2 的新特性
   http://www-128.ibm.com/developerworks/cn/opensource/os-maven2/index.html

二、maven2安装
1、首先去官方网站下载之：http://maven.apache.org/download.html ，我选择的是截至目前最新版本maven2.0.4版本
2、设置环境变量：Maven2下载完后，我将其解压到我的计算机的d:\maven204下，目录结构如下：
D:\
|--Maven204
|-- bin
|-- conf
|-- core
|-- lib
|-- local

环境变量：（操作系统windows2003）
        我的电脑----属性----高级----环境变量，点击“系统变量”下的新建，输入：变量名 MAVEN_HOME; 变量值d:\Maven204，在系统变量列表中找到系统变量path，打开之，在变量值中追加";%MAVEN_HOME%\bin”，至此环境变量设置完毕。
        检查一下是否已经完成安装，打开dos窗口，输入mvn –v，如果出现以下信息则表示maven2已经安装成功：
X：〉mvn –v
Maven Version 2.0.4

三、用maven2创建第一个java工程
1、选择一个根目录，我的java工作目录是D:\eclipse\workspace
2、打开dos窗口采用cd命令进入D:\eclipse\workspace目录下
3、输入下列指令
D:\eclipse\workspace>mvn archetype:create -DgroupId=com.efn -DartifactId=study
指令执行完毕会出现如下的目录结构：
study
-- pom.xml
-- src
|-- main
| `-- java
| `-- com
| `-- mycompany
| `-- app
| `-- App.java
-- test
|`-- java
|`-- com
|`-- mycompany
|`-- app
|`-- AppTest.java

四、生成eclipse工程文件
我采用的开发工具是eclipse,所以用maven的eclipse参数生成eclipse工程文件。输入如下
1、 采用dos的cd命令进入study目录
2、 输入指令：mvn eclipse:eclipse 如下所示：
D:\eclipse\workspace\study>mvn eclipse:eclipse
指令执行完毕后，发现多了两个文件：.classpath和.project

五、下载maven的eclipse插件
1、打开eclipse
2、打开菜单 help -Software updates-Find and Install
3、选择第二项，进入下一步
4、点击按钮“New Remote Site…”
5、在Name中输入：Maven2，在URL中输入http://m2eclipse.codehaus.org/
Ok,现在一切都是自动化的，你所需要做的就是等待并按提示按按钮。
   /*
    作者是自动。我的输入后提示：
    
     我的只能手动下载插件，并安装到IDE 上了。
   */

六、导入工程
刚才已经生成了eclipse的工程文件，现在导入之。菜单File-import ，按“下一步”，选择工程文件导入完毕后，工程管理透视图就会出现study节点了，在工程节点上，按鼠标右键，打开弹出菜单，选择maven2菜单项， 弹出子菜单->Enable，点击之打开，在Group Id中输入：study即可。

打开study的pom.xml文件，会有如下类似内容：

xml 代码
< 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 >   
   < groupId > com.efn </ groupId >   
   < artifactId > study </ artifactId >   
   < packaging > jar </ packaging >   
   < version > 1.0-SNAPSHOT </ version >   
   < name > Maven Quick Start Archetype </ name >   
   < url > http://maven.apache.org </ url >   
</ project >   

注意：有关这个文件的作用和各节点的作用不是本文的描述重点，可以到maven的官方网站查阅http://maven.apache.org/ 目前为止，所有的准备工作都已经就绪，现在我们就以一个主main函数访问数据库为例介绍在实际开发中的使用。

七、搭建架包
每一个java工程都不免使用第三方的架包，Maven的好处就是可以统一管理这些架 包，并使多个java工程共享这些架包。我们所需要做的就是按规则编辑pom.xml文件。Maven已经非常智能，使用maven的eclipse插件的向导，只要输入参数就可以将配置文件生成出来。我们的例子是用jdbc方式访问oracle的数据库。所以需要jdbc和oracle的架包的支持。下 面我们就来搭建这两个架包到study工程里来。

有两种方式可以采用：
1、自动向导
第一种是采用向导方式并让向导直接去maven的服务器 上下载你需要的架包，这种方式存在一定的风险，一来可能maven的服务器上并没有你需要的东东，二来每次智能的maven总是去寻找那并不存在的东东。 抛出一大堆红字提示不说，达不到预期目标才是让人郁闷。不过为了保证文档的完整性，还是给出操作步骤。以junit为例（这个东东倒是没有问题，呵呵）当 工程的maven被Enable后，弹出菜单的maven2子菜，选择子菜单的“Add Dependency”菜单项，在Query中输入“junit”，向导会自动列出相关列表供选择。选择你最需要的架包，按“OK” 按钮。
如果你的本地仓库已经存在该架包，则向导只在pom.xml加入依赖项信息，pom.xml文件的内容如下
xml 代码
< 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 >   
< groupId > com.efn </ groupId >   
< artifactId > study </ artifactId >   
< packaging > jar </ packaging >   
< version > 1.0-SNAPSHOT </ version >   
< name > Maven Quick Start Archetype </ name >   
< url > http://maven.apache.org </ url >   
< dependencies >   
< dependency >   
< groupId > junit </ groupId >   
< artifactId > junit </ artifactId >   
< version > 3.8.1 </ version >   
</ dependency >   
</ dependencies >   
</ project >   
如果本地仓库没有，则向导会去maven的服务器下载架包，并在控制台输出下载日志如下：
06-8-4 上午09时21分07秒: Local repository folder "" does not exist
06-8-4 上午09时21分11秒: Reading /study/pom.xml
06-8-4 上午09时21分11秒: Local repository folder "" does not exist
06-8-4 上午09时21分18秒: Reading /study/pom.xml
06-8-4 上午09时21分18秒: Local repository folder "" does not exist
06-8-4 上午09时21分19秒: Reading /study/pom.xml
06-8-4 上午09时21分19秒: Local repository folder "" does not exist
06-8-4 上午09时36分33秒: Local repository folder "" does not exist
06-8-4 上午09时37分11秒: Reading / study /pom.xml
06-8-4 上午09时37分11秒: Local repository folder "" does not exist
06-8-4 上午09时37分15秒: Local repository folder "" does not exist
06-8-4 上午09时40分07秒: Local repository folder "" does not exist
06-8-4 上午09时40分08秒: Reading / study /pom.xml
06-8-4 上午09时40分08秒: Local repository folder "" does not exist
06-8-4 上午09时46分24秒: Reading / study /pom.xml
06-8-4 上午09时46分24秒: Local repository folder "" does not exist
06-8-4 上午09时46分28秒: Local repository folder "" does not exist
06-8-4 上午09时46分40秒: Local repository folder "" does not exist
06-8-4 上午09时46分47秒: Local repository folder "" does not exist
06-8-4 上午09时46分47秒: Reading / study /pom.xml
06-8-4 上午09时46分47秒: Local repository folder "" does not exist
06-8-4 上午09 时46 分49 秒: Downloading [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom
06-8-4 上午09 时46 分49 秒: Downloaded [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.pom
06-8-4 上午09 时46 分51 秒: Downloading [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar
06-8-4 上午09时47分00秒: Downloaded [central] -> http://repo1.maven.org/maven2/junit/junit/3.8.1/junit-3.8.1.jar
----------------------------------------------------------------
补充修正：如果出现错误提示同时你手头也有架包的话可以采用maven的指令进行本地化安装。比如我在安装hibernate的架包时告诉我jta无法下载。要求本地化安装，给出的提示如下：
1) javax.transaction:jta:jar:1.0.1B
Try downloading the file manually from:http://java.sun.com/products/jta.Then , install it using the command:
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta "  -Dversion=1.0.1B -Dpackaging=jar -Dfile=/path/to/filePath to dependency:
1) com.efn:mywebapp:war:1.0-SNAPSHOT
2) org.hibernate:hibernate:jar:3.1rc2
3) javax.transaction:jta:jar:1.0.1B
----------
1 required artifact is missing.for artifact: com.efn:mywebapp-1.0-SNAPSHOT.war这个提示是说可以先到sun的网站下载jta架包，然后采用命令行的方式按要求安 装，因为我本来就有此架包，于是拷到一个方便的位置，比如c:",然后在命令行下输入：
mvn install:install-file -DgroupId=javax.transaction -DartifactId=jta -Dversion=1.0.1B -Dpackaging=jar -Dfile=C:/jta.jar
执行完毕后，一切OK!
--------------------------------------------------------------

2、手工配置
        手工配置比起自动化来说是麻烦了些，不过任何东东掌握在自己手里总归是吃饱喝足谁也不服了不是吗。而且配置一次就可以受益终身。更重要的是能解决自动化完 成不了的任务。比如我现在要配置oracle的jdbc驱动，采用自动化就提示我下载不了让我改变下载地址等等，真累。
        算了还是自己来吧。
        手工配置前还是先介绍一下相关背景知识。首先了解一下jar仓库的概念，maven采用集中化的方式管理架包，凡用maven构建的java工程都可以重 用统一管理下的架包，所以必须有一个统一存放jar文件的地方，这就是jar仓库，不论是开发还是部署都会建立一个本地仓库。这个仓库的位置默认是 X:\Documents and Settings\Administrator.LIPENG\.m2\repository（X是你操作系统所在盘符）下，你可以修改配置文件改变默认 的输出位置。该配置文件在maven目录下的conf子目录下。文件名叫settings.xml。在配置文件中加入如下节点信息即可D:/Repository。不过不建议改变，好像eclipse的maven插件只认默认的输出位置。我就是在这方面出了问题搞了半天才发现是输出路径的问题，也许是我还
没有玩转插件。谁要是解决此问题别忘了跟大家共享。
现在我们分析一下配置文件pom.xml的结构，以junit为例，格式如下：
xml 代码
< dependencies >   
< dependency >   
< groupId > junit </ groupId >   
< artifactId > junit </ artifactId >   
< version > 3.8.1 </ version >   
</ dependency >   
</ dependencies >   
在来看看本地仓库目录结构
Repository
`-- junit
|-- junit
| `-- 3.8.1
| `-- junit-3.8.1.jar
现在大家应该明白了吧，多余的话不说啦。照葫芦画瓢就是。不过注意先建目录后写配置文件，否则一旦保存，智能的插件就马上开始下载了…

现在开始手动建立oracle的jdbc目录并配置文件,首先建立目录结构如下：
Repository
`-- ojdbc
|-- ojdbc
| `-- 14
| `-- ojdbc-14.jar
如果你手头的jar文件名叫ojdbc14.jar，则改为ojdbc-14.jar,写配置文件:
xml 代码
< dependency >   
< groupId > ojdbc </ groupId >   
< artifactId > ojdbc </ artifactId >   
< version > 14 </ version >   
</ dependency >   
那么现在一个完整的pom.xml文件如下：
xml 代码
<? xml   version = "1.0" ?>
< project >   
< modelVersion > 4.0.0 </ modelVersion >   
< groupId > com.mycompany.app </ groupId >   
< artifactId > myapp </ artifactId >   
< name > Maven Quick Start Archetype </ name >   
< version > 1.0-SNAPSHOT </ version >   
< url > http://maven.apache.org </ url >   
< dependencies >   
< dependency >   
< groupId > ojdbc </ groupId >   
< artifactId > ojdbc </ artifactId >   
< version > 14 </ version >   
</ dependency >   
< dependency >   
< groupId > junit </ groupId >   
< artifactId > junit </ artifactId >   
< version > 3.8.1 </ version >   
</ dependency >   
</ dependencies >   
</ project >   

保存之，则发现工程管理透视图发生了一点变化,依此方法再加上jdbc的架包，现在可以开始写程序了，建一个类并添加main函数，编写程序如下：
java 代码
public   static   void  main( String[] args )   
{   
Connection conn =  null ;   
PreparedStatement ps =  null ;   
ResultSet rs =  null ;   
try  {   
Class.forName( "oracle.jdbc.driver.OracleDriver" );   
conn = DriverManager.getConnection( "jdbc:oracle:thin:@(description=(ad dress_list=(address=(protocol=TCP)(port=1521)(host=192.168.0.240)))(connect_data=(SE RVER = DEDICATED)(SERVICE_NAME = db.efriendnet.com)))" ,  "efnx" ,  "efnx" );   
ps = conn.prepareStatement( "select * From tb_partyinfo" );   
rs = ps.executeQuery();   
while (rs.next())   
{   
System.out.println(rs.getString( "topic" ));   
}   
}  catch  (Exception e) {   
System.out.print(e.getMessage());   
}   
finally   
{   
if  (rs !=  null ) { try  {rs.close();}  catch  (SQLException e) {}}   
if  (ps !=  null ) { try  {ps.close();}  catch  (SQLException e) {}}   
if  (conn !=  null ) { try  {conn.close();}  catch  (SQLException e) {}}   
}   
}  

别忘了import相应的包
  


八、编译程序
采用maven构建系统，则编译过程就独立了出来。这时你再用eclipse自带的编 译工具就不起作用了。所以要想编译、调试、运行还要做一些工作。以前是在dos命令行方式下进行编译，现在的插件很好用，在eclipse配置一下就可以 编译了。很方便。现在就做一个介绍。

Eclipse有一个扩展工具就是用来集成其他构建工具的在工程的节点上点击鼠标右键，选择属性，在“编译”的右边窗口选择”新建”按钮，在对话框的“name”中输入：study,点击“Browse Workspace…”列出工程列表供选择。
选择完毕后，在goals中输入package。别忘了apply.好了，让我们Run吧。如果一切正常，
控制台会打出maven的编译信息如下：
[INFO] ---------------------------------------------------------------------
[INFO] Building Maven Quick Start Archetype
[INFO] task-segment: [package]
[INFO] ---------------------------------------------------------------------
[INFO] resources:resources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:compile
[INFO] Nothing to compile - all classes are up to date
[INFO] resources:testResources
[INFO] Using default encoding to copy filtered resources.
[INFO] compiler:testCompile
[INFO] Nothing to compile - all classes are up to date
[INFO] surefire:test
[INFO] Surefire report directory: D:"eclipse"workspace"study"target"s
urefire-reports
-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running com.efn.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.157 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] jar:jar
[INFO] Building jar: D:"eclipse"workspace"study"target"study-1.0-SNAPSHOT.jar
[INFO] ----------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ---------------------------------------------------------------------
[INFO] Total time: 4 second
[INFO] Finished at: Fri Aug 04 10:55:42 CST 2006
[INFO] Memory 2M/7M
[INFO] --------------------------------------------------------------------
注意，别忘了每一次程序改动完毕后都要经过这一步编译。因为这是maven的编译器！

九、调试程序
经过以上步骤我们已经完成了mave管理下的软件生命周期，但是作为一个程序开发人员我们还要进行调试。这里的调试设置和普通的java程序的调试是一样的。
首先，打开debug对话框：
        因为是一个一般的java应用程序，所以我们选择 Java Application,点击“New”按钮，输入一些相应的参数，apply-Debug
Ok,一切正常！希望你也顺利！

十、结束语
本文只是简单的对maven的操作步骤做一个指南性的说明，实际应用还有很多东西需要实践。如果发现哪里有错误和纰漏也欢迎批评指正！


转自： http://blog.csdn.net/ph9527/archive/2009/12/10/4982351.aspx
   略有修改。

星期五 2010-07-21 13:42 发表评论
]]>ant 学习笔记 (一) http://www.blogjava.net/gen-sky/articles/284054.html星期五星期五Thu, 25 Jun 2009 01:05:00 GMThttp://www.blogjava.net/gen-sky/articles/284054.htmlhttp://www.blogjava.net/gen-sky/comments/284054.htmlhttp://www.blogjava.net/gen-sky/articles/284054.html#Feedback0http://www.blogjava.net/gen-sky/comments/commentRss/284054.htmlhttp://www.blogjava.net/gen-sky/services/trackbacks/284054.html  介绍、下载、说明、安装

Ant 全名： Another Neat Tool ,意思是另一个清洁工具。

Ant 介绍:
        ant 是构建工具,是Apache 的一个项目，是一个基于JAVA的build工具，用来编译、运行、测试JAVA
    程序，构建、包装和发布任务。
Ant 优势：
        * 操作方便，只需在命令行输入 ant ,它就会自动寻找 build.xml文件。
        * 良好的跨平台，可以在各种平台上运行。
        * 结构清晰，能让开发人员运行各种各样的任务。
Ant 下载：
    http://ant.apache.org/
Ant 配置：
        1.环境变量中，查找 Path 变量并选中，然后编辑，如果没有新建，，在弹出的“系统变量”对象话中设定
    系统变量 Path,Path = D:\*\Apache-ant- 1.7.0\bin
      2.单击“系统变量”选项卡中的新建按钮，创建 ANT_HOME=D:\*\apache-ant-1.7.0
      3.在cmd命令框中输入ant 命令，即可查看 Ant  是否安装成功
      注意：
          ant 启动时，自动加载 build.xml 项目配置文件，如果取别的名字，使用 buildfile标记
          运行 Ant ,比如： ant -buildfile gd.xml
Ant 的使用方法：
        Ant 的配置运行文件是 build.xml，一般放在项目根目录下，通过运行它即可完成相应工作。
Ant 能完成的工作：
        init ,初始化工作，即在进行打包、部置之前对环境进行一些初始化工作。
        compile,编译工作，即将java代码编译成class;
        javadoc，生成文档，即用来生成API的相关文档;
        jar,打包工作，即用来将编译后的class文件打成jar;
        deploy,部署工作，即用来对打好的jar或war进行部署；
        clean,清除工作，即用来清空初始化的环境；
        all,执行全部任务。

 元素属性说明
    一般来讲,一个XML文件要包含 project 和target 两个元素
    1.project 元素的属性:
                name:表示一个工程的名字.
                default:每个project都包含一个或多个target,一个target又包含一系列想要执行的task,
        当Ant 开始运行时,开发人员可以选择target执行.如果没有 target 被指定执行时,默认的任务
        将执行.
                basedir:当前工程的基本路径,"."表示当前工程的根目录.
    2.一个project有一系列的property,property类似于全局变量,包含name和value两个属性.
                name:变量名称.
                value:变量值.
                属性该问的方法:${property-name};
    3.Ant 内置的属性
                basedir:工程的路径.
                ant.file:build文件的路径.
                ant.version:版本.
                ant.project.name:工程名.
                ant.java.version:jvm版本.
    4.target 元素的属性
                name:指定目录名称.
                depends:指定所依赖的target.
                if:条件,如果不满足条件则不执行.
                unless:条件,如果不满足条件则不执行.
                description:对target 的描述.
                task:一小段的任务.
                reference:引用,通过refid属性来引用在其他节中定义的ID.

ant 的基本语法介绍：
        1.ant 命令行，最常用的命令分析如下：
            //应用 build.xml 作为默认的脚本文件，目录路径默认。
            ant
           
            //应用 test.xml 作为默认的脚本文件，目录路径默认。
            ant  -builefile test.xml
           
            // 应用 test.xml 作为默认的脚本文件，目录路径设置为 dist
            ant -builefile test.xml dist
           
            //应用test.xml 作为默认的脚本文件，目标路径设置为 dist ，并且把构建的属性文件放在
              buile/classes  下
             ant -buildfile test.xml -Dbuile=buile/classes dist
             
             //执行从/home/ant/extras 添加的任务和jar 包
             ant -lib /home/ant/extras
        想了解更多的命令，可以运行 ant -H获取命令列表。
        2.添加属性文件
            <property file="${basedir}/build.properties" />
        3.CLASSPATH设置，示例如下：
            <path id="classpath">
                    <pathelement path="${hibernate_jar}"/>  //从什么地方加载
                    <fileset dir="${lib.dir}"> //设置文件夹
                            <include name="**/*.jar" />   //将.jar 放在dir中
                    </filest>
            </path>
            以上代码与设置 CLASSPATH=/***/*.jar;/***/*.jar;是等效的
        4.文件COPY命令，示例代码如下：
            <!-- 拷贝源文件 -->
            <copy todir="${build.src}">
                <fileset dir="${src.dir}"/>
            </copy>
        5.打包任务jar 命令，示例代码如下
            <!-- 打包文件 -->
            <jar jarfil="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}" />
        6.生成JAVADOC的命令，示例代码如下：
            <javadoc pachagename="${[aclages}"     //包名
                                sourcepath="${build.src}"    // 源文件路径
                                destdir="${build.javadosc}"  // 目标路径
                                author="true"                
                                version="true"               //是否带有版本信息
                                use="true"                                     //
                                splitindex="true"
                                windowtitle="${NAME}API"
                                doctitle="${NAME}">
                <javadoc>
            7.删除命令，示例代码如下所示：
                <delete dir="${dir.build}" />
               
                ant 在线文档，地址是：http://ant.apache.org/manual/index.html
               
            8.后台打印命令
                <echo message="jdk version: 1.5.0" />

一些常用的 ant 文件：
       <?xml version="1.0" encoding="UTF-8"?>
<!-- ======================================================================
     2007-10-24 上午09:01:29                                                       

     project   
     description
                  
     yihang                                                               
     ====================================================================== -->
<project name="project" default="default">
    <description>
            转换字符
    </description>
   
    <target name="help">
        <echo message=" this is  help"></echo>
   
    </target>

    <!-- =================================
          target: default             
         ================================= -->
    <target name="default" description="--> description">
        <native2ascii dest="." includes="src/com/news/struts/*.txt" encoding="GBK" ext=".properties"></native2ascii>
    </target>

</project>

元素说明：
<?xml version="1.0"?>
<!--配置myApp的Ant文件，将gd包中的内容打成jar -->
<project name="myApp" default="init" basedir=".">
    <property name="myApp.home" value="." />
    <property name="myApp.lib" value="${myApp.home}/WEB-INF/lib" />
    <property name="myApp.jar" value="${myApp.home}/WEB-INF/lib" />
    <property name="myApp.classes" value="${myApp.home}/WEB-INF/classes" />
    <!--配置使用Tomcat所在的目录 -->
    <property name="tomcat.home" value="D\:/apache-tomcat-6.0.2" />
    <!--<property file="build.properties" />以上内容还可以定义在build.properties中-->
    <target name="init">
        <path id="all">
            <!--初始化时需要使用的jar -->
            <fileset dir="${myApp.lib}">
                <include name="**/*.jar" />
            </fileset>
            <!--初始化时需要使用的jar -->
            <fileset dir="${tomcat.home}/common/lib">
                <include name="*.jar" />
            </fileset>
        </path>   
        <!--创建目录 -->
        <mkdir dir="${myApp.classes}" />
    </target>
    <!--定义 target -->
    <!--清空生成的calss -->
    <target name="clean">
      <!-- 删除目录 -->
        <delete dir="${myApp.classes}">
        </delete>
    </target>
    <!--定义target,该target依赖于init,编译时需要依赖与初始化的结果 -->
    <target name="compile" depends="init">
        <!--编译时使用的版本是1.5 -->
            <javac srcdir="${myApp.home}/WEB-INF/src"encoding="utf-8"  destdir="${myApp.classes}" target="1.5">
            <classpath refid="all" />
        </javac>
    </target>
    <!--定义target,该target 依赖于 compile,com.gd包下的代码打成加，命名为nancy2.0.0.jar -->
    <target name="jar" depends="compile">
        <jar jarfile="${myApp.jar}/nancy2.0.0.jar" basedir="${myApp.classes}" includes="com/gd/**">
        </jar>
    </target>
    <!--将myApp项目打成war文件-->
    <target name="war" depends="jar">
        <war destfile="${myApp.home}/myApp.war" webxml="${myApp.home}/WEB-INF/web.xml">
                <!-- 包含该文件夹下所有内容 -->
            <fileset dir="${myApp.home}" casesensitive="yes">
                <include name="WEB-INF/**" />
                <exclude name="*.war" />
            </fileset>
            <!--所依赖的jar-->
            <lib dir="${myApp.home}/WEB-INF/lib">
                <include name="*.jar" />
            </lib>
        </war>
    </target>
</project>







星期五 2009-06-25 09:05 发表评论
]]>