亚洲第一成年人网站,亚洲不卡视频在线观看,精品亚洲成A人无码成A在线观看

�l�合Axis和Ant开发Web服务

菠萝 — Sun, 12 Aug 2007 09:04:00 GMT

本文�l�合一个简单示例讲解了怎样�?/span>Axis�?/span>Ant�l�合��h��q�行Web服务的开发。帮助读者从��单的java源代码或者从一个服务描�q�文�Ӟ��wsdl�Q�开始，�?/span>Ant工具�q�行构徏�Q�设�|�，�q�把服务部��v�?/span>Axis�?/span>

首先假定您熟�?/span> AXIS 处理�pȝ��?/span>Ant工具。文中示例所需要的软�g如下�Q?/span>

l Apache Axis 1.1

l Apache Ant 1.5.3

l Jarkat Tomcat 4.1.24

在开始前�Q�假定上�q��Y件已�l�安装和配置好了�?/span>

Axis�?/span>Ant��?/span>

Axis 框架是来�?/span> Apache Group 的、基�?/span> java 的、最新的 SOAP 规范�Q?/span>SOAP 1.2�Q�和 SOAP with Attachments 规范�Q�来�?/span> Apache Group �Q�的开放源代码实现。其本质上是一�?/span>SOAP引擎�Q�－一个构��如客��L��、服务器、网关等SOAP处理器的框架。是Apache SOAP的后�l�项目。但是，Axis使用SAX�Q�基于事�Ӟ��解析器获得了�?/span>Apache SOAP早期版本(使用DOM解析)非常明显的速度优势。另外，它还��h��很强的灵�z�L��和�E�_��性，支持Web服务描述语言1.1版�?/span>

Apache Ant�?/span>Apache软�g基金�?/span>jakarta��目中的一个子��目�Q�是一个基�?/span>Java的构建工��P��c�M��?/span>make�Q�但它没�?/span>make那么复杂�J�琐�?/span>Ant�׃��些内�|��Q务（task�Q�和可选择的�Q务组成，�q�可以配�|�第三方提供的�Q务。它的构建配�|�文件基�?/span>XML的，所以容易书写和�l�护�Q�而且�l�构清晰�?/span>Ant�q�可以集成到一些开发环境中�Q�例�?/span>visual age,jbuilder,Elipse)�?/span>

Axis�?/span>Ant的支�?/span>

