Ant类型之FilterChain

一、概述

        FilterChain是一组FilterReader，用户可以通过继承java.io.FilterReader类来定义自己的FilterReader。通过使用filterreader元素可以轻松的将自定义的FilterReader做为嵌套元素插入到filterchain中。通过FilterChain，ant可以灵活的进行数据的转换。支持FilterChain的task有：concat、copy、loadfile、loadproperties、move。过滤器链是通过嵌套0到多个过滤器形成的。Ant提供了一些内置的过滤器。

二、内置过滤器

        FilterReader：一个定义过滤器的通用方法。可以用它在构建文件中定义用户自定义的过滤器元素。内置的过滤器也可以通过这种方式进行定义。filterreader元素必须提供一个classname属性，用这个名称解析的类必须继承java.io.FilterReader。如果自定义的过滤器需要参数化，必须实现org.apache.tools.type.Parameterizable。
                classname：filterreader的类名。
        filterreader支持嵌套classpath和param元素，每个param可以接受name、type和value属性。其他的过滤器也默认支持。

        ClassConstants：过滤java类中定义的基本常量，并以name=value的格式按行输出。此过滤器需要bcel包来解析java类文件。此过滤器与大多数操作字符序列的过滤器不同，此过滤器在组成类的字节序列上进行操作，但是字节到达过滤器后是字符序列，所以在使用字符编码时要格外注意，大多数编码信息会从任意字节序列转为字符，在转回字节的过程中丢失。特别是常用的默认字符编码（CP152和UTF8）。因此，从ant1.7起，从字符转换到字节采用ISO-8859-1编码，也必须使用这个编码读取java类文件。

        EscapeUnicode：ant1.6起，将输入的所有非US-ASCII字符更改为等效的\u加上4位数字的unicode转义。

        ExpandProperties：如果数据包含${}格式的ant属性，过滤器会将其替换为实际的值。ant1.8.3起，可以嵌套propertyset元素。

        HeadFilter：读取提供给过滤器的数据的前几行。具有以下属性：
                lines：读取的行数，默认为10。
                skip：跳过的行数，默认为0。

        LineContains：只包含用户指定字符串的行。具有以下属性：
                contains：要包含的字符串。只能作为嵌套元素使用，支持多个contains元素。
                negate：ant1.7起，是否只选择不包含指定字符串的行。

        LineContainsRegExp：只包含与用户指定的正则表达式匹配的字符串的行。具有以下属性：
                regexp：正则表达式。只能作为嵌套元素使用，支持多个contains元素。有关嵌套元素regexp的说明，请参考regexp类型。
                negate：ant1.7起，是否只选择不包含与指定正则表达式匹配的字符串的行。
                caseseneitive：ant1.8.2起，是否区分大小写，默认为true。

        PrefixLines：每一行附加一个前缀。具有以下属性：
                prefix：附加到行的前缀。

        SuffixLines：ant1.8起，每一行附加一个后缀。具有以下属性：
                suffix：附加到行的后缀。

        ReplaceTokens：将开始标记和结束标记之间的所有字符串替换为用户定义的值。具有以下属性：
                begintoken：开始标记，默认为@。
                endtoken：结束标记，默认为@。
                token：用户定义的字符标记。只能做为嵌套元素使用。
                propertiesfile：获取标记字符的属性文件。只能在通过filterreader方式使用ReplaceTokens时使用。
                value：字符标记替换的值，token的属性。

        StripJavaComments：使用java语法准则从数据中去除注释。不支持任何属性。

        StripLineBreaks：从数据中去除特定的字符。具有以下属性：
                linebreaks：要去掉的字符，默认为“\r\n”。

        StripLineComments：删除以用户指定的注释起始字符串开头的行。
                comment：当出现在行的开头时，将此行识别为注释的字符串。

        TabsToSpaces：用空格替换制表符。具有以下属性：
                tablength：替换的空格数量，默认为8。

        TailFilter：读取提供给过滤器的数据的最后几行。具有以下属性：
                lines：读取的行数，默认为10。如果为-1，表示读取所有的行。
                skip：从后面跳过的行数，默认为0。

        DeleteCharacters：ant1.6起，删除指定的字符。具有以下属性：
                chars：要删除的字符，支持转义。

        ConcatFilter：ant1.6起，预写或附加内容文件到过滤后的文件。具有以下属性：
                prepend：内容将预写到文件的文件名。
                append：内容将附加到文件的文件名。

        TokenFilter：ant1.6起，将输入切分为一组字符串，并将这组字符串传递给字符串过滤器，与其他过滤器不同，TokenFilter不支持param元素。分词器和字符串过滤器通过嵌套元素定义。只能定义一个分词器，如果没有指定默认为LineTokenizer，可以有0到多个字符串过滤器。字符串过滤器处理分词字符串后返回字符串或者null。如果返回字符串，会将字符串传递到下一个过滤器，直到所有的过滤器都被调用。如果所有过滤器都调用后返回的是字符串，会将字符串与相关的分词分隔符输出。分隔符可以通过delimOutput属性覆盖。具有以下属性：
                delimOutput：如果不为空，覆盖分词器返回的分隔符。
        默认分词器有：
                LineTokenizer：将输入切分成行，分词器通过“\r”、“\n”或者“\r\n”分隔行。是默认的分词器。具有以下属性：
                        includeDelims：是否包含行结尾，默认为false。
                FileTokenizer：将所有的输入做为一个分词字符串。所以不要在很大的输入上用这个分词器。
                StringTokenizer：基于java.util.StringTokenizer。将输入按照空格或者指定的分隔符切分成一组字符串。如果输入以分隔符开头，第一个字符会是空字符串。具有以下属性：
                        delims：分隔符，默认为空格，
                        delimsaretokens：如果设置为true，每个分隔符也会返回，默认为false。
                        suppressdelims：如果设置为true，不返回分隔符，默认为false。
                        includeDelims：如果设置为true，分词字符串包含分隔符，默认为false。
        默认字符串过滤器有：

                ReplaceString：一个简单的字符串替换过滤器，可以被FilterChain直接使用。具有以下属性：
                        form：要被替换的字符串。
                        to：被替换字符串的新值，如果不设置，默认为空字符串。
                ContainsString：过滤包含自定字符串的分词字符串。具有以下属性：
                        contains：要包含的字符串。
                ReplaceRegex：替换匹配正则表达式字符串的过滤器，可以被FilterChain直接使用。具有以下属性：
                        pattern：要匹配的正则表达式。
                        replace：替换匹配正则表达式字符串的字符串。默认为空字符串。
                        flags：匹配正则表达式所使用的模式，可选值有g（全局替换，替换所有匹配项）、i（不区分大小写）、m（多行匹配模式，使用^和$做为任一行的开始和结束）、s（单行模式，“.”可以与任意字符匹配，包括换行符，所有的输入看作是一行）。
                ContainsRegex：过滤匹配正则表达式的字符串。还可以选择替换与正则表达式匹配的字符串。可以被FilterChain直接使用。具有以下属性：
                        pattern：要匹配的正则表达式。
                        replace：替换匹配正则表达式字符串的字符串。默认为原始字符串。
                        flags：匹配正则表达式所使用的模式，可选值有g（全局替换，替换所有匹配项）、i（不区分大小写）、m（多行匹配模式，使用^和$做为任一行的开始和结束）、s（单行模式，“.”可以与任意字符匹配，包括换行符，所有的输入看作是一行）。
                Trim：去掉字符串开始和结束的空格，可以被FilterChain直接使用。
                IgnoreBlank：移除空的分词字符串，可以被FilterChain直接使用。
                DeleteCharacters：从分词字符串中删除自定字符，具有以下属性：
                        chars：要删除的字符，支持转义。
                UniqFilter：去掉重复的分词字符串，可以被FilterChain直接使用。
                ScriptFilter：执行支持BSF或者JSR223语言的脚本。script提供了包含getToken()和setToken(String) 方法的self对象。可以被FilterChain直接使用。具有以下属性：
                        language：编写脚本的程序语言，必须是支持BSF或者JSR223的语言。
                        manager：使用的脚本引擎管理器。可选值有：bsf（BSF脚本管理器）、javax（jdk1.6+支持的JSR223脚本管理器）、auto（如果bsf存在使用bsf，否则使用javax），默认为auto。
                        src：如果脚本不是嵌套在标签中，设置脚本文件的位置。
                        setbeans：ant1.8起，是否在脚本中设置所有属性、引用和targets。如果设置为false，只有project和self可用。默认为true。
                        classpath：传递到脚本的类路径。
                        classpathref：使用的类路径引用。

        FixCRLF：见ant内置任务fixcrlf。

        SortFilter：ant1.8起，读取所有行并进行排序，顺序可以反转，可以自定义java.util.Comparator接口的实现来进行更多的控制。
                reverse：是否反转顺序，默认为false。如果设置了comparator属性，则忽略此属性。
                comparator：实现了java.util.Comparator的类的名字。此类用于确定行的排列顺序。

