org.squashtest.tm.service.annotation

Annotation Type PreventConcurrents

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

See PreventConcurrent for base doc.

This annotation allow to lock different types of entities, mixing simple locks and batch locks.

• Each simple lock will be a nested PreventConcurrent in simple lock array simplesLocks().
• Each batch lock will be a nested BatchPreventConcurrent in batch lock array PreventConcurrents#batchsLocks().
• You have to define the {@link PreventConcurrent#paramName()} and {@link BatchPreventConcurrent#paramName()}. The same string should be put inside {@link Id} and {@link Ids} values. We have to do that as workaround to Spring Proxys wich are in fact JDK proxy. This kind of proxy are bound to the interface of the Spring bean, and do not provide the method parameter name's to the aspect processing {@link PreventConcurrents}. So you have to tag the parameter with {@link Id#value()} and {@link Ids#value()} so we can retrieve the good paramater and associate with the corresponding entity class
• It also ensure that no dead lock can occurs if the same entity is present in severals arguments to be locked.

Example of usage : {@link TestCaseLibraryNavigationService#copyNodesToFolder(long, Long[])}

Since:

1.13.0

Author:

Julien Thebault

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
BatchPreventConcurrent[]	batchsLocks
PreventConcurrent[]	simplesLocks

Element Detail

simplesLocks

public abstract PreventConcurrent[] simplesLocks

Default:

{}

batchsLocks

public abstract BatchPreventConcurrent[] batchsLocks

Default:

{}