org.iqual.chaplin
Annotation Type DynaContext

@Target(value=METHOD)
@Retention(value=RUNTIME)
public @interface DynaContext

This annotation associates a method with a context. The context is identified by the id. The id is a class or interface. If impl value is provided the context id is considered as an identifier only and the class value of impl is used for the context instantiation. Otherwise the id class is used. The instantiation can be controlled by the attr property. There can happen the following scenarios:

• attr=ContextAttributes.RequiresNew

  Before the method execution the context is always created and pushed on the top of the stack associated with the current thread. Note: for each context id there is one stack associated with the current thread.

• attr=ContextAttributes.Requires

  Before the method execution it is checked whether there is the appropriate context on the stack. If it is so the context from the top of the stack is used. Otherwise a new context is created and pushed on the top of the stack.

• attr=ContextAttributes.Mandatory

  Before the method execution it is checked whether there is the appropriate context on the stack. If it is so the context is used otherwise the exception is thrown.

• attr=ContextAttributes.This

  Before the method execution the context the this intance is pushed on the stack. It leads to a limitation that only non-static methods can be annotated by the DynaContext annotation with This context attribute as there is no "this" available in in static methods.

Since:

Mar 14, 2009 5:14:16 PM

Author:

Zbynek Slajchrt

Optional Element Summary

ContextAttributes	attr
Class	id
Class	impl
String	init

id

public abstract Class id

Default:

void.class

impl

public abstract Class impl

Default:

java.lang.Object.class

attr

public abstract ContextAttributes attr

Default:

Requires

init

public abstract String init

Default:

""