<file-iterator>
Builds a collection of file names within a specified directory and iterates over them. Use optional pattern expressions to specify groups of files to include or exclude.
| Name | XPath | Description | Reagent Type | Expected Type | Required |
|---|---|---|---|---|---|
| ATTRIBUTE_NAME | @attribute-name | Each file will be registered as a request attribute under this name during iteration. | PHRASE | java.lang.String | No |
| DIR | @dir | File system location of a directory from which to begin matching files. The default is the directory from which Java is executing. | PHRASE | java.lang.String | No |
| INCLUDES | @includes | Optional comma-separated list of pattern expressions specifying files to include (e.g. *, *.jpg, **/*.java). Files that match the pattern must be included, even if they also match the EXCLUDES pattern. The default is ** (i.e. all files). | PHRASE | java.lang.String | No |
| EXCLUDES | @excludes | Optional comma-separated list of pattern expressions specifying files to exclude from the result set (e.g. *, *.jpg, **/*.java). No files will be excluded if this phrase is omitted. | PHRASE | java.lang.String | No |
| SUBTASKS | * | The set of tasks that are children of this task. | NODE_LIST | java.util.List | No |
Copies all files from 'some_folder' to 'another_folder':
<file-iterator dir="some_folder">
<copy-file to-dir="another_folder"/>
</file-iterator>