Axis为支�?/span>Ant构徏�Q�提供了一�?/span>axis-ant.jar文�g。该文�g包含三个可选�Q�?/span>(task)的定义和实现�Q?/span>axis-wsdl2java�Q?/span>axis-java2wsdl�?/span>axis-admin。�Q�?/span>axis-wsdl2java�?/span>Axis提供的工�?/span>WSDL2Java��h��同样的功能，�Ҏ��web服务描述文�g生成对应�?/span>Java源程序，它的属性设�|�与WSDL2Java的命令参数设�|�类伹{��而�Q�?/span>axis-java2wsdl则相反，它与Java2WSDL工具一��P��是根据已有的�c�L��件来生成Web服务描述文�g。最后一个�Q�?/span>axis-admin是用�?/span>web服务的部�|�和取消部��v的，对应�?/span>Axis�?/span>AminClient工具�?/span>

��Z��?/span>Ant能够正确使用上述三个��d��Q?/span>task�Q�，�q�需要做一些配�|�。注意：Apache Ant的版本必��L��1.5.1或更高版本�?/span>

1�Q�设�|�系�l�的环境变量CLASSPATH包含Axis提供�?/span>axis-ant.jar文�g�Q�或者在Ant的配�|�文�Ӟ��通常�?/span>build.xml�Q�中讄��路径包含它。例如，

2�Q�然后��?/span>声明导入axis-ant.jar文�g中的属性文件所定义的�Q务（task�Q�列表�?/span>

classpathref="axis.classpath" />

3�Q�设�|�在构徏�q�程中可能要需要的java包，例如�Q?/span> Axis所有的jar包，wsdl4j.jar�Q?/span>junit.jar�{�等�?/span>

实例开�?/span>

下面��q��一个实例来讲解怎样�?/span>Ant�?/span>Axis�l�合来开�?/span>Web服务。�ؓ了注重本文的目的�Q�我们开发一个比较简单的Web服务�Q�它接受客户端传入的字符串数�l�，如果传入的参��Cؓnull�Q�则抛出一个自定义的异常，否则把每个字�W�串�q�接��h��q�回�l�客��L��?/span>

首先定义一�?/span>Web服务接口Hello�Q�如下所�C�：

package com.bidlink.hello;

public interface Hello{

public String echo(String[] content ) throws

java.rmi.RemoteException,com.bidlink.hello.MyException;

}

自定义异�?/span>MyException包含一个时间��|��以记录异常出现的旉��Q�如下：

package com.bidlink.hello;

public class MyException extends org.apache.axis.AxisFault implements java.io.Serializable{

private java.util.Calendar occurTime;

public MyException() {

}

public MyException(

java.util.Calendar occurTime) {

super();

this.occurTime = occurTime;

}

public java.util.Calendar getOccurTime() {

return occurTime;

}

public void setOccurTime(java.util.Calendar occurTime) {

this.occurTime = occurTime;

}

1�Q?/span>axis-java2wsdl�Q�从�c�L��件生成服务描�q�文�?/span>

�~�译上面定义的两个文�?/span>Hell.java�?/span>MyException.java。接着�~�写Ant的配�|�文�?/span>build.xml�Q�文件详�l�信息请查看�C�Z��源代码）�Q��?/span>axis-java2wsdl��d��Ҏ��c?/span>Hello来生�?/span>Web服务描述文�ghello.wsdl。�Q务具体配�|�如下：

location="http://localhost:8080/axis/services/Hello"

namespace="http://hello.bidlink.com"

output="hello.wsdl"

style="RPC"

extraclasses="com.bidlink.hello.MyException">

其中�Q?/span>指出Hello.class�?/span>MyException.class文�g的位�|��?/span>

�q�行命��oant java2wsdl�Q�构建出Web服务描述文�ghello.wsdl�?/span>

2�Q?/span>axis-wsdkl2java�Q�从服务描述文�g生成服务源程�?/span>

下面讲解怎样�Ҏ��刚刚得到�?/span>hello.wsdl文�g生成服务所需要的java源程序。在�q�里需要用��C�Q�?/span>axis-wsdl2java。�Q务属性设�|�如下：

url="hello.wsdl"

deployscope="Request"

output="${gensrc}"

serverside="true"

skeletondeploy="false"

testcase="true"

noimports="false"

typemappingversion="1.2">

�q�行ant wsdl2java�Q�根�?/span>axis-wsdl2java��d��的属性配�|�生成相应的java源程序，本例所生成的文件包括：服务端服务接口文�?/span>Hello.java及其实现HelloSoapBindingImpl.java�Q�以及客��L��?/span>HelloService.java�Q?/span>HelloServiceLocator.java�Q?/span>HelloServiceLocator.java和客��L��存根文�gHelloSoapBindingStub.java。又因�ؓ属�?/span>testcase="true"�Q�所以还生成了测试文�?/span>HelloServiceTestCase.java。当�Ӟ��自定义异�?/span>MyException也是重新生成的�?/span>

3�Q?/span>axis-admin�Q�向Axis部��vHello服务

服务源程序生成后�Q�需要根据服务的功能修改HelloSoapBindingImpl.java文�g�Q�以真正实现�?/span>Web服务。修改如下：

/**

* HelloSoapBindingImpl.java

* This file was auto-generated from WSDL

* by the Apache Axis WSDL2Java emitter.

package com.bidlink.hello;

public class HelloSoapBindingImpl implements com.bidlink.hello.Hello{

public java.lang.String echo(java.lang.String[] in0) throws java.rmi.RemoteException, com.bidlink.hello.MyException {

if(in0 == null)

throw new MyException(java.util.Calendar.getInstance());

String retStr = "";

for(int i=0; i< in0.length; i++)

retStr += in0[i];

return retStr;

}

�~�译所有的生成的源�E�序�Q�最后��?/span>axis-admin��d��?/span>Axis部��vHello Web服务�?/span>

port="${target.port}"

hostname="${target.server}"

failonerror="true"

servletpath="${target.appname}/services/AdminService"

debug="true"

xmlfile="deploy.wsdd"/>

�q�行ant deploy�Q�部�|?/span>Hello服务�?/span>

��试

现在可以��试所部��v�?/span>Web服务hello。可以通过��览器，也可以利用刚才生成的��试文�gHelloServiceTestCase.java来进行该��工作。如果利用测试文�?/span>HelloServiceTestCase.java�Q�那么还需要对它进行稍作修攏V��具体来��_��是��d��一�?/span>main函数�Q�然后修�Ҏ��生成的测试方法�?/span>

菠萝 2007-08-12 17:04 发表评论

axis with ant

菠萝 — Sun, 12 Aug 2007 09:03:00 GMT

在用eclipes开发web service的时候，�l�常会用到java2wsdl,wsdl2java�{�命令，axis在发布的时候提供了相应的ant task�Q��ƈ攑ֈ�了axis-ant.jar中�?br> 按照axis的ant相关文档配置的时候，需要引入相应的ant task�Q�我在做�q�个配置的时候遇��C��些障��，开始的build.xml如下所�C�：

      classname="axis.service.SimpleObjectCreator"
  location="http://localhost:8080/axis/services/SimpleObjectCreator"
      namespace="service.axis"
      output="simpleObject.wsdl"
      style="RPC"
      extraclasses="axis.bean.SimpleObject"
    >


            url="simpleObject.wsdl"
        deployscope="Request"
        output="${axis.home}/src"
        serverside="true"
        skeletondeploy="false"
        testcase="true"
        noimports="false"
        typemappingversion="1.2"
    />

   port="8080"
  hostname="localhost"
  failonerror="true"
  servletpath="axis/services/AdminService"
  debug="true"
  xmlfile="${axis.home}\src\axis\service\deploy.wsdd"
/>

在执行ant的时候，��L��?br>    java.util.zip.ZipException: error in opening zip file
的错误，百思不得其解，后来扑ֈ�了错误的原因�Q�原来出�?br>    ...
的定义上�Q�因��里包�?br>


部分�Q?lt;taskdef>解析时会把我指定的class文�g当作一个压�~�文件进行解压，产生异常�Q�改成如下定义即可：



�W�二个fileset�Ҏ��pathelement�Q�当解析时会把指定的location当作一个�\径，不会报错�?br> 对于开源的ant真是又爱又恨啊，可恨的是文档太少了，�?lt;path>,的说明等�Q�惜墨如金啊�?/p>

菠萝 2007-08-12 17:03 发表评论

Axis开发之工业化－ant使用

菠萝 — Sun, 12 Aug 2007 08:24:00 GMT

Axis为支�?/span>Ant构徏�Q�提供了一�?/span>axis-ant.jar文�g。该文�g包含三个可选�Q�?/span>(task)的定义和实现�Q?/span>axis-wsdl2java�Q?/span>axis-java2wsdl�?/span>axis-admin�?/span>

1�Q?span> ��d��axis-wsdl2java�?/span>Axis提供的工�?/span>WSDL2Java��h��同样的功能，�Ҏ��web服务描述文�g生成对应�?/span>Java源程序，它的属性设�|�与WSDL2Java的命令参数设�|�类伹{�?/span>

2�Q?span> ��d��axis-java2wsdl则相反，它与Java2WSDL工具一��P��是根据已有的�c�L��件来生成Web服务描述文�g�?/span>

3�Q?span> axis-admin是用�?/span>web服务的部�|�和取消部��v的，对应�?/span>Axis�?/span>AminClient工具�?/span>

��Z��使用ant来徏构，首先需要将axis-ant.jar包拷贝到ant�?/span>lib目录下�?/span>

一、下面是详细的步骤，列了一�?/span>1�Q?/span>2�Q?/span>3�Q?/span>4�Q?/span>5�Q�看��h��清楚一�?/span>

1�Q?span> �?/span>声明导入axis-ant.jar文�g中的属性文件所定义的�Q务（task�Q�列表�?/span>

2�Q?span> �?/span>axis的包都导�q�来

�q�里导入的是axis的所有包-->

�q�里导入的是javamail的包�Q�如�?/span>web服务有附件的时候要用到�Q�如果没有包含进来会有一个警�?/span>

-->

其他的包-->

3�Q?span> 生成web描述文�g和根据描�q�文件生�?/span>java源程�?/span>

classname="net.wide.axis.service.SimpleObjectCreator" location="http://localhost:8080/axis/services/SimpleObjectCreator"

namespace="service.axis.wide.net"

output="simpleObject.wsdl"

style="RPC"

extraclasses="net.wide.axis.bean.SimpleObject"

url="simpleObject.wsdl"

deployscope="Request"

output="${basedir}/src"

serverside="true"

skeletondeploy="false"

testcase="true"

noimports="false"

typemappingversion="1.2"/>

3行：我们要发布的web服务接口�Q�需要先定义�q�个接口�Q�如果是一个具体的�c�，下面�?/span>axis-wsdl2java来生�?/span>java文�g的时候，会生成该接口和他的实现文件�?/span>

4行：web服务发布的位�|?/span>

5行：namespace�Q�这一行用�U�字标出来，是要注意的，“service.axis.wide.net”�Q�跟我的包结构刚好倒过来，当用axis-wsdl2java来生�?/span>java文�g的时候，包结构就�?#8220;net.wide.axis.service”�?/span>

6行：生成�?/span>webservice描述文�g�Q?/span>axis-wsdl2java正是用他来生�?/span>java文�g�?/span>

4�Q?span> ��生成的java文�g�~�译�Q�解下就是部�|?/span>

port="8080"

hostname="localhost"

failonerror="true"

servletpath="axis/services/AdminService"

debug="true"

xmlfile="${basedir}\src\net\wide\axis\service\deploy.wsdd"/>

6行：servletpath要跟web.xml中的保持一�?/span>

8行：上一步生成的部��v文�g

5�Q?span> ��试

二、实例，通过一个实例来看看使用ant的开发步骤。包括下面的内容�Q?/span>

1�Q?span> 服务端创��Z��?/span>JavaBean�Q��ƈ且返回给客户�?/span>

2�Q?span> 客户端将一�?/span>JavaBean做�ؓ参数传递给服务器端

3�Q?span> 服务器端�q�回一�?/span>JavaBean数组

1�Q?span> 定义JavaBean

package net.wide.axis.bean;

public class SimpleObject implements Serializable {

private String name;

public getName() {

return name;

}

public void setName(String name) {

this.name = name;

}

注意JavaBean需要实�?/span>Serializable接口

2�Q?span> 定义web服务接口

package net.wide.axis.service;

import net.wide.axis.bean.SimpleObject;

public interface SimpleObjectCreator{

public SimpleObject createSimpleObject(String name);

public void storeSimpleObject(SimpleObject simpleObject);

public SimpleObject[] createSimpleObjects();

}

3�Q?span> �q�行Ant axis�Q�生成了下面的文�?/span>

4�Q?span> 实现SimpleObjectCreatorSoapBindingImpl.java�Q�这�?/span>java文�g��是SimpleObjectCreator的实现文�Ӟ��单实现如下：

public class SimpleObjectCreatorSoapBindingImpl

implements net.wide.axis.service.SimpleObjectCreator{

public SimpleObject createSimpleObject(java.lang.String name)

throws java.rmi.RemoteException {

System.out.println("创徏SimpleObject...");

SimpleObject simpleObject = new SimpleObject();

simpleObject.setName(name);

return simpleObject;

}

public void storeSimpleObject(SimpleObject simpleObject)

throws java.rmi.RemoteException {

System.out.println("Store");

System.out.println(simpleObject.getName());

}

public SimpleObject[] createSimpleObjects()

throws java.rmi.RemoteException {

SimpleObject[] simpleObjects = new SimpleObject[2];

simpleObjects[0] = new SimpleObject();

simpleObjects[1] = new SimpleObject();

simpleObjects[0].setName("First Object");

simpleObjects[1].setName("Second Object");

return simpleObjects;

}

5�Q?span> 部��vant deploy

6�Q?span> ��试

public static void main(String[] args)

throws ServiceException, RemoteException {

String endPoint =

"http://localhost:8080/axis/services/SimpleObjectCreator?wsdl";

Service service = new Service();

Call call = (Call) service.createCall();

call.setTargetEndpointAddress(endPoint);

QName qname =

new QName("http://bean.axis.wide.net","SimpleObject");

//��试createSimpleObject�Ҏ��Q�它创徏一�?/span>SimpleObject�q�且�q�回该对�?/span>

call.registerTypeMapping(SimpleObject.class,

qname,

new BeanSerializerFactory(SimpleObject.class, qname),

new BeanDeserializerFactory(SimpleObject.class, qname));

call.setOperationName("createSimpleObject");

SimpleObject simpleObject =

(SimpleObject) call.invoke(new Object[]{"Hello"});

System.out.println(simpleObject.getName());

//��试storeSimpleObject�Q�客��L��传递一�?/span>SimpleObject

call.setOperationName("storeSimpleObject");

call.invoke(new Object[]{simpleObject});

//��试服务端返回一�?/span>SimpleObject数组�Q�打印出数组的长�?/span>

qname =

new QName("service.axis.wide.net","ArrayOf_tns1_SimpleObject");

call.registerTypeMapping(SimpleObject.class,

qname,

new BeanSerializerFactory(SimpleObject.class, qname),

new BeanDeserializerFactory(SimpleObject.class, qname));

call.setOperationName("createSimpleObjects");

SimpleObject[] simpleObjects =

(SimpleObject[]) call.invoke(new Object[]{});

System.out.println(simpleObjects.length);

}

7�Q?span> �l�合/WEB-INF/server-config.wsdd来分析，部��v的时候会生成�q�个部��v描述文�g

<operation name="createSimpleObject"

qname="ns2:createSimpleObject"

returnQName="createSimpleObjectReturn"

soapAction=""

xmlns:ns1=http://bean.axis.wide.net/

returnType="ns1:SimpleObject"

xmlns:ns2="service.axis.wide.net">

<parameter

name="in0"

type="xsd:string"

xmlns:xsd="http://www.w3.org/2001/XMLSchema" />

operation>

<operation name="storeSimpleObject"

qname="ns3:storeSimpleObject"

soapAction=""

xmlns:ns3="service.axis.wide.net">

<parameter name="in0" type="ns4:SimpleObject"

xmlns:ns4="http://bean.axis.wide.net" />

operation>

<operation name="createSimpleObjects"

qname="ns5:createSimpleObjects"

returnQName="createSimpleObjectsReturn"

returnType="ns5:ArrayOf_tns1_SimpleObject"

soapAction=""

xmlns:ns5="service.axis.wide.net" />

<parameter name="allowedMethods"

value="storeSimpleObject createSimpleObject createSimpleObjects" />

<parameter name="wsdlServiceElement"

value="SimpleObjectCreatorService" />

<parameter name="wsdlTargetNamespace"

value="service.axis.wide.net" />

<parameter name="schemaUnqualified"

value="service.axis.wide.net,http://bean.axis.wide.net" />

<typeMapping

deserializer="org.apache.axis.encoding.ser.BeanDeserializerFactory"

encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"

qname="ns6:SimpleObject"

serializer="org.apache.axis.encoding.ser.BeanSerializerFactory"

type="java:net.wide.axis.bean.SimpleObject"

xmlns:ns6="http://bean.axis.wide.net" />

<arrayMapping innerType="ns8:SimpleObject"

languageSpecificType="java:net.wide.axis.bean.SimpleObject[]"

qname="ns7:ArrayOf_tns1_SimpleObject"

xmlns:ns7="service.axis.wide.net"

xmlns:ns8="http://bean.axis.wide.net" />

service>

�q�一�D�|��SimpleObjectCreator的描�q�。结�?/span>createSimpleObject�Ҏ��的描�q�C��试代码中的�Q?/span>

QName qname = new QName("http://bean.axis.wide.net","SimpleObject");

�?/span>createSimpleObject�Ҏ��的描�q�C��有下面的一�D?/span>

xmlns:ns1=http://bean.axis.wide.net/

returnType="ns1:SimpleObject"

�Ҏ��q��道了�Q�我们��用的命名�I�间�?span>�Q?/span>http://bean.axis.wide.net/

其他几个也是�q�样�?/span>

菠萝 2007-08-12 16:24 发表评论

菠萝 — Sun, 12 Aug 2007 04:43:00 GMT

Ant的概�?
可能有些读者�ƈ不连接什么是Ant以及入可使用它，但只要��用通过Linux�pȝ��得读者，应该知道make�q�个命��o。当�~�译Linux内核及一些��Y件的源程序时�Q�经常要用这个命令。Make命��o其实��是一个项目管理工��P��而Ant所实现功能与此�c�M��。像make�Q�gnumake和nmake�q�些�~�译工具都有一定的�~�陷�Q�但是Ant却克服了�q�些工具的缺陗��最初Ant开发者在开发跨�q�_��的应用时�Q�用样也是基于这些缺陷对Ant做了更好的设计�?

Ant �?makefile
Makefile有一些不��之处，比如很多人都会碰到的烦�h的Tab问题。最初的Ant开发者多�ơ强�?#8221;只是我在Tab前面加了一个空��|��所以我的命令就不能执行”。有一些工具在一定程度上解决了这个问题，但还是有很多其他的问题。Ant则与一般基于命令的工具有所不同�Q�它是Java�cȝ��扩展。Ant�q�行需要的XML格式的文件不是Shell命��o文�g。它是由一个Project�l�成的，而一个Project又可分成可多target�Q�target再细分又分成很多task�Q�每一个task都是通过一个实现特定接口的java�c�L��完成的�?/p>

Ant的优�?/p>

Ant是Apache软�g基金会JAKARTA目录中的一个子��目�Q�它有以下的优点�?
跨��^台性。Ant是存Java语言�~�写的，所�C�具有很好的跨��^台性�?
操作��单。Ant是由一个内�|��Q务和可选�Q务组成的。Ant�q�行旉��要一个XML文�g(构徏文�g)。Ant通过调用target树，��可以执行各�U�task。每个task实现了特定接口对象。由于Ant构徏文�g时XML格式的文�Ӟ��所以和�Ҏ��l�护和书写，而且�l�构很清晰�?
Ant可以集成到开发环境中。由于Ant的跨�q�_��性和操作��单的特点�Q�它很容易集成到一些开发环境中厅R�?/p>

Ant 开�?/p>

Ant的构建文�?
当开始一个新的项目时�Q�首先应该编写Ant构徏文�g。构建文件定义了构徏�q�程�Q��ƈ被团队开发中每个��Z��用。Ant构徏文�g默认命名为build.xml�Q�也可以取其他的名字。只不过在运行的时候把�q�个命名当作参数传给Ant。构建文件可以放在�Q何的位置。一般做法是攑֜��目��层目录中，�q�样可以保持��目的简�z�和清晰。下面是一个典型的��目层次�l�构�?
(1) src存放文�g�?
(2) class存放�~�译后的文�g�?
(3) lib存放�W�三方JAR包�?
(4) dist存放打包�Q�发布以后的代码�?
Ant构徏文�g是XML文�g。每个构建文件定义一个唯一的项�?Project元素)。每个项目下可以定义很多目标(target元素)�Q�这些目标之间可以有依赖关系。当执行�q�类目标�Ӟ��需要执行他们所依赖的目标�?每个目标中可以定义多个�Q务，目标中还定义了所要执行的��d��序列。Ant在构建目标时必须调用所定义的�Q务。�Q务定义了Ant实际执行的命令。Ant中的��d��可以�?�c�R�?
�Q?�Q?核心��d��。核心�Q务是Ant自带的�Q务�?
�Q?�Q?可选�Q务。可选�Q务实来自�W�三方的��d��Q�因此需要一个附加的JAR文�g�?
�Q?�Q?用户自定义的��d��。用戯��定义的�Q务实用户自己开发的��d��?
1.标签
每个构徏文�g对应一个项目�?lt;project>标签时构建文件的�Ҏ��{�。它可以有多个内在属性，

��如代码中所�C�，其各个属性的含义分别如下�?
(1) default表示默认的运行目标，�q�个属性是必须的�?
(2) basedir表示��目的基准目录�?
(3) name表示��目名�?
(4) description表示��目的描�q��?
每个构徏文�g都对应于一个项目，但是大型��目�l�常包含大量的子��目�Q�每一个子��目都可以有自己的构建文件�?/p>

2.标签
一个项目标�{�下可以有一个或多个target标签。一个target标签可以依赖其他的target标签。例如，有一个target用于�~�译�E�序�Q�另一个target用于声称可执行文件。在生成可执行文件之前必��d��~�译该文�Ӟ��因策可执行文件的target依赖于编译程序的target。Target的所有属性如下�?
(1).name表示标明�Q�这个属性是必须的�?
(2).depends表示依赖的目标�?
(3)if表示仅当属性设�|�时才执行�?
(4)unless表示当属性没有设�|�时才执行�?
(5)description表示��目的描�q��?
Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现��序依次执行每个target。在执行之前�Q�首先需要执行它所依赖的target。程序中的名为run的target�?/p>

depends属性compile�Q�而名为compile的target的depends属性是prepare�Q�所以这几个target�?/p>

行的��序是prepare->compile->run�?
一个target只能被执行一�ơ，即��有多个target依赖于它。如果没有if或unless属性，target�?/p>

会被执行�?/p>

3.标签
该标�{��于创��Z��个目录，它有一个属性dir用来指定所创徏的目录名�Q�其代码如下�Q?

通过以上代码��创��Z��一个目录，�q�个目录已经被前面的property标签所指定�?/p>

4标签
该标�{��来生成一个JAR文�g�Q�其属性如下�?
(1) destfile表示JAR文�g名�?
(2) basedir表示被归档的文�g名�?
(3) includes表示别归档的文�g模式�?
(4) exchudes表示被排除的文�g模式�?/p>

5�Q?lt;javac标签>
该标�{��于编译一个或一�l�java文�g�Q�其属性如下�?
(1).srcdir表示源程序的目录�?
(2).destdir表示class文�g的输出目录�?
(3).include表示被编译的文�g的模式�?
(4).excludes表示被排除的文�g的模式�?
(5).classpath表示所使用的类路径�?
(6).debug表示包含的调试信息�?
(7).optimize表示是否使用优化�?
(8).verbose 表示提供详细的输��Z��息�?
(9).fileonerror表示当碰到错误就自动停止�?/p>

6�Q?lt;java>标签
该标�{��来执行编译生成的.class文�g�Q�其属性如下�?
(1).classname 表示��执行的�c�d��?
(2).jar表示包含该类的JAR文�g名�?
(3).classpath所表示用到的类路径�?
(4).fork表示在一个新的虚拟机中运行该�c�R�?
(5).failonerror表示当出现错误时自动停止�?
(6).output 表示输出文�g�?
(7).append表示�q�加或者覆盖默认文件�?/p>

7.标签
该标�{��于删除一个文件或一�l�文�Ӟ��d��性如下�?
(1)/file表示要删除的文�g�?
(2).dir表示要删除的目录�?
(3).includeEmptyDirs 表示指定是否要删除空目录�Q�默认值是删除�?
(4).failonerror 表示指定当碰到错误是否停止，默认值是自动停止�?
(5).verbose表示指定是否列出所删除的文�Ӟ��默认��gؓ不列出�?/p>

8.标签
该标�{��于文件或文�g集的拯��Q�其属性如下�?
(1).file 表示源文件�?
(2).tofile 表示目标文�g�?
(3).todir 表示目标目录�?
(4).overwrite 表示指定是否覆盖目标文�g�Q�默认值是不覆盖�?
(5).includeEmptyDirs 表示制定是否拯��I�目录，默认��gؓ拯��?
(6).failonerror 表示指定如目标没有发现是否自动停止，默认值是停止�?
(7).verbose 表示制定是否昄��详细信息�Q�默认��g��昄��?/p>

Ant的数据类�?
在构建文件中��Z��标识文�g或文件组�Q�经帔R��要��用数据类型。数据类型包含在

org.apache.tool.ant.types包中。下面镜��单介�l�构建文件中一些常用的数据�c�d��?/p>

1. argument �c�d��
由Ant构徏文�g调用的程序，可以通过元素向其传递命令行参数�Q�如apply,exec和java��d��均可接受嵌套元素�Q�可以�ؓ各自的过�E�调用指定参数。以下是的所有属性�?
(1).values 是一个命令参数。如果参数种有空��|��但又惛_��它作为单独一个��|��则��用此属性�?
(2).file表示一个参数的文�g名。在构徏文�g中，此文件名相对于当前的工作目录�?
(3).line表示用空格分隔的多个参数列表�?
(4).path表示路径�?/p>

2.ervironment �c�d��
由Ant构徏文�g调用的外部命令或�E�序�Q?lt;env>元素制定了哪些环境变量要传递给正在执行的系�l�命令，元素可以接受以下属性�?
(1).file表示环境变量值得文�g名。此文�g名要被�{换位一个绝对�\径�?
(2).path表示环境变量的�\径。Ant会将它�{换�ؓ一个本地约定�?
(3).value 表示环境变量的一个直接变量�?
(4).key 表示环境变量名�?
注意 file path �?value只能取一个�?/p>

3.filelist�c�d��
Filelist 是一个支持命名的文�g列表的数据类型，包含在一个filelist�c�d��中的文�g不一定是

存在的文件。以下是其所有的属性�?
(1).dir是用于计��绝�Ҏ��件名的目录�?
(2).files 是用逗号分隔的文件名列表�?
(3).refid 是对某处定义的一�?lt;filelist>的引用�?
注意 dir �?files 都是必要的，除非指定了refid(�q�种情况下，dir和files都不允许使用)�?/p>

4.fileset�c�d��
Fileset 数据�c�d��定义了一�l�文�Ӟ��q��常表示�?lt;fileset>元素。不�q�，许多ant��d��构徏成了隐式的fileset,�q�说明他们支持所有的fileset属性和嵌套元素。以下�ؓfileset 的属性列表�?(1).dir表示fileset 的基目录�?
(2).casesensitive的值如果�ؓfalse�Q�那么匹配文件名�Ӟ��fileset不是区分大小写的�Q�其默认

��gؓtrue.
(3).defaultexcludes 用来��定是否使用默认的排除模式，默认为true�?
(4).excludes 是用逗号分隔的需要派出的文�g模式列表�?
(5).excludesfile 表示每行包含一个排除模式的文�g的文件名�?
(6).includes 是用逗号分隔的，需要包含的文�g模式列表�?
(7).includesfile 表示每行包括一个包含模式的文�g名�?/p>

5.patternset �c�d��
Fileset 是对文�g的分�l�，而patternset是对模式的分�l�，他们是紧密相关的概念�?lt;patternset>支持4个属性：includes excludex includexfile �?excludesfile,与fileset相同。Patternset �q�允�总�下嵌套元素：include,exclude,includefile �?excludesfile.

6.filterset �c�d��
Filterset定义了一�l�过滤器�Q�这些过滤器��在文�g�U�d��或复制时完成文�g的文本替换�?
主要属性如下：
(1).begintoken 表示嵌套�q��o器所搜烦的记��P��q�是标识其开始的字符丌Ӏ?
(2).endtoken表示嵌套�q��o器所搜烦的记可��是标识其�l�束的字�W�串�?
(3).id是过滤器的唯一标志�W��?
(4).refid是对构徏文�g中某处定义一个过滤器的引用�?/p>

7.Path�c�d��
Path元素用来表示一个类路径�Q�不�q�它�q�可以用于表�C�其他的路径。在用作揖个属性时�Q��\�l�中的各��用分号或冒号隔开。在构徏的时候，此分隔符��代替当前��^��C��所有的路径分隔�W�，其拥有的属性如下�?
(1).location 表示一个文件或目录。Ant在内部将此扩展�ؓ一个绝对�\径�?
(2).refid 是对当前构徏文�g中某处定义的一个path的引用�?
(3).path表示一个文件或路径名列表�?/p>

8.mapper�c�d��
Mapper�c�d��定义了一�l�输入文件和一�l�输出文仉��的关�p�，其属性如下�?
(1).classname 表示实现mapper�cȝ��c�d��。当内置mapper不满��求时�Q�用于创建定制mapper.
(2).classpath表示查找一个定制mapper时所用的�c�d��路径�?
(3).classpathref是对某处定义的一个类路径的引用�?
(4).from属性的含义取决于所用的mapper.
(5).to属性的含义取决于所用的mapper.
(6).type属性的取��gؓidentity�Q�flatten glob merge regexp 其中之一�Q�它定义了要是用的内�|�mapper的类型�?/p>

Ant 的运�?
安装好Ant�q�且配置好�\径之后，在命令行中切换到构徏文�g的目录，输入Ant命��o��可以运行Ant.若没有指定�Q何参敎ͼ�Ant会在当前目录下查询build.xml文�g。如果找��C��q��该文件作为构建文件。如果��用了 –find 选项�Q�Ant ��׃��在上�U�目录中找构建文�Ӟ��直至到达文�g�pȝ��得跟目录。如果构建文件的名字不是build.xml �Q�则Ant�q�行的时候就可以使用 –buildfile file ,�q�里file 指定了要使用的构建文件的名称�Q�示例如下：
Ant
如下说明了表�C�当前目录的构徏文�g为build.xml �q�行 ant 执行默认的目标�?/p>

Ant –buildfile test.xml
使用当前目录下的test.xml 文�g�q�行Ant ,执行默认的目标�?/p>

菠萝 2007-08-12 12:43 发表评论

ant中文教程

菠萝 — Tue, 07 Aug 2007 13:29:00 GMT

�q�不是很全，只有基本的内容：
1 Ant是什么？
Apache Ant 是一个基�?Java的生成工兗��?br>生成工具在��Y件开发中用来��源代码和其他输入文件�{换�ؓ可执行文件的形式�Q�也有可能�{换�ؓ可安装的产品映像形式�Q�。随着应用�E�序的生成过�E�变得更加复杂，��保在每�ơ生成期间都使用�_��相同的生成步骤，同时实现��可能多的自动化�Q�以便及时��生一致的生成版本
2 下蝲、安装Ant
安装Ant
下蝲.zip文�g�Q�解压羃到c:\ant1.3(后面引用�?ANT_HOME%)

2.1 在你�q�行Ant之前需要做一些配�|�工作�?br>? ��bin目录加入PATH环境变量�?
? 讑֮�ANT_HOME环境变量�Q�指向你安装Ant的目录。在一些OS上，Ant的脚本可以猜��ANT_HOME�Q�Unix和Windos NT/2000�Q�－但最好不要依赖这一�Ҏ��?
? 可选地�Q�设定JAVA_HOME环境变量�Q�参考下面的高�񔞮�节�Q�，该变量应该指向你安装JDK的目录�?br>注意�Q�不要将Ant的ant.jar文�g攑ֈ�JDK/JRE的lib/ext目录下。Ant是个应用�E�序�Q�而lib/ext目录是�ؓJDK扩展使用的（如JCE�Q�JSSE扩展�Q�。而且通过扩展装入的类会有安全斚w��的限制�?br>2.2 �q�行Ant

�q�行Ant非常��单，当你正确地安装Ant后，只要输入ant��可以了�?br>
? 没有指定��M��参数�Ӟ��Ant会在当前目录下查询build.xml文�g。如果找��C��q��该文件作为buildfile。如果你�?-find 选项。Ant��׃��在上�U�目录中��L��buildfile�Q�直臛_��达文件系�l�的栏V��要惌��Ant使用其他的buildfile�Q�可以用参数 -buildfile file�Q�这里file指定了你想��用的buildfile�?br>
? 可以指定执行一个或多个target。当省略target�Ӟ��Ant使用标签的default属性所指定的target�?br>

命��o行选项�ȝ��Q?br>ant [options] [target [target2 [target3] ...]]
Options:
-help print this message
-projecthelp print project help information
-version print the version information and exit
-quiet be extra quiet
-verbose be extra verbose
-debug print debugging information
-emacs produce logging information without adornments
-logfile file use given file for log output
-logger classname the class that is to perform logging
-listener classname add an instance of class as a project listener
-buildfile file use specified buildfile
-find file search for buildfile towards the root of the filesystem and use the first one found
-Dproperty=value set property to value
例子
ant
使用当前目录下的build.xml�q�行Ant�Q�执行缺省的target�?br>ant -buildfile test.xml
使用当前目录下的test.xml�q�行Ant�Q�执行缺省的target�?br>ant -buildfile test.xml dist
使用当前目录下的test.xml�q�行Ant�Q�执行一个叫做dist的target�?br>ant -buildfile test.xml -Dbuild=build/classes dist
使用当前目录下的test.xml�q�行Ant�Q�执行一个叫做dist的target�Q��ƈ讑֮�build属性的��gؓbuild/classes�?br>
3 �~�写build.xml

Ant的buildfile是用XML写的。每个buildfile含有一个project�?br>
buildfile中每个task元素可以有一个id属性，可以用这个id值引用指定的��d��。这个值必��L��唯一的。（详情请参考下面的Task��节�Q?br>
3.1 Projects

project有下面的属性：
Attribute Description Required
name ��目名称. No
default 当没有指定target时��用的�~�省target Yes
basedir 用于计算所有其他�\径的��\径。该属性可以被basedir property覆盖。当覆盖�Ӟ��该属性被忽略。如果属性和basedir property都没有设定，��׃��用buildfile文�g的父目录�?No
��目的描�q�C��一个顶�U�的元素的�Ş式出玎ͼ�参看description��节�Q��?br>
一个项目可以定义一个或多个target。一个target是一�p�d��你想要执行的。执行Ant�Ӟ��你可以选择执行那个target。当没有�l�定target�Ӟ��使用project的default属性所��定的target�?br>
3.2 Targets

一个target可以依赖于其他的target。例如，你可能会有一个target用于�~�译�E�序�Q�一个target用于生成可执行文件。你在生成可执行文�g之前必须先编译通过�Q�所以生成可执行文�g的target依赖于编译target。Ant会处理这�U�依赖关�p�R�?br>
然而，应当注意刎ͼ�Ant的depends属性只指定了target应该被执行的��序�Q�如果被依赖的target无法�q�行�Q�这�U�depends对于指定了依赖关�pȝ��target��没有媄响�?br>
Ant会依照depends属性中target出现的顺序（从左到右�Q�依�ơ执行每个target。然而，要记住的是只要某个target依赖于一个target�Q�后者就会被先执行�?br>

假定我们要执行target D。从它的依赖属性来看，你可能认为先执行C�Q�然后B�Q�最后A被执行。错了，C依赖于B�Q�B依赖于A�Q�所以先执行A�Q�然后B�Q�然后C�Q�最后D被执行�?br>
一个target只能被执行一�ơ，��x��有多个target依赖于它�Q�看上面的例子）�?br>
如果�Q�或如果不）某些属性被讑֮��Q�才执行某个target。这��P��允许�Ҏ��pȝ��的状态（java version, OS, 命��o行属性定义等�{�）来更好地控制build的过�E�。要惌��一个target�q�样做，你就应该在target元素中，加入if�Q�或unless�Q�属性，带上target因该有所判断的属性。例如：

如果没有if或unless属性，target��M��被执行�?br>
可选的description属性可用来提供关于target的一行描�q�ͼ��q�些描述可由-projecthelp命��o行选项输出�?br>
��你的tstamp task在一个所谓的初始化target是很好的做法�Q�其他的target依赖�q�个初始化target。要��保初始化target是出现在其他target依赖表中的第一个target。在本手册中大多数的初始化target的名字是"init"�?br>
target有下面的属性：
Attribute Description Required
name target的名�?Yes
depends 用逗号分隔的target的名字列表，也就是依赖表�?No
if 执行target所需要设定的属性名�?No
unless 执行target需要清除设定的属性名�?No
description 关于target功能的简短描�q��?No

3.3 Tasks

一个task是一�D�可执行的代码�?br>
一个task可以有多个属性（如果你愿意的话，可以��其�U�C��为变量）。属性只可能包含对property的引用。这些引用会在task执行前被解析�?br>
下面是Task的一般构造�Ş式：

�q�里name是task的名字，attributeN是属性名�Q�valueN是属性倹{�?br>
有一套内�|�的�Q�built-in�Q�task�Q�以及一些可选task�Q�但你也可以�~�写自己的task�?br>
所有的task都有一个task名字属性。Ant用属性值来产生日志信息�?br>
可以�l�task赋一个id属性：

�q�里taskname是task的名字，而taskID是这个task的唯一标识�W�。通过�q�个标识�W�，你可以在脚本中引用相应的task。例如，在脚本中你可以这��P��

讑֮�某个task实例的foo属性。在另一个task中（用java�~�写�Q�，你可以利用下面的语句存取相应的实例�?br>project.getReference("task1").
注意1�Q�如果task1�q�没有运行，��׃��会被生效�Q�例如：不设定属性）�Q�如果你在随后配�|�它�Q�你所作的一切都会被覆盖�?br>
注意2�Q�未来的Ant版本可能不会兼容�q�里所提的属性，因�ؓ很有可能�Ҏ��没有task实例�Q�只有proxies�?br>
3.4 Properties

一个project可以有很多的properties。可以在buildfile中用property task来设定，或在Ant之外讑֮�。一个property有一个名字和一个倹{��property可用于task的属性倹{��这是通过��属性名攑֜�"${"�?}"之间�q�放在属性值的位置来实现的。例如如果有一个property builddir的值是"build"�Q�这个property��可用于属性��|��${builddir}/classes。这个值就可被解析为build/classes�?br>
内置属�?br>
如果你��用了 task 定义了所有的�pȝ��属性，Ant允许你��用这些属性。例如，${os.name}对应操作�pȝ��的名字�?br>
要想得到�pȝ��属性的列表可参考the Javadoc of System.getProperties�?br>
除了Java的系�l�属性，Ant�q�定义了一些自��q��内置属性：
basedir project基目录的�l�对路径 (�?lt;project>的basedir属性一�?�?br>ant.file buildfile的绝对�\径�?br>ant.version Ant的版本�?br>ant.project.name 当前执行的project的名字；�?lt;project>的name属性设�?
ant.java.version Ant��到的JVM的版本；目前的值有"1.1", "1.2", "1.3" and "1.4".

例子

3.5 Path-like Structures
你可以用":"�?;"作�ؓ分隔�W�，指定�c�M��PATH和CLASSPATH的引用。Ant会把分隔�W��{换�ؓ当前�pȝ��所用的分隔�W��?br>
当需要指定类��D�\径的值时�Q�可以��用嵌套元素。一般的形式�?br>

location属性指定了相对于project基目录的一个文件和目录�Q�而path属性接受逗号或分号分隔的一个位�|�列表。path属性一般用作预定义的�\径－�Q�其他情况下�Q�应该用多个location属性�?br>
为简�z��v见，classpath标签支持自己的path和location属性。所以：

可以被简写作�Q?br>
也可通过元素指定路径。构成一个fileset的多个文件加入path-like structure的顺序是未定的�?br>

上面的例子构造了一个�\径值包括：${classpath}的�\径，跟着lib目录下的所有jar文�g�Q�接着是classes目录�?br>
如果你想在多个task中��用相同的path-like structure�Q�你可以�?lt;path>元素定义他们�Q�与target同��Q�，然后通过id属性引用－�Q�参考Referencs例子�?br>
path-like structure可能包括对另一个path-like structurede的引用（通过嵌套元素�Q�：

前面所提的关于的简�z�写法对�?lt;path>也是有效的，如：

可写成：

命��o行变�?br>
有些task可接受参敎ͼ��q�将其传递给另一个进�E�。�ؓ了能在变量中包含�I�格字符�Q�可使用嵌套的arg元素�?br>Attribute Description Required
value 一个命令行变量�Q�可包含�I�格字符�?只能用一�?br>line �I�格分隔的命令行变量列表�?
file 作�ؓ命��o行变量的文�g名；会被文�g的绝对名替代�?
path 一个作为单个命令行变量的path-like的字�W�串�Q�或作�ؓ分隔�W�，Ant会将其�{变�ؓ特定�q�_��的分隔符�?

例子

是一个含有空格的单个的命令行变量�?br>
是两个空格分隔的命��o行变量�?br>
是一个命令行变量�Q�其值在DOS�pȝ��上�ؓ\dir;\dir2;\dir3�Q�在Unix�pȝ��上�ؓ/dir:/dir2:/dir3 �?br>
References

buildfile元素的id属性可用来引用�q�些元素。如果你需要一遍遍的复制相同的XML代码块，�q�一属性就很有用－�Q�如多次使用�l�构�?br>
下面的例子：

可以写成如下形式�Q?br>

所有��用PatternSets, FileSets �?path-like structures嵌套元素的task也接受这�U�类型的引用�?br>

4.1 File�Q�Directory�Q�类
4.1.1 Mkdir
? 创徏一个目录，如果他的父目录不存在�Q�也会被同时创徏�?br>? 例子�Q?br>
? 说明�Q?如果build不存在，也会被同时创�?br>4.1.2 Copy
? 拯��一个（�l�）文�g、目�?br>? 例子�Q?br>1. 拯��单个的文�Ӟ��

2. 拯��单个的文件到指定目录�?br>
3. 拯��一个目录到另外一个目录下

4. 拯��一�Ҏ��件到指定目录�?br>

5. 拯��一�Ҏ��件到指定目录下，��文件名后增加。Bak后缀

6. 拯��一�l�文件到指定目录下，替换其中的@标签@内容

4.1.3 Delete
? 删除一个（�l�）文�g或者目�?br>? 例子
1. 删除一个文�?br>
2. 删除指定目录及其子目�?br>
3. 删除指定的一�l�文�?br>

4. 删除指定目录及其子目录，包括他自�?br>

4.1.4 Move
? �U�d��或重命名一个（�l�）文�g、目�?br>? 例子�Q?br>1. �U�d��或重命名一个文�?br>
2. �U�d��或重命名一个文件到另一个文件夹下面

3. ��一个目录移到另外一个目录下

4. ��一�l�文件移动到另外的目录下

5. �U�d��文�g�q�程中增加。Bak后缀

4.2 Java相关
4.2.1 Javac
? �~�译java原代�?br>? 例子
1. destdir="${build}"
classpath="xyz.jar"
debug="on"
/>
�~�译${src}目录及其子目录下的所有。Java文�g�Q�。Class文�g��放�?｛build｝指定的目录下，classpath表示需要用到的�c�L��件或者目录，debug讄��为on表示输出debug信息
2. destdir="${build}"
includes="mypackage/p1/**,mypackage/p2/**"
excludes="mypackage/p1/testpackage/**"
classpath="xyz.jar"
debug="on"
/>
�~�译${src}�?{src2}目录及其子目录下的所有。Java文�g�Q�但是package/p1/**,mypackage/p2/**��被�~�译�Q�而mypackage/p1/testpackage/**��不会被�~�译。Class文�g��放�?｛build｝指定的目录下，classpath表示需要用到的�c�L��件或者目录，debug讄��为on表示输出debug信息
3.

destdir="${src}"
classpath="${classpath}"
debug="on"
/>
路径是在property中定义的
4.2.2 java
? 执行指定的java�c?br>

? 例子�Q?br>1.

classname中指定要执行的类�Q�classpath讑֮�要��用的环境变量
2.

4.3 打包相关
4.3.1 jar
? ��一�l�文件打�?br>? 例子�Q?br>1.
��?{build}/classes下面的所有文件打包到${dist}/lib/app.jar�?br>2. basedir="${build}/classes"
includes="mypackage/test/**"
excludes="**/Test.class"
/>
��?{build}/classes下面的所有文件打包到${dist}/lib/app.jar中，但是包括mypackage/test�Q�所有文件不包括所有的Test.class
3. basedir="${build}/classes"
includes="mypackage/test/**"
excludes="**/Test.class"
manifest=”my.mf”
/>
manifest属性指定自��q��META-INF/MANIFEST.MF文�g�Q�而不是由�pȝ��生成
4.3.2 war
? 对Jar的扩展，用于打包Web应用
? 例子�Q?br>? 假设我们的文件目录如下：
thirdparty/libs/jdbc1.jar
thirdparty/libs/jdbc2.jar
build/main/com/myco/myapp/Servlet.class
src/metadata/myapp.xml
src/html/myapp/index.html
src/jsp/myapp/front.jsp
src/graphics/images/gifs/small/logo.gif
src/graphics/images/gifs/large/logo.gif
? 下面是我们的��d��的内容：

prefix="images"/>

? 完成后的�l�果�Q?br>WEB-INF/web.xml
WEB-INF/lib/jdbc2.jar
WEB-INF/classes/com/myco/myapp/Servlet.class
META-INF/MANIFEST.MF
index.html
front.jsp
images/small/logo.gif
images/large/logo.gif
4.3.3 ear
? 用于打包企业应用
? 例子

4.4 旉��?br>在生成环境中使用当前旉��和日期，以某�U�方式标记某个生成�Q务的输出�Q�以便记录它是何时生成的�Q�这�l�常是可取的。这可能涉及�~�辑一个文�Ӟ��以便插入一个字�W�串来指定日期和旉��Q�或��这个信息合�q�到 JAR �?zip 文�g的文件名中�?br>�q�种需要是通过��单但是非常有用的 tstamp ��d��来解决的。这个�Q务通常在某�ơ生成过�E�开始时调用�Q�比如在一�?init 目标中。这个�Q务不需要属性，许多情况下只需 ��p��够了�?br>tstamp 不��生�Q何输出；相反�Q�它�Ҏ��当前�pȝ��旉��和日期设�|?Ant 属性。下面是 tstamp 讄��的一些属性、对每个属性的说明�Q�以及这些属性可被设�|�到的值的例子�Q?br>属�?说明例子
DSTAMP 讄��为当前日期，默认格式为yyyymmdd 20031217
TSTAMP 讄��为当前时��_��默认格式�?hhmm 1603
TODAY 讄��为当前日期，带完整的月䆾 2003 �q?12 �?17 �?br>例如�Q�在前一��节中，我们按如下方式创��Z��一�?JAR 文�g�Q?br>

在调�?tstamp ��d��之后�Q�我们能够根据日期命名该 JAR 文�g�Q�如下所�C�：

因此�Q�如果这个�Q务在 2003 �q?12 �?17 日调用，�?JAR 文�g��被命名�?package-20031217.jar�?br>�q�可以配�|?tstamp ��d��来设�|�不同的属性，应用一个当前时间之前或之后的时间偏�U�，或以不同的方式格式化该字�W�串。所有这些都是��用一个嵌套的 format 元素来完成的�Q�如下所�C�：

pattern="HH:mm:ss"
offset="10" unit="minute"/>

上面的清单将 OFFSET_TIME 属性设�|��ؓ距离当前旉�� 10 分钟之后的小时数、分钟数和秒数�?br>用于定义格式字符串的字符�?java.text.SimpleDateFormat �c�L��定义的那些格式字�W�相�?br>

4.5 执行SQL语句
? 通过jdbc执行SQL语句
? 例子�Q?br>1. driver="org.gjt.mm.mysql.Driver"
url="jdbc:mysql://localhost:3306/mydb"
userid="root"
password="root"
src="data.sql"
/>
2. driver="org.database.jdbcDriver"
url="jdbc:database-url"
userid="sa"
password="pass"
src="data.sql"
rdbms="oracle"
version="8.1."
>

只有在oracle、版本是8.1的时候才执行

4.6 发送邮�?br>? 使用SMTP服务器发送邮�?br>? 例子�Q?br>

The ${buildname} nightly build has completed

? mailhost�Q?SMTP服务器地址
? mailport�Q?服务器端�?br>? subject�Q?主题
? from�Q?发送�h地址
? to�Q?接受人地址
? message�Q?发送的消息
? fileset�Q?讄��附�g

菠萝 2007-08-07 21:29 发表评论

菠萝 — Mon, 06 Aug 2007 15:53:00 GMT

作者：Eric M. Burke 来自�Q�onjava

　　�?Ant 出现之前�Q�构建和部��vJava应用需要��用包括特定��^台的脚本、Make文�g、各�U�版本的IDE甚至手工操作�?#8220;大杂�?#8221;。现在，几乎所有的开源Java��目都在使用Ant�Q�大多数公司的内部项目也在��用Ant。Ant在这些项目中的广泛��用自然导致了读者对一整套Ant最佛_��늚��q�切需求�?/p>

　　本文�ȝ��了我喜爱的Ant技巧或最佛_��践，多数是从我亲�w�经历的��目错误或我听说的其他�h�l�历�?“恐�?#8221;故事中得到灵感的。比如，有�h告诉我有个项目把XDoclet 生成的代码放入带有锁定文件功能的版本控制工具中。当开发者修�Ҏ��代码�Ӟ��他必��记住手工检出（Check out�Q��ƈ锁定所有将要重新生成的文�g。然后，手工�q�行代码生成器，只到�q�时他才能够让Ant�~�译代码�Q�这一�Ҏ��q�存在如下一些问题：

　　�?生成的代码无法存储在版本控制�pȝ��中�?
　　�?Ant�Q�本案例中是Xdoclet�Q�应该自动确定下一�ơ构建涉及的源文�Ӟ��而不应由�E�序员手工确定�?
　　�?Ant的构建文件应该定义好正确的�Q务依赖关�p�，�q�样�E�序员就不必��Z��完成构徏而不得不按照特定��序调用��d��?

　　当我开始一个新��目�Ӟ��我首先编写Ant构徏文�g。Ant文�g明确地定义构建的�q�程�Q��ƈ被团队中的每个程序员使用。本文所列的技巧基于这��L��假定�Q�Ant构徏文�g是一个必��M��l�编写的重要文�g�Q�它应在版本控制�pȝ��中得到维护，�q�被定期�q�行重构。下面是我的十五大Ant最佛_��c�?/p>

　　1. 采用一致的�~�码规范

　　Ant用户有的喜欢有的痛恨其构建文件的XML语法。与其蟩�q�这一令�h�q�h��的争��Z��Q�不如让我们先看一些能保持XML构徏文�g��z�的�Ҏ��?/p>

　　首先也是最重要的，��p��旉��格式化你的XML让它看上��d��清晰。不论XML是否��观�Q�Ant都可以工作。但是丑陋的XML很难令�h��L��。倘若你在��d��之间留出�I��Q�有规则的羃�q�，每行文字不超�q?0列左叻I��那么XML令�h惊讶地易诅R��再加上使用能够高亮XML语法的优�U��~�辑器或IDE工具�Q�你��׃��会有阅读的麻烦�?/p>

　　同样�Q�精选含意明��、容易读懂的词汇来命名�Q务和属性。比如，dir.reports��比rpts好。特定的�~�码规范�q�不重要�Q�只要拿��Z��套规范�ƈ坚持使用��p��?/p>

　　2. ��build.xml攑֜��目根目录中

　　Ant构徏文�gbuild.xml可以攑֜��M��位置�Q�但是放在项目顶�U�目录中可以保持��目��z�。这是最常用的规范，开发者能够在��目录中找到预期的build.xml。把构徏文�g攑֜�根目录中�Q�也能够使�h�Ҏ��了解��目目录树中不同目录之间的逻辑关系。以下是一个典型的��目目录层次�Q?/p>

[root dir]
| build.xml
+--src
+--lib (包含�W�三�?JAR�?
+--build (�?build��d��生成)
+--dist (�?build��d��生成)

　　当build.xml在顶�U�目录时�Q�假设你处于��目某个子目录中�Q�只要输入：ant -find compile 命��o�Q�不需要改变工作目录就能够以命令行方式�~�译代码。参�?find告诉Ant��L��存在于上�U�目录中的build.xml�q�执行�?/p>

　　3. 使用单一的构建文�?/strong>

　　有�h喜欢��一个大��目分解成几个小的构建文�Ӟ��每个构徏文�g分担整个构徏�q�程的一��部分工作。这��实是看法不同的问题�Q�但是应该认识到�Q�将构徏文�g分割会增加对整体构徏�q�程的理解难度。要注意在单一构徏文�g能够清楚表现构徏层次的情况下不要�q�工�E�化(over-engineer)�?/p>
　　即��你把��目划分为多个构建文�Ӟ��也应使程序员能够在项目根目录下找到核心build.xml。尽��该文�g只是��实际构建工作委�z��下��构徏文�g�Q�也应保证该文�g可用�?/p>
　　4. 提供良好的帮助说�?/strong>

　　应尽量��构徏文�g自文档化。增加�Q务描�q�是最��单的�Ҏ��。当你输入ant -projecthelp�Ӟ��你就可以看到带有描述的�Q务清单。比如，你可以这样定义�Q务：

   description="Compiles code, output goes to the build dir.">

　　最��单的规则是把所有你惌��E�序员通过命��o行就可以调用的�Q务都加上描述。对于一般用来执行中间处理过�E�的内部��d��Q�比如生成代码或建立输出目录�{�，��无法��用描�q�属性�?/p>
　　�q�时�Q�可以通过在构建文件中加入XML注释来处理。或者专门定义一个help��d��Q�当�E�序员输入ant help时来昄��详细的��用说明�?/p>

Detailed help...

　　5. 提供清除��d��

　　每个构徏文�g都应包含一个清除�Q务，用来删除所有生成的文�g和目录，使系�l�回到构建文件执行前的初始状态。执行清�I�Z�Q务后�q�存在的文�g都应处在版本控制�pȝ��的管理之下。比如：

    description="Destroys all generated files and dirs.">

　　除非是在产生整个�pȝ��版本的特�D��Q务中�Q�否则不要自动调用clean��d��。当�E�序员仅仅执行编译�Q务或其他��d��Ӟ��他们不需要构建文件事先执行既令�h讨厌又没有必要的清空��d��。要�怿��E�序员能够确定何旉��要清�I�所有文件�?/p>
　　6. 使用ANT��理��d��从属关系

　　假设你的应用由Swing GUI�l��g、Web界面、EJB层和公共应用代码�l�成。在大型�pȝ��中，你需要清晰地定义每个Java包属于系�l�的哪一层。否则�Q何一点修攚w��要被�q�重新编译成百上千个文�g。糟�p�的��d��从属关系��理会导致过度复杂而脆��q��pȝ��。改变GUI面板的设计不应造成Servlet和EJB的重�~�译�?/p>
　　当系�l�变得庞大后�Q�稍不注意就可能��依赖于客户端的代码引入到服务端。这是因为典型的IDE��目文�g�~�译��M��文�g都��用单一的classpath。而Ant能让你更有效地控制构建活动�?/p>
　　设计你的Ant构徏文�g�~�译大型��目的步骤：首先�Q�编译公共应用代码，��编译结果打成JAR包文件。然后，�~�译上一层的��目代码�Q�编译时依靠�W�一步��生的JAR文�g。不断重复这一�q�程�Q�直到最高层的代码编译完成�?/p>
　　分步构徏强化了�Q务从属关�pȝ��理。如果你工作在底层Java框架上，偶然引用到高层的GUI模板�l��g�Q�这时代码不需要编译。这是由于构建文件在�~�译底层框架时在源�\径中没有包含高层GUI面板�l��g的代码�?/p>
　　7. 定义�q��用文件�\�?/strong>

　　如果文�g路径在一个地方一�ơ性集中定义，�q�在整个构徏文�g中得到重用，那么构徏文�g更易于理解。以下是�q�样做的一个例子：


    ...etc











　　当项目不断增长构建日益复杂时�Q�这一技术越发体现出其�h倹{��你可能需要�ؓ�~�译不同层次的应用定义各自的文�g路径�Q�比如运行单元测试的、运行应用程序的、运行Xdoclet的、生成JavaDocs的等�{�不同�\径。这�U�组件化路径定义的方法比为每个�Q务单独定义�\径要优越得多。否则，很容易丢�׃�Q务从属关�pȝ��轨迹�?/p>
　　8. 定义恰当的�Q务从属关�p?/strong>

　　假设dist��d��从属于jar��d��Q�那么哪个�Q务从属于compile��d��哪个��d��从属于prepare��d��呢？Ant构徏文�g最�l�定义了��d��的从属关�p�d��Q�它必须被仔�l�地定义和维护�?/p>
　　应该定期��查�Q务的从属关系以保证构建工作得到正��执行。大的构建文仉��着旉��推移��向于增加更多的��d��Q�所以到最后可能由于不必要的从属关�p�d��致构建工作非常困难。比如，你可能发现在�E�序员只需�~�译一些没有��用EJB的GUI代码时又重新生成了EJB代码�?/p>
　　�?#8220;优化”的名义忽略�Q务的从属关系是另一�U�常见的错误。这�U�错误迫使程序员��Z��得到恰当的结果必��记住�ƈ按照特定的顺序调用一串�Q务。更好的做法是：提供描述清晰的公�׃�Q务，�q�些��d��包含正确的�Q务从属关�p�；另外提供一�?#8220;专家”��d��让你能够手工执行个别的构建步骤，�q�些��d��不提供完整的构徏�q�程�Q�但是让那些专家用户在快速而恼人的�~�码期间能够跌��某些步骤�?/p>
　　9.使用属�?/strong>

　　��M��需要配�|�或可能发生变化的信息都应作为Ant属性定义下来。对于在构徏文�g中多�ơ出现的��g��同样处理。属性既可以在构建文件头部定义，也可以�ؓ了更好的灉|��性而在单独的属性文件中定义。以下是在构建文件中定义属性的样式�Q?/p>

                    value="${jdom.home}/build/${jdom.jar}"/>
    etc...

　　或者你可以使用属性文�Ӟ��

   etc...

　　在属性文�?sample.properties�?

dir.build=build
dir.src=src
jdom.home=../java-tools/jdom-b8
jdom.jar=jdom.jarjdom.jar.withpath=${jdom.home}/build/${jdom.jar}

　　用一个独立的文�g定义属性是有好处的�Q�它可以清晰地定义构��Z��的可配置部分。另外，在开发者工作在不同操作�pȝ��的情况下�Q�你可以在不同的�q�_��上提供该文�g的不同版本�?/p>
　　10. 保持构徏�q�程独立

　　��Z��最大限度的扩展性，不要应用外部路径和库文�g。最重要的是不要依赖于程序员的CLASSPATH讄��。取而代之的是，在构建文件中使用相对路径�q�定义自��q��路径。如果你引用了绝对�\径如C:\java\tools�Q�其他开发者未必��用与你相同的目录�l�构�Q�所以就无法使用你的构徏文�g�?/p>
　　如果你部�|�开放源码项目，应该提供包含�~�译代码所需的所有JAR文�g的发行版本。当�Ӟ��q�是在遵守许可协议的基础上。对于内部项目，相关的JAR文�g都应在版本控制系�l�的��理中，�q�捡出（check out�Q�到大家都知道的位置�?/p>
　　当你必须引用外部路径�Ӟ��应将路径定义为属性。�ɽE�序员能够用适合他们自己的机器环境的参数重蝲�q�些属性。你也可以��用以下语法引用环境变量：

　　11. 使用版本控制�pȝ��

　　构徏文�g是一个重要的制品�Q�应该像代码一栯��行版本控制。当你标��C��的代码时�Q�也应用同样的标�{�标记构建文件。这样当你需要回溯到旧版本�ƈ�q�行构徏�Ӟ��能够使用相应版本的构建文件�?/p>
　　除构建文件之外，你还应在版本控制中维护第三方JAR文�g。同��P��q��你能够重新构建旧版本的��Y件。这也能够更�Ҏ��保证所有开发者拥有一致的JAR文�g�Q�因��Z��们都是同构徏文�g一起从版本控制�pȝ��中捡出的�?/p>
　　通常应避免在版本控制�pȝ��中存放构建成果。倘若你的源代码很好地得到了版本控�Ӟ��那么通过构徏�q�程你能够重新生成�Q何版本的产品�?/p>
　　12. 把Ant作�ؓ“最��公分母”

　　假设你的开发团队��用IDE工具�Q�当�E�序员通过点击图标��p��够构建整个应用时��Z��么还要�ؓAnt而烦恼呢�Q?/p>
　　IDE的问题是一个关于团队一致性和重现性的问题。几乎所有的IDE设计初衷都是��Z��提高�E�序员的个�h生��率，而不是开发团队的持箋构徏。典型的IDE要求每个�E�序员定义自��q��目文�g。程序员可能拥有不同的目录结构，可能使用不同版本的库文�g�Q�还可能工作在不同的�q�_��上。这��导致出现这�U�情况：在Bob那里�q�行良好的代码，到Sally那里��无法运行�?/p>
　　不管你的开发团队��用何�U�IDE�Q�一定要建立所有程序员都能够��用的Ant构徏文�g。要建立一个程序员在将��C��码提交版本控制系�l�前必须执行Ant构徏文�g的规则。这��确保代码是�l�过同一个Ant构徏文�g构徏的。当出现问题�Ӟ��要��用项目标准的Ant构徏文�g�Q�而不是通过某个IDE来执行一个干净的构建�?/p>
　　�E�序员可以自由选择��M��他们习惯使用的IDE工具或编辑器。但是Ant应作为公共基�U�以保证代码永远是可构徏的�?/p>
　　13. 使用zipfileset属�?/strong>

　　��Z��l�常使用Ant产生WAR、JAR、ZIP�?EAR文�g。这些文仉��常都要求有一个特定的内部目录�l�构�Q�但其往往与你的源代码和编译环境的目录�l�构不匹配�?/p>
　　一个最常用的方法是写一个Ant��d��Q�按照期望的目录�l�构把一大堆文�g拯��C��时目录中�Q�然后生成压�~�文件。这不是最有效的方法。��用zipfileset属性是更好的解��x��案。它让你从�Q何位�|�选择文�g�Q�然后把它们按照不同目录�l�构放进压羃文�g中。以下是一个例子：

    appxml="${dir.resources}/application.xml">












　　在这个例子中�Q�所有JAR文�g都放在EAR文�g包的lib目录中。hr.jar和billing.jar是从构徏目录拯��q�来的。因此我们��用zipfileset属性把它们�U�d��到EAR文�g包内部的lib目录。prefix属性指定了其在EAR文�g中的目标路径�?/p>
　　14. ��试Clean��d��

　　假设你的构徏文�g中有clean和compile的�Q务，执行以下的测试。第一步，执行ant clean�Q�第二步�Q�执行ant compile�Q�第三步�Q�再执行ant compile。第三步应该不作��M��事情。如果文件再�ơ被�~�译�Q�说明你的构建文件有问题�?/p>
　　构徏文�g应该只在与输出文件相兌��的输入文件发生变化时执行��d��。一个构建文件在不必执行诸如�~�译、拷贝或其他工作��d��的时候执行这些�Q务是低效的。当��目规模增长�Ӟ��即��是小的低效工作也会成为大的问题�?/p>
　　15. 避免特定�q�_��的Ant��装

　　不管什么原因，有�h喜欢用简单的、名�U�叫做compile之类的批文�g或脚本装载他们的产品。当你去看脚本的内容你会发现以下内容�Q?/p>
　　ant compile

　　其实开发�h员都很熟悉Ant�Q��ƈ且完全能够自己键入ant compile。请不要仅仅��Z��调用Ant而��用特定��^台的脚本。这只会使其他�h在首�ơ��用你的脚本时增加学习和理解的烦扰。除此之外，你不可能提供适用于每个操作系�l�的脚本�Q�这是真正烦扰其他用��L��地方�?/p>
　　�ȝ��

　　太多的公�怾�靠手工方法和特别�E�序来编译代码和生成软�g发布版本。那些不使用Ant或类似工具定义构��E�的开发团队，��p��了太多的旉��来捕捉代码编译过�E�中出现的问题：在某些开发者那里编译成功的代码�Q�到另一些开发者那里却��p�|了�?/p>
　　生成�q�维护构��本不是一��富有魅力的工作�Q�但却是一��必需的工作。一个好的Ant构徏文�g��你能够集中到更喜�Ƣ的工作——写代码中去�Q?/p>
　　参�?/strong>

　　�?http://ant.apache.org/ Ant
　　�?http://www.ericburke.com/ AntGraph: Ant依赖性的可视化工�?
　　�?http://www.oreilly.com/catalog/anttdg/index.html?CMP=IL7015 Ant: The Definitive Guide, O'Reilly
　　�?http://www.oreilly.com/catalog/jextprockbk/index.html?CMP=IL7015 Java Extreme Programming Cookbook, O'Reilly

　　原文�Q?a target=_blank>http://www.onjava.com/pub/a/onjava/2003/12/17/ant_bestpractices.html
　　��译�Q�徐�?MSN:xt121@hotmail.com

菠萝 2007-08-06 23:53 发表评论