org.eclipse.microprofile.lra.annotation

Annotation Type NestedLRA

@Inherited
 @Retention(value=RUNTIME)
 @Target(value={TYPE,METHOD})
public @interface NestedLRA

Used on the interface or class. Defines that the container will create a new LRA for each method invocation, regardless of whether or not there is already an LRA associated with the caller. These LRAs will then either be top-level LRAs or nested automatically depending upon the context within which they are created. When a nested LRA is closed its' compensators are completed but retained. At any time prior to the enclosing LRA being closed or cancelled the nested LRA can be told to compensate (even though it may have already been told to complete). Compatability with the {link @LRA} annotation: if the LRA annotation is not present then the NestedLRA annotation is ignored, otherwise the behaviour depends upon the value of the LRA.value() type attribute:

• REQUIRED if there is an LRA present a new LRA is nested under it
• REQUIRES_NEW the @NestedLRA annotation is ignored
• MANDATORY a new LRA is nested under the incoming LRA
• SUPPORTS if there is an LRA present a new LRA is nested under otherwise a new top level LRA is begun
• NOT_SUPPORTED nested does not make sense and operations on this resource that contain a LRA context will immediately return with a 412 Precondition Failed HTTP status code
• NEVER nested does not make sense and requests that carry a LRA context will immediately return with a 412 Precondition Failed HTTP status code