# AntPlugins

**Repository Path**: azhengzz/ant-plugins

## Basic Information

- **Project Name**: AntPlugins
- **Description**: Ant拓展插件
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-25
- **Last Updated**: 2024-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AntPlugins

#### 介绍
Ant拓展插件


#### 安装教程

1.  将工程`dist`目录下的jar包放到`ant`工具的`lib`目录下即可

#### 使用说明

1.  `ant-sed-command.jar` 支持将指定文件中的字符或字符串替换成另一个字符或字符串

示例：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project name="test" default="run">
    <target name="run">  
        ...
        <typedef name="sed" classname="SedCommand.SedTask" />
        <!--替换特殊字符为空字符串-->
        <sed sourceText="&amp;#x0;" replaceText="" jtlFile="${jmeter.result.jtlName}" />
        ...
    </target>  
</project>
```

#### 二次开发Demo
`ant-demo.jar` 是一个demo示例，介绍了二次开发Ant Task基本知识点，包括参数类型的转换、Task支持嵌套元素、buildEvent事件监听

示例:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project name="test" default="run">
    <target name="example-1">  
        <typedef name="demo" classname="DemoPackage.DemoTask" />
        <demo varBoolean="false" 
              varChar="123" 
              varFile="手册.pdf" 
              varResource="手册.pdf;" 
              varPath="手册.pdf;run.bat"
              varClass="SedCommand.SedTask"
              varAnyClassInstance="hello"
        />
    </target>   
    <target name="example-2" depends="example-1">
        <typedef name="dc" classname="DemoPackage.DemoContainerTask" />
        <dc name="测试嵌套元素">
            <args value="参数1" />
            <args value="参数2" />
            <args value="参数3" />
        </dc>
    </target>
    <target name="run" depends="example-2" />
</project>
```
执行ant并监听build event
```shell script
ant -f build.xml -listener DemoPackage.DemoListener
```
输出结果:
```
PS C:\Users\***\Desktop> ant -f build.xml -listener DemoPackage.DemoListener
Buildfile: C:\Users\***\Desktop\build.xml
DemoListener: buildStarted org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.Project@14514713]

example-1:
DemoListener: targetStarted org.apache.tools.ant.BuildEvent[source=example-1]
  [typedef] DemoListener: taskStarted org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@7a7b0070]
DemoListener: taskFinished org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@7a7b0070]
     [demo] DemoListener: taskStarted org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@2b80d80f]
     [demo] Init TestClass, passed a string is hello
     [demo] Message: Parameter varBoolean is false
     [demo] Message: Parameter varChar is 1
     [demo] Message: Parameter varFile is C:\Users\***\Desktop\手册.pdf
     [demo] Message: Parameter varResource is C:\Users\***\Desktop\手册.pdf;
     [demo] Message: Parameter varPath is C:\Users\***\Desktop\手册.pdf;C:\Users\***\Desktop\run.bat
     [demo] Message: Parameter varClass is class SedCommand.SedTask
     [demo] Message: Parameter varAnyClassInstance is DemoPackage.TestClass@4563e9ab
DemoListener: taskFinished org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@2b80d80f]
DemoListener: targetFinished org.apache.tools.ant.BuildEvent[source=example-1]

example-2:
DemoListener: targetStarted org.apache.tools.ant.BuildEvent[source=example-2]
  [typedef] DemoListener: taskStarted org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@11531931]
DemoListener: taskFinished org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@11531931]
       [dc] DemoListener: taskStarted org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@4cdbe50f]
       [dc] Message: Parameter name is 测试嵌套元素
       [dc] Message: Nested Element Parameter args is [Arg{value='参数1'}, Arg{value='参数2'}, Arg{value='参数3'}]
DemoListener: taskFinished org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.UnknownElement@4cdbe50f]
DemoListener: targetFinished org.apache.tools.ant.BuildEvent[source=example-2]

run:
DemoListener: targetStarted org.apache.tools.ant.BuildEvent[source=run]
DemoListener: targetFinished org.apache.tools.ant.BuildEvent[source=run]

BUILD SUCCESSFUL
Total time: 0 seconds
DemoListener: buildFinished org.apache.tools.ant.BuildEvent[source=org.apache.tools.ant.Project@14514713]
PS C:\Users\***\Desktop>
```