org.apache.polygene.api.unitofwork.concern

Annotation Type UnitOfWorkRetry

@Retention(value=RUNTIME)
 @Target(value=METHOD)
 @Inherited
 @Documented
public @interface UnitOfWorkRetry

This annotation describes the retries that should occur in case of ConcurrentEntityModificationException occurs.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
long	delayFactor Number of milliseconds to be added for each additional retry, beyond the second one.
long	initialDelay Number of milliseconds to wait before executing the second UnitOfOfWork.
int	retries Number of times that the UnitOfWork should be tried in total.

Element Detail

retries

public abstract int retries

Number of times that the UnitOfWork should be tried in total. The default value is 1, which means that the UnitOfWork will execute only one time. It is also the minimum value allowed.

Returns:

Number of times that the UnitOfWork will be executed. Must be 1 or higher. If a value of 0 or lower is given, the UnitOfWork is still executed one time.

Default:

1

initialDelay

public abstract long initialDelay

Number of milliseconds to wait before executing the second UnitOfOfWork. The default value is 0, which means that there is no delay and it is tried immediately.

Returns:

Number of milliseconds to wait before executing the second UnitOfOfWork.

Default:

0L

delayFactor

public abstract long delayFactor

Number of milliseconds to be added for each additional retry, beyond the second one. The default value is 10. The delay is defined as;

 Thread.sleep( initialDelay + retry * delayFactor );
 

where retry will be 0 after first UnitOfWork had a ConcurrentEntityModificationException and is 1 after the first retry and so forth.

So, with the retries=4, initialDelay=5, delayFactor=20 the 3 delays between the UnitOfWorks will be 5ms, 25ms, 45ms

Returns:

The number of milliseconds per retry, except the first one, that should be added to the delay between tries.

Default:

10L