[Index]

repeat

This job will repeatedly run its child job. The repeat can be either for:

Each value of a collection.
Or a given number times.
Or until the until property is true.

Without either a until or a times or values the job will loop indefinitely.

Property Summary

count	The count of repeats.
current	The current value of the repeat.
index	The same as count.
job	The job who's execution to schedule.
name	A name, can be any text.
stop	Read only view of the internal stop flag.
times	The number of times to repeat.
until	Repeat will repeat until the value of this property is true.
values	Values to repeat over.

Example Summary

Example 1	Repeat a job 3 times.
Example 2	Repeat a job 3 times with a sequence.

Property Detail

count

Access	READ_ONLY
Required	Read Only.

The count of repeats.

current

Access	READ_ONLY
Required	Read Only.

The current value of the repeat.

index

Access

READ_ONLY

The same as count. Provided so configurations can be swapped between this and foreach job.

job

Configured By	ELEMENT
Access	WRITE_ONLY
Required	Yes.

The job who's execution to schedule.

name

Configured By	ATTRIBUTE
Access	READ_WRITE
Required	No.

A name, can be any text.

stop

Access	READ_ONLY
Required	Read only.

Read only view of the internal stop flag. This flag is cleared with a reset.

times

Configured By	ATTRIBUTE
Access	READ_WRITE
Required	No.

The number of times to repeat.

until

Configured By	ELEMENT
Access	READ_WRITE
Required	No.

Repeat will repeat until the value of this property is true.

values

Configured By	ELEMENT
Access	READ_WRITE
Required	No.

Values to repeat over.

Examples

Example 1

Repeat a job 3 times.

<oddjob>
    <job>
        <repeat times="3" id="repeat">
            <job>
                <echo>Hello ${repeat.count}</echo>
            </job>
        </repeat>
    </job>
</oddjob>

Example 2

Repeat a job 3 times with a sequence.

<oddjob>
    <job>
        <repeat id="each">
            <values>
                <sequence from="1" to="3"/>
            </values>
            <job>
                <echo>Hello ${each.current}</echo>
            </job>
        </repeat>
    </job>
</oddjob>