Repeater (Apache Brooklyn)

java.lang.Object
- brooklyn.util.internal.Repeater

Deprecated.

since 0.7.0, use Repeater instead

@Deprecated
public class Repeater
extends java.lang.Object

Simple DSL to repeat a fragment of code periodically until a condition is satisfied. In its simplest case, it is passed two Closures / Callable - the first is executed, then the second. If the second closure returns false, the loop is repeated; if true, it finishes. Further customization can be applied to set the period between loops and place a maximum limit on how long the loop should run for.

It is configured in a fluent manner. For example, in Groovy:

 Repeater.create("Wait until the Frobnitzer is ready")
     .repeat {
         status = frobnitzer.getStatus()
     }
     .until {
         status == "Ready" || status == "Failed"
     }
     .limitIterationsTo(30)
     .run()

Or in Java:

 Repeater.create("Wait until the Frobnitzer is ready")
     .until(new Callable<Boolean>() {
              public Boolean call() {
                  String status = frobnitzer.getStatus()
                  return "Ready".equals(status) || "Failed".equals(status);
              }})
     .limitIterationsTo(30)
     .run()

Constructor Summary

Constructors
Constructor and Description
`Repeater()` Deprecated.
`Repeater(java.util.Map<?,?> flags)` Deprecated.
`Repeater(java.util.Map<?,?> flags, java.lang.String description)` Deprecated. Construct a new instance of Repeater.
`Repeater(java.lang.String description)` Deprecated.

Method Summary

Methods
Modifier and Type	Method and Description
`static Repeater`	`create()` Deprecated.
`static Repeater`	`create(java.util.Map<?,?> flags)` Deprecated.
`static Repeater`	`create(java.util.Map<?,?> flags, java.lang.String description)` Deprecated.
`static Repeater`	`create(java.lang.String description)` Deprecated.
`Repeater`	`every(Duration duration)` Deprecated.
`Repeater`	`every(groovy.time.Duration duration)` Deprecated.
`Repeater`	`every(long duration)` Deprecated. specify unit
`Repeater`	`every(long period, java.util.concurrent.TimeUnit unit)` Deprecated. Set how long to wait between loop iterations.
`Repeater`	`limitIterationsTo(int iterationLimit)` Deprecated. Set the maximum number of iterations.
`Repeater`	`limitTimeTo(Duration duration)` Deprecated.
`Repeater`	`limitTimeTo(long deadline, java.util.concurrent.TimeUnit unit)` Deprecated. Set the amount of time to wait for the condition.
`Repeater`	`repeat()` Deprecated. Sets the main body of the loop to be a no-op.
`Repeater`	`repeat(java.util.concurrent.Callable<?> body)` Deprecated. Sets the main body of the loop.
`Repeater`	`repeat(java.lang.Runnable body)` Deprecated. Sets the main body of the loop.
`Repeater`	`rethrowException()` Deprecated. If the exit condition check throws an exception, it will be recorded and the last exception will be thrown on failure.
`Repeater`	`rethrowExceptionImmediately()` Deprecated. If the repeated body or the exit condition check throws an exception, then propagate that exception immediately.
`boolean`	`run()` Deprecated. Run the loop.
`void`	`setFromFlags(java.util.Map<?,?> flags)` Deprecated.
`Repeater`	`suppressWarnings()` Deprecated.
`Repeater`	`until(java.util.concurrent.Callable<java.lang.Boolean> exitCondition)` Deprecated. Set code fragment that tests if the loop has completed.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Repeater
```
public Repeater()
```
    Deprecated.
  - Repeater
```
public Repeater(java.util.Map<?,?> flags)
```
    Deprecated.
  - Repeater
```
public Repeater(java.lang.String description)
```
    Deprecated.
  - Repeater
```
public Repeater(java.util.Map<?,?> flags,
        java.lang.String description)
```
    Deprecated.
    
    Construct a new instance of Repeater.
    
    Parameters:
    flags - can include period, timeout, description
    description - a description of the operation that will appear in debug logs.
- Method Detail
  - setFromFlags
```
public void setFromFlags(java.util.Map<?,?> flags)
```
    Deprecated.
  - create
