DATAJPA-871 - Allow usage of composed annotations using @AliasFor.

We allow and support composing annotations for: @entity, @entitygraph, @lock, @Modifying, @query, @QueryHints as well as @procedure.

Original pull request: #166.

Author: christophstrobl

src/main/java/org/springframework/data/jpa/repository/EntityGraph.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2014-2015 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -30,6 +30,7 @@
  * 
  * Since 1.9 we support the definition of dynamic {@link EntityGraph}s by allowing to customize the fetch-graph via 
  * via {@link #attributePaths()} ad-hoc fetch-graph configuration.
+ * @author Christoph Strobl
  * 
  * If {@link #attributePaths()} are specified then we ignore the entity-graph name {@link #value()}
  * and treat this {@link EntityGraph} as dynamic.
@@ -38,7 +39,7 @@
  * @since 1.6
  */
 @Retention(RetentionPolicy.RUNTIME)
-@Target(ElementType.METHOD)
+@Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })
 @Documented
 public @interface EntityGraph {
 

src/main/java/org/springframework/data/jpa/repository/Modifying.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2008-2015 the original author or authors.
+ * Copyright 2008-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,9 +25,10 @@
  * Indicates a method should be regarded as modifying query.
  * 
  * @author Oliver Gierke
+ * @author Christoph Strobl
  */
 @Retention(RetentionPolicy.RUNTIME)
-@Target(ElementType.METHOD)
+@Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })
 @Documented
 public @interface Modifying {
 

src/main/java/org/springframework/data/jpa/repository/Query.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2008-2014 the original author or authors.
+ * Copyright 2008-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -28,9 +28,10 @@
  * 
  * @author Oliver Gierke
  * @author Thomas Darimont
+ * @author Christoph Strobl
  */
 @Retention(RetentionPolicy.RUNTIME)
-@Target(ElementType.METHOD)
+@Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })
 @QueryAnnotation
 @Documented
 public @interface Query {

src/main/java/org/springframework/data/jpa/repository/query/DefaultJpaEntityMetadata.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013-2014 the original author or authors.
+ * Copyright 2013-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -17,13 +17,15 @@
 
 import javax.persistence.Entity;
 
+import org.springframework.core.annotation.AnnotatedElementUtils;
 import org.springframework.util.Assert;
 import org.springframework.util.StringUtils;
 
 /**
  * Default implementation for {@link JpaEntityMetadata}.
  * 
  * @author Oliver Gierke
+ * @author Christoph Strobl
  */
 public class DefaultJpaEntityMetadata<T> implements JpaEntityMetadata<T> {
 
@@ -55,7 +57,7 @@ public Class<T> getJavaType() {
 	 */
 	public String getEntityName() {
 
-		Entity entity = domainType.getAnnotation(Entity.class);
+		Entity entity = AnnotatedElementUtils.findMergedAnnotation(domainType, Entity.class);
 		boolean hasName = null != entity && StringUtils.hasText(entity.name());
 
 		return hasName ? entity.name() : domainType.getSimpleName();

src/main/java/org/springframework/data/jpa/repository/query/JpaQueryMethod.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2008-2015 the original author or authors.
+ * Copyright 2008-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,8 +15,7 @@
  */
 package org.springframework.data.jpa.repository.query;
 
-import static org.springframework.core.annotation.AnnotationUtils.*;
-
+import java.lang.annotation.Annotation;
 import java.lang.reflect.Method;
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -28,6 +27,7 @@
 import javax.persistence.LockModeType;
 import javax.persistence.QueryHint;
 
+import org.springframework.core.annotation.AnnotatedElementUtils;
 import org.springframework.core.annotation.AnnotationUtils;
 import org.springframework.data.jpa.provider.QueryExtractor;
 import org.springframework.data.jpa.repository.EntityGraph;
@@ -48,6 +48,7 @@
  * 
  * @author Oliver Gierke
  * @author Thomas Darimont
+ * @author Christoph Strobl
  */
 public class JpaQueryMethod extends QueryMethod {
 
@@ -135,7 +136,7 @@ public JpaEntityMetadata<?> getEntityInformation() {
 	@Override
 	public boolean isModifyingQuery() {
 
-		return null != method.getAnnotation(Modifying.class);
+		return null != AnnotationUtils.findAnnotation(method, Modifying.class);
 	}
 
 	/**
@@ -147,7 +148,7 @@ List<QueryHint> getHints() {
 
 		List<QueryHint> result = new ArrayList<QueryHint>();
 
-		QueryHints hints = getAnnotation(method, QueryHints.class);
+		QueryHints hints = AnnotatedElementUtils.findMergedAnnotation(method, QueryHints.class);
 		if (hints != null) {
 			result.addAll(Arrays.asList(hints.value()));
 		}
@@ -162,7 +163,7 @@ List<QueryHint> getHints() {
 	 */
 	LockModeType getLockModeType() {
 
-		Lock annotation = findAnnotation(method, Lock.class);
+		Lock annotation = AnnotatedElementUtils.findMergedAnnotation(method, Lock.class);
 		return (LockModeType) AnnotationUtils.getValue(annotation);
 	}
 
@@ -174,7 +175,7 @@ LockModeType getLockModeType() {
 	 */
 	JpaEntityGraph getEntityGraph() {
 
-		EntityGraph annotation = findAnnotation(method, EntityGraph.class);
+		EntityGraph annotation = AnnotatedElementUtils.findMergedAnnotation(method, EntityGraph.class);
 		return annotation == null ? null : new JpaEntityGraph(annotation, getNamedQueryName());
 	}
 
@@ -186,7 +187,7 @@ JpaEntityGraph getEntityGraph() {
 	 */
 	boolean applyHintsToCountQuery() {
 
-		QueryHints hints = getAnnotation(method, QueryHints.class);
+		QueryHints hints = AnnotatedElementUtils.findMergedAnnotation(method, QueryHints.class);
 		return hints != null ? hints.forCounting() : false;
 	}
 
@@ -284,8 +285,7 @@ String getNamedCountQueryName() {
 	 * @return
 	 */
 	boolean getClearAutomatically() {
-
-		return (Boolean) AnnotationUtils.getValue(method.getAnnotation(Modifying.class), "clearAutomatically");
+		return getMergedOrDefaultAnnotationValue("clearAutomatically", Modifying.class, Boolean.class);
 	}
 
 	/**
@@ -298,12 +298,18 @@ boolean getClearAutomatically() {
 	 * @return
 	 */
 	private <T> T getAnnotationValue(String attribute, Class<T> type) {
+		return getMergedOrDefaultAnnotationValue(attribute, Query.class, type);
+	}
 
-		Query annotation = method.getAnnotation(Query.class);
-		Object value = annotation == null ? AnnotationUtils.getDefaultValue(Query.class, attribute)
-				: AnnotationUtils.getValue(annotation, attribute);
+	@SuppressWarnings({ "rawtypes", "unchecked" })
+	private <T> T getMergedOrDefaultAnnotationValue(String attribute, Class annotationType, Class<T> targetType) {
+
+		Annotation annotation = AnnotatedElementUtils.findMergedAnnotation(method, annotationType);
+		if (annotation == null) {
+			return targetType.cast(AnnotationUtils.getDefaultValue(annotationType, attribute));
+		}
 
-		return type.cast(value);
+		return targetType.cast(AnnotationUtils.getValue(annotation, attribute));
 	}
 
 	/* 
@@ -339,7 +345,7 @@ public boolean isCollectionQuery() {
 	 * @return
 	 */
 	public boolean isProcedureQuery() {
-		return method.getAnnotation(Procedure.class) != null;
+		return AnnotationUtils.findAnnotation(method, Procedure.class) != null;
 	}
 
 	/**

src/main/java/org/springframework/data/jpa/repository/query/Procedure.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2014 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,9 +25,10 @@
  * 
  * @author Thomas Darimont
  * @author Oliver Gierke
+ * @author Christoph Strobl
  * @since 1.6
  */
-@Target(ElementType.METHOD)
+@Target({ ElementType.METHOD, ElementType.ANNOTATION_TYPE })
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Procedure {
 

src/main/java/org/springframework/data/jpa/repository/query/StoredProcedureAttributeSource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2014-2015 the original author or authors.
+ * Copyright 2014-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -24,6 +24,7 @@
 import javax.persistence.NamedStoredProcedureQuery;
 import javax.persistence.StoredProcedureParameter;
 
+import org.springframework.core.annotation.AnnotatedElementUtils;
 import org.springframework.util.Assert;
 import org.springframework.util.StringUtils;
 
@@ -32,6 +33,7 @@
  * 
  * @author Thomas Darimont
  * @author Oliver Gierke
+ * @author Christoph Strobl
  * @since 1.6
  */
 enum StoredProcedureAttributeSource {
@@ -50,7 +52,7 @@ public StoredProcedureAttributes createFrom(Method method, JpaEntityMetadata<?>
 		Assert.notNull(method, "Method must not be null!");
 		Assert.notNull(entityMetadata, "EntityMetadata must not be null!");
 
-		Procedure procedure = method.getAnnotation(Procedure.class);
+		Procedure procedure = AnnotatedElementUtils.findMergedAnnotation(method, Procedure.class);
 		Assert.notNull(procedure, "Method must have an @Procedure annotation!");
 
 		NamedStoredProcedureQuery namedStoredProc = tryFindAnnotatedNamedStoredProcedureQuery(method, entityMetadata,
@@ -201,12 +203,14 @@ private List<NamedStoredProcedureQuery> collectNamedStoredProcedureQueriesFrom(C
 
 		List<NamedStoredProcedureQuery> queries = new ArrayList<NamedStoredProcedureQuery>();
 
-		NamedStoredProcedureQueries namedQueriesAnnotation = entityType.getAnnotation(NamedStoredProcedureQueries.class);
+		NamedStoredProcedureQueries namedQueriesAnnotation = AnnotatedElementUtils.findMergedAnnotation(entityType,
+				NamedStoredProcedureQueries.class);
 		if (namedQueriesAnnotation != null) {
 			queries.addAll(Arrays.asList(namedQueriesAnnotation.value()));
 		}
 
-		NamedStoredProcedureQuery namedQueryAnnotation = entityType.getAnnotation(NamedStoredProcedureQuery.class);
+		NamedStoredProcedureQuery namedQueryAnnotation = AnnotatedElementUtils.findMergedAnnotation(entityType,
+				NamedStoredProcedureQuery.class);
 		if (namedQueryAnnotation != null) {
 			queries.add(namedQueryAnnotation);
 		}

src/main/java/org/springframework/data/jpa/repository/support/CrudMethodMetadataPostProcessor.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2011-2015 the original author or authors.
+ * Copyright 2011-2016 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -31,6 +31,7 @@
 import org.springframework.aop.framework.ProxyFactory;
 import org.springframework.aop.interceptor.ExposeInvocationInterceptor;
 import org.springframework.beans.factory.BeanClassLoaderAware;
+import org.springframework.core.annotation.AnnotatedElementUtils;
 import org.springframework.core.annotation.AnnotationUtils;
 import org.springframework.data.jpa.repository.EntityGraph;
 import org.springframework.data.jpa.repository.Lock;
@@ -48,6 +49,7 @@
  * 
  * @author Oliver Gierke
  * @author Thomas Darimont
+ * @author Christoph Strobl
  */
 class CrudMethodMetadataPostProcessor implements RepositoryProxyPostProcessor, BeanClassLoaderAware {
 
@@ -164,19 +166,19 @@ public DefaultCrudMethodMetadata(Method method) {
 		}
 
 		private static EntityGraph findEntityGraph(Method method) {
-			return AnnotationUtils.findAnnotation(method, EntityGraph.class);
+			return AnnotatedElementUtils.findMergedAnnotation(method, EntityGraph.class);
 		}
 
 		private static LockModeType findLockModeType(Method method) {
 
-			Lock annotation = AnnotationUtils.findAnnotation(method, Lock.class);
+			Lock annotation = AnnotatedElementUtils.findMergedAnnotation(method, Lock.class);
 			return annotation == null ? null : (LockModeType) AnnotationUtils.getValue(annotation);
 		}
 
 		private static Map<String, Object> findQueryHints(Method method) {
 
 			Map<String, Object> queryHints = new HashMap<String, Object>();
-			QueryHints queryHintsAnnotation = AnnotationUtils.findAnnotation(method, QueryHints.class);
+			QueryHints queryHintsAnnotation = AnnotatedElementUtils.findMergedAnnotation(method, QueryHints.class);
 
 			if (queryHintsAnnotation != null) {