Return-Path: 
 <user-return-49925-apmail-ant-user-archive=ant.apache.org@ant.apache.org>
Delivered-To: apmail-ant-user-archive@www.apache.org
Received: (qmail 79498 invoked from network); 28 Apr 2005 12:47:28 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 28 Apr 2005 12:47:28 -0000
Received: (qmail 46973 invoked by uid 500); 28 Apr 2005 12:48:16 -0000
Delivered-To: apmail-ant-user-archive@ant.apache.org
Received: (qmail 46930 invoked by uid 500); 28 Apr 2005 12:48:15 -0000
Mailing-List: contact user-help@ant.apache.org; run by ezmlm
Precedence: bulk
List-Unsubscribe: <mailto:user-unsubscribe@ant.apache.org>
List-Subscribe: <mailto:user-subscribe@ant.apache.org>
List-Help: <mailto:user-help@ant.apache.org>
List-Post: <mailto:user@ant.apache.org>
List-Id: "Ant Users List" <user.ant.apache.org>
Reply-To: "Ant Users List" <user@ant.apache.org>
Delivered-To: mailing list user@ant.apache.org
Received: (qmail 46898 invoked by uid 99); 28 Apr 2005 12:48:15 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=
X-Spam-Check-By: apache.org
Received-SPF: pass (hermes.apache.org: local policy)
Received: from maillnx-us111.fmr.com (HELO maillnx-us111.fmr.com)
 (192.223.198.26)
  by apache.org (qpsmtpd/0.28) with ESMTP; Thu, 28 Apr 2005 05:48:14 -0700
Received: from MSGMMKSM02WIN.DMN1.FMR.COM (msgmmksm02win.dmn1.fmr.com
 [10.33.139.33])
	by maillnx-us111.fmr.com (Switch-3.1.2/Switch-3.1.0) with SMTP id
 j3SCl0RB024001
	for <user@ant.apache.org>; Thu, 28 Apr 2005 08:47:02 -0400
Received: from MSGMMKIV01WIN.DMN1.FMR.COM (10.33.148.30)
	by MSGMMKSM02WIN.DMN1.FMR.COM (Sigaba Gateway v3.83)
	with ESMTP id 26634516; Thu, 28 Apr 2005 08:46:59 -0400
Received: from MSGMMKIM02WIN.DMN1.FMR.COM ([172.25.108.84]) by
 MSGMMKIV01WIN.DMN1.FMR.COM with SMTP_server; Thu, 28 Apr 2005 08:46:59 -0400
Received: from MSGMMKCLE2WIN.fmr.com ([10.33.152.61]) by
 MSGMMKIM02WIN.DMN1.FMR.COM with Microsoft SMTPSVC(5.0.2195.6713);
	 Thu, 28 Apr 2005 08:46:58 -0400
X-MimeOLE: Produced By Microsoft Exchange V6.0.6603.0
content-class: urn:content-classes:message
MIME-Version: 1.0
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
Subject: FilterSet vs FilterChains
Date: Thu, 28 Apr 2005 08:46:58 -0400
Message-ID: 
 <FD418CD10045D543B84D08DBA57BDEFC044DA6C8@MSGMMKCLE2WIN.DMN1.FMR.COM>
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
Thread-Topic: FilterSet vs FilterChains
Thread-Index: AcVL150tIJrVL5hYT+aIfHaqxgVPpwAE27pQ
From: "Dick, Brian E." <Brian.Dick@FMR.com>
To: "Ant Users List" <user@ant.apache.org>
X-OriginalArrivalTime: 28 Apr 2005 12:46:58.0925 (UTC)
 FILETIME=[5DE1F1D0:01C54BF0]
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

<braindump>

There is a little overlap between FilterSet and FilterChain types, but
otherwise the two types are quite different.

For example the following two copy tasks are equivalent.

   <copy file=3D"${src.file}" tofile=3D"${dest.file}">
      <filterset>
         <filter token=3D"DATE" value=3D"${TODAY}"/>
      </filterset>
   </copy>

   <copy file=3D"${src.file}" tofile=3D"${dest.file}">
      <filterchain>
         <replacetokens>
            <token key=3D"DATE" value=3D"${TODAY}"/>
         </replacetokens>
      </filterchain>
   </copy>

The FilterSet type does token replacement. A FilterSet can be named and
referenced (reused) later. They also can be aggregated by using nesting.
In addition to the inline enumeration of token/value pairs, the
token/value pairs can be loaded from a file.

The FilterChain type can do a variety of different file transformations
in addition to simple token replacement. The documentation equates the
FilterChain type to Unix pipes. The supplied  nested elements provide
transformations for extracting Java class constants, escaping Unicode
characters, stripping comments, and many more. There is also an optional
filter that can execute an Apache BSF script. This makes the FilterChain
type easily extensible.

If the <replacetokens> element of the FilterChain type supported the
features of the FilterSet type (naming, nesting, file loading), the
FilterSet type would be obsolete.

</braindump>

---------------------------------------------------------------------
To unsubscribe, e-mail: user-unsubscribe@ant.apache.org
For additional commands, e-mail: user-help@ant.apache.org