org.squashtest.tm.service.annotation

Class SpringDaoMetaAnnotationAspect

java.lang.Object

org.squashtest.tm.service.annotation.SpringDaoMetaAnnotationAspect

All Implemented Interfaces:

org.springframework.core.Ordered

public class SpringDaoMetaAnnotationAspect
extends Object
implements org.springframework.core.Ordered

This aspect will handle the following meta annotations :

• EmptyCollectionGuard
• Maybe more to come ?

which are all intended to refine the default behaviour dynamically-generated Spring JPA DAO.

See below for details.

EmptyCollectionGuard

A method of a Spring JPA repository will not fail when passed empty Iterable, if that method has the annotation EmptyCollectionGuard.

When this aspect is triggered, any argument of type/subtype of Iterable will be checked against emptyness.

If the test passes the call will be forwared to the target method. Otherwise it will be aborted and a value semantically meaning "no results" will be returned. The actual result depend on the expected returned type :

• void : returns null
• Collection (or subclass) : returns an empty List/Set, or throw SpringDaoMetaAnnotationAspect.UnsupportedReturnTypeException for other subtypes of Collection
• Object : returns null
• primitive : 0/false etc

History note : part of the code is scrapped from @link ArbitraryQueryHandler (core.dynamicmanagers)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SpringDaoMetaAnnotationAspect.UnsupportedReturnTypeException

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
SpringDaoMetaAnnotationAspect()

Method Summary

Methods

Modifier and Type	Method and Description
void	callEmptyCollectionGuard()
int	getOrder()
Object	guardAgainstEmptyness(org.aspectj.lang.ProceedingJoinPoint pjp)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SpringDaoMetaAnnotationAspect

public SpringDaoMetaAnnotationAspect()

Method Detail

getOrder

public int getOrder()

Specified by:

getOrder in interface org.springframework.core.Ordered

callEmptyCollectionGuard

public void callEmptyCollectionGuard()

guardAgainstEmptyness

public Object guardAgainstEmptyness(org.aspectj.lang.ProceedingJoinPoint pjp)
                             throws Throwable

Throws:

Throwable