org.squashtest.tm.service.annotation

Annotation Type PreventConcurrent

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

Methods with this annotation should not be run concurrently when they access the same entity.

The method arg which conveys the entity's id has to be annotated with @Id

This annotation is processed at runtime using Spring AOP so it can only be used on spring beans. It means it should be put on the concrete class and @Id should be put on the interface (yeah, that sucks) => best thing is to put it on both the interface and the concrete class. For generic method, as the type of the entity is required, we have to override the generic method, and call the generic method with super.methodName...

Since:

1.11.6

Author:

Gregory Fouquet

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
Class<?>	entityType Type of the entity which should be locked

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<? extends IdCoercer>	coercer Class of a coercer if needed.
String	paramName The name of the id parameter, used only if method needs severals locks.

Element Detail

entityType

public abstract Class<?> entityType

Type of the entity which should be locked

paramName

public abstract String paramName

The name of the id parameter, used only if method needs severals locks. We have to put the name here, as Spring proxy are JDK proxy if the bean implement an interface. So inside the aspect, we cannot retrieve the name of the parameters of the method. The SAME name value should be put inside the Id to allow the link.

Returns:

Default:

""

coercer

public abstract Class<? extends IdCoercer> coercer

Class of a coercer if needed. Default is a direct transmission of the argument to PreventConcurrentAspect

Default:

org.squashtest.tm.service.annotation.PassThroughIdCoercer.class