三、简单示例

<project> <loadproperties srcfile="E:\workspace\trans\bin\com\run\ayena\trans\core\Trans.class" encoding="ISO-8859-1"> <filterchain> <classconstants/> </filterchain> </loadproperties> <echo message="${REMOTE}"/> <property name="name" value="FilterChain"/> <property name="reader" value="FilterReader"/> <copy file="demo.txt" tofile="escapeunicode.txt"> <filterchain> <escapeunicode/> </filterchain> </copy> <copy file="demo.txt" tofile="expandproperties.txt"> <filterchain> <expandproperties/> </filterchain> </copy> <copy file="demo.txt" tofile="headfilter.txt"> <filterchain> <headfilter lines="3" skip="2"/> </filterchain> </copy> <copy file="demo.txt" tofile="linecontains.txt"> <filterchain> <linecontains > <contains value="嵌套" /> </linecontains> </filterchain> </copy> <copy file="demo.txt" tofile="linecontainsregexp.txt"> <filterchain> <linecontainsregexp casesensitive="false"> <regexp pattern="FilterChain*"/> </linecontainsregexp> </filterchain> </copy> <copy file="demo.txt" tofile="prefixlines.txt"> <filterchain> <prefixlines prefix="prefix"/> </filterchain> </copy> <copy file="demo.txt" tofile="suffixlines.txt"> <filterchain> <suffixlines suffix="suffix"/> </filterchain> </copy> <copy file="tokendemo.txt" tofile="replacetokens.txt"> <filterchain> <replacetokens begintoken="@" endtoken="@"> <token key="name" value="${name}"/> <token key="reader" value="${reader}"/> </replacetokens> </filterchain> </copy> <copy file="tokendemo.txt" tofile="replacetokens1.txt"> <filterchain> <filterreader classname="org.apache.tools.ant.filters.ReplaceTokens"> <param type="propertiesfile" value="token.properties"/> <param type="begintoken" value="@"/> <param type="endtoken" value="@"/> </filterreader> </filterchain> </copy> <copy file="demo.txt" tofile="stripjavacomments.txt"> <filterchain> <stripjavacomments /> </filterchain> </copy> <copy file="demo.txt" tofile="striplinebreaks.txt"> <filterchain> <striplinebreaks linebreaks="/*"/> </filterchain> </copy> <copy file="demo.txt" tofile="striplinecomments.txt"> <filterchain> <striplinecomments> <comment value="--"/> <comment value="#"/> <comment value="//"/> </striplinecomments> </filterchain> </copy> <copy file="demo.txt" tofile="tabstospaces.txt"> <filterchain> <tabstospaces tablength="16"/> </filterchain> </copy> <copy file="demo.txt" tofile="tailfilter.txt"> <filterchain> <tailfilter lines="-1" skip="3"/> </filterchain> </copy> <copy file="demo.txt" tofile="deletecharacters.txt"> <filterchain> <deletecharacters chars="n\r\n\t " /> </filterchain> </copy> <copy file="demo.txt" tofile="concatfilter.txt"> <filterchain> <concatfilter append="token.properties" prepend="token.properties"/> </filterchain> </copy> <copy file="demo.txt" tofile="tokenfilter.txt"> <filterchain> <tokenfilter delimOutput="\t"> <stringtokenizer delims="/"/> <replacestring from="concat" to="Concat"/> <replaceregex pattern="Concat" replace="concat" flags="gi"/> <containsstring contains="concat"/> <containsregex pattern="concat*"/> <trim/> <ignoreblank/> <scriptfilter language="javascript"> self.setToken(self.getToken().toUpperCase()); </scriptfilter> </tokenfilter> </filterchain> </copy> <copy file="demo.txt" tofile="fixcrlf.txt"> <filterchain> <fixcrlf tab="add" eof="add" fixlast="false"/> </filterchain> </copy> <copy file="demo.txt" tofile="sortfilter.txt"> <filterchain> <sortfilter reverse="true"/> </filterchain> </copy> </project>