```
public static Repeater create()
```
    Deprecated.
  - create
```
public static Repeater create(java.util.Map<?,?> flags)
```
    Deprecated.
  - create
```
public static Repeater create(java.lang.String description)
```
    Deprecated.
  - create
```
public static Repeater create(java.util.Map<?,?> flags,
              java.lang.String description)
```
    Deprecated.
  - repeat
```
public Repeater repeat()
```
    Deprecated.
    
    Sets the main body of the loop to be a no-op.
    
    Returns:
    this to aid coding in a fluent style.
  - repeat
```
public Repeater repeat(java.lang.Runnable body)
```
    Deprecated.
    
    Sets the main body of the loop.
    
    Parameters:
    body - a closure or other Runnable that is executed in the main body of the loop.
    
    Returns:
    this to aid coding in a fluent style.
  - repeat
```
public Repeater repeat(java.util.concurrent.Callable<?> body)
```
    Deprecated.
    
    Sets the main body of the loop.
    
    Parameters:
    body - a closure or other Callable that is executed in the main body of the loop.
    
    Returns:
    this to aid coding in a fluent style.
  - every
```
public Repeater every(long period,
             java.util.concurrent.TimeUnit unit)
```
    Deprecated.
    
    Set how long to wait between loop iterations.
    
    Parameters:
    period - how long to wait between loop iterations.
    unit - the unit of measurement of the period.
    
    Returns:
    this to aid coding in a fluent style.
  - every
```
public Repeater every(Duration duration)
```
    Deprecated.
    
    See Also:
    every(long, TimeUnit)
  - every
```
public Repeater every(groovy.time.Duration duration)
```
    Deprecated.
  - every
```
public Repeater every(long duration)
```
    Deprecated. specify unit
    
    See Also:
    every(long, TimeUnit)
  - until
```
public Repeater until(java.util.concurrent.Callable<java.lang.Boolean> exitCondition)
```
    Deprecated.
    
    Set code fragment that tests if the loop has completed.
    
    Parameters:
    exitCondition - a closure or other Callable that returns a boolean. If this code returns true then the loop will stop executing.
    
    Returns:
    this to aid coding in a fluent style.
  - rethrowException
```
public Repeater rethrowException()
```
    Deprecated.
    
    If the exit condition check throws an exception, it will be recorded and the last exception will be thrown on failure.
    
    Returns:
    this to aid coding in a fluent style.
  - rethrowExceptionImmediately
```
public Repeater rethrowExceptionImmediately()
```
    Deprecated.
    
    If the repeated body or the exit condition check throws an exception, then propagate that exception immediately.
    
    Returns:
    this to aid coding in a fluent style.
  - suppressWarnings
```
public Repeater suppressWarnings()
```
    Deprecated.
  - limitIterationsTo
```
public Repeater limitIterationsTo(int iterationLimit)
```
    Deprecated.
    
    Set the maximum number of iterations. The loop will exit if the condition has not been satisfied after this number of iterations.
    
    Parameters:
    iterationLimit - the maximum number of iterations.
    
    Returns:
    this to aid coding in a fluent style.
  - limitTimeTo
```
public Repeater limitTimeTo(long deadline,
                   java.util.concurrent.TimeUnit unit)
```
    Deprecated.
    
    Set the amount of time to wait for the condition. The repeater will wait at least this long for the condition to be true, and will exit soon after even if the condition is false.
    
    Parameters:
    deadline - the time that the loop should wait.
    unit - the unit of measurement of the period.
    
    Returns:
    this to aid coding in a fluent style.
  - limitTimeTo
```
public Repeater limitTimeTo(Duration duration)
```
    Deprecated.
    
    See Also:
    limitTimeTo(long, TimeUnit)
  - run
```
public boolean run()
```
    Deprecated.
    
    Run the loop.
    
    Returns:
    true if the exit condition was satisfied; false if the loop terminated for any other reason.

Class Repeater

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Repeater

Repeater

Repeater

Repeater

Method Detail

setFromFlags

create

create

create

create

repeat

repeat

repeat

every

every

every

every

until

rethrowException

rethrowExceptionImmediately

suppressWarnings

limitIterationsTo

limitTimeTo

limitTimeTo

run