提交 699d75ec 编写于 作者: J Juergen Hoeller

Polishing

上级 c152d246
/* /*
* Copyright 2002-2017 the original author or authors. * Copyright 2002-2019 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
...@@ -19,6 +19,7 @@ package org.springframework.beans.annotation; ...@@ -19,6 +19,7 @@ package org.springframework.beans.annotation;
import java.lang.annotation.Annotation; import java.lang.annotation.Annotation;
import java.lang.reflect.Method; import java.lang.reflect.Method;
import java.util.Arrays; import java.util.Arrays;
import java.util.Collections;
import java.util.HashSet; import java.util.HashSet;
import java.util.Set; import java.util.Set;
...@@ -62,7 +63,8 @@ public abstract class AnnotationBeanUtils { ...@@ -62,7 +63,8 @@ public abstract class AnnotationBeanUtils {
public static void copyPropertiesToBean(Annotation ann, Object bean, @Nullable StringValueResolver valueResolver, public static void copyPropertiesToBean(Annotation ann, Object bean, @Nullable StringValueResolver valueResolver,
String... excludedProperties) { String... excludedProperties) {
Set<String> excluded = new HashSet<>(Arrays.asList(excludedProperties)); Set<String> excluded = (excludedProperties.length == 0 ? Collections.emptySet() :
new HashSet<>(Arrays.asList(excludedProperties)));
Method[] annotationProperties = ann.annotationType().getDeclaredMethods(); Method[] annotationProperties = ann.annotationType().getDeclaredMethods();
BeanWrapper bw = PropertyAccessorFactory.forBeanPropertyAccess(bean); BeanWrapper bw = PropertyAccessorFactory.forBeanPropertyAccess(bean);
for (Method annotationProperty : annotationProperties) { for (Method annotationProperty : annotationProperties) {
......
/* /*
* Copyright 2002-2018 the original author or authors. * Copyright 2002-2019 the original author or authors.
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
...@@ -57,14 +57,14 @@ import org.springframework.util.StringUtils; ...@@ -57,14 +57,14 @@ import org.springframework.util.StringUtils;
* <p>Note that most of the features of this class are not provided by the * <p>Note that most of the features of this class are not provided by the
* JDK's introspection facilities themselves. * JDK's introspection facilities themselves.
* *
* <p>As a general rule for runtime-retained annotations (e.g. for transaction * <p>As a general rule for runtime-retained application annotations (e.g. for
* control, authorization, or service exposure), always use the lookup methods * transaction control, authorization, or service exposure), always use the
* on this class (e.g., {@link #findAnnotation(Method, Class)}, * lookup methods on this class (e.g. {@link #findAnnotation(Method, Class)} or
* {@link #getAnnotation(Method, Class)}, and {@link #getAnnotations(Method)}) * {@link #getAnnotation(Method, Class)}) instead of the plain annotation lookup
* instead of the plain annotation lookup methods in the JDK. You can still * methods in the JDK. You can still explicitly choose between a <em>get</em>
* explicitly choose between a <em>get</em> lookup on the given class level only * lookup on the given class level only ({@link #getAnnotation(Method, Class)})
* ({@link #getAnnotation(Method, Class)}) and a <em>find</em> lookup in the entire * and a <em>find</em> lookup in the entire inheritance hierarchy of the given
* inheritance hierarchy of the given method ({@link #findAnnotation(Method, Class)}). * method ({@link #findAnnotation(Method, Class)}).
* *
* <h3>Terminology</h3> * <h3>Terminology</h3>
* The terms <em>directly present</em>, <em>indirectly present</em>, and * The terms <em>directly present</em>, <em>indirectly present</em>, and
...@@ -449,7 +449,13 @@ public abstract class AnnotationUtils { ...@@ -449,7 +449,13 @@ public abstract class AnnotationUtils {
* @since 4.2 * @since 4.2
*/ */
@Nullable @Nullable
public static <A extends Annotation> A findAnnotation(AnnotatedElement annotatedElement, Class<A> annotationType) { public static <A extends Annotation> A findAnnotation(
AnnotatedElement annotatedElement, @Nullable Class<A> annotationType) {
if (annotationType == null) {
return null;
}
// Do NOT store result in the findAnnotationCache since doing so could break // Do NOT store result in the findAnnotationCache since doing so could break
// findAnnotation(Class, Class) and findAnnotation(Method, Class). // findAnnotation(Class, Class) and findAnnotation(Method, Class).
A ann = findAnnotation(annotatedElement, annotationType, new HashSet<>()); A ann = findAnnotation(annotatedElement, annotationType, new HashSet<>());
...@@ -697,7 +703,7 @@ public abstract class AnnotationUtils { ...@@ -697,7 +703,7 @@ public abstract class AnnotationUtils {
* @return the first matching annotation, or {@code null} if not found * @return the first matching annotation, or {@code null} if not found
*/ */
@Nullable @Nullable
public static <A extends Annotation> A findAnnotation(Class<?> clazz, Class<A> annotationType) { public static <A extends Annotation> A findAnnotation(Class<?> clazz, @Nullable Class<A> annotationType) {
return findAnnotation(clazz, annotationType, true); return findAnnotation(clazz, annotationType, true);
} }
...@@ -793,8 +799,8 @@ public abstract class AnnotationUtils { ...@@ -793,8 +799,8 @@ public abstract class AnnotationUtils {
* @param annotationType the annotation type to look for * @param annotationType the annotation type to look for
* @param clazz the class to check for the annotation on (may be {@code null}) * @param clazz the class to check for the annotation on (may be {@code null})
* @return the first {@link Class} in the inheritance hierarchy that * @return the first {@link Class} in the inheritance hierarchy that
* declares an annotation of the specified {@code annotationType}, or * declares an annotation of the specified {@code annotationType},
* {@code null} if not found * or {@code null} if not found
* @see Class#isAnnotationPresent(Class) * @see Class#isAnnotationPresent(Class)
* @see Class#getDeclaredAnnotations() * @see Class#getDeclaredAnnotations()
* @see #findAnnotationDeclaringClassForTypes(List, Class) * @see #findAnnotationDeclaringClassForTypes(List, Class)
...@@ -825,7 +831,7 @@ public abstract class AnnotationUtils { ...@@ -825,7 +831,7 @@ public abstract class AnnotationUtils {
* one of several candidate {@linkplain Annotation annotations}, so we * one of several candidate {@linkplain Annotation annotations}, so we
* need to handle this explicitly. * need to handle this explicitly.
* @param annotationTypes the annotation types to look for * @param annotationTypes the annotation types to look for
* @param clazz the class to check for the annotations on, or {@code null} * @param clazz the class to check for the annotation on (may be {@code null})
* @return the first {@link Class} in the inheritance hierarchy that * @return the first {@link Class} in the inheritance hierarchy that
* declares an annotation of at least one of the specified * declares an annotation of at least one of the specified
* {@code annotationTypes}, or {@code null} if not found * {@code annotationTypes}, or {@code null} if not found
...@@ -1044,7 +1050,9 @@ public abstract class AnnotationUtils { ...@@ -1044,7 +1050,9 @@ public abstract class AnnotationUtils {
* corresponding attribute values as values (never {@code null}) * corresponding attribute values as values (never {@code null})
* @see #getAnnotationAttributes(Annotation, boolean, boolean) * @see #getAnnotationAttributes(Annotation, boolean, boolean)
*/ */
public static Map<String, Object> getAnnotationAttributes(Annotation annotation, boolean classValuesAsString) { public static Map<String, Object> getAnnotationAttributes(
Annotation annotation, boolean classValuesAsString) {
return getAnnotationAttributes(annotation, classValuesAsString, false); return getAnnotationAttributes(annotation, classValuesAsString, false);
} }
...@@ -1064,8 +1072,8 @@ public abstract class AnnotationUtils { ...@@ -1064,8 +1072,8 @@ public abstract class AnnotationUtils {
* and corresponding attribute values as values (never {@code null}) * and corresponding attribute values as values (never {@code null})
* @since 3.1.1 * @since 3.1.1
*/ */
public static AnnotationAttributes getAnnotationAttributes(Annotation annotation, boolean classValuesAsString, public static AnnotationAttributes getAnnotationAttributes(
boolean nestedAnnotationsAsMap) { Annotation annotation, boolean classValuesAsString, boolean nestedAnnotationsAsMap) {
return getAnnotationAttributes(null, annotation, classValuesAsString, nestedAnnotationsAsMap); return getAnnotationAttributes(null, annotation, classValuesAsString, nestedAnnotationsAsMap);
} }
...@@ -1083,7 +1091,9 @@ public abstract class AnnotationUtils { ...@@ -1083,7 +1091,9 @@ public abstract class AnnotationUtils {
* @since 4.2 * @since 4.2
* @see #getAnnotationAttributes(AnnotatedElement, Annotation, boolean, boolean) * @see #getAnnotationAttributes(AnnotatedElement, Annotation, boolean, boolean)
*/ */
public static AnnotationAttributes getAnnotationAttributes(@Nullable AnnotatedElement annotatedElement, Annotation annotation) { public static AnnotationAttributes getAnnotationAttributes(
@Nullable AnnotatedElement annotatedElement, Annotation annotation) {
return getAnnotationAttributes(annotatedElement, annotation, false, false); return getAnnotationAttributes(annotatedElement, annotation, false, false);
} }
...@@ -1149,8 +1159,8 @@ public abstract class AnnotationUtils { ...@@ -1149,8 +1159,8 @@ public abstract class AnnotationUtils {
* @since 4.2 * @since 4.2
* @see #postProcessAnnotationAttributes * @see #postProcessAnnotationAttributes
*/ */
static AnnotationAttributes retrieveAnnotationAttributes(@Nullable Object annotatedElement, Annotation annotation, static AnnotationAttributes retrieveAnnotationAttributes(@Nullable Object annotatedElement,
boolean classValuesAsString, boolean nestedAnnotationsAsMap) { Annotation annotation, boolean classValuesAsString, boolean nestedAnnotationsAsMap) {
Class<? extends Annotation> annotationType = annotation.annotationType(); Class<? extends Annotation> annotationType = annotation.annotationType();
AnnotationAttributes attributes = new AnnotationAttributes(annotationType); AnnotationAttributes attributes = new AnnotationAttributes(annotationType);
...@@ -1432,8 +1442,8 @@ public abstract class AnnotationUtils { ...@@ -1432,8 +1442,8 @@ public abstract class AnnotationUtils {
} }
catch (InvocationTargetException ex) { catch (InvocationTargetException ex) {
rethrowAnnotationConfigurationException(ex.getTargetException()); rethrowAnnotationConfigurationException(ex.getTargetException());
throw new IllegalStateException( throw new IllegalStateException("Could not obtain value for annotation attribute '" +
"Could not obtain value for annotation attribute '" + attributeName + "' in " + annotation, ex); attributeName + "' in " + annotation, ex);
} }
catch (Throwable ex) { catch (Throwable ex) {
handleIntrospectionFailure(annotation.getClass(), ex); handleIntrospectionFailure(annotation.getClass(), ex);
...@@ -1462,10 +1472,7 @@ public abstract class AnnotationUtils { ...@@ -1462,10 +1472,7 @@ public abstract class AnnotationUtils {
*/ */
@Nullable @Nullable
public static Object getDefaultValue(@Nullable Annotation annotation, @Nullable String attributeName) { public static Object getDefaultValue(@Nullable Annotation annotation, @Nullable String attributeName) {
if (annotation == null) { return (annotation != null ? getDefaultValue(annotation.annotationType(), attributeName) : null);
return null;
}
return getDefaultValue(annotation.annotationType(), attributeName);
} }
/** /**
...@@ -2042,7 +2049,7 @@ public abstract class AnnotationUtils { ...@@ -2042,7 +2049,7 @@ public abstract class AnnotationUtils {
private final Set<A> result = new LinkedHashSet<>(); private final Set<A> result = new LinkedHashSet<>();
AnnotationCollector(Class<A> annotationType,@Nullable Class<? extends Annotation> containerAnnotationType) { AnnotationCollector(Class<A> annotationType, @Nullable Class<? extends Annotation> containerAnnotationType) {
this.annotationType = annotationType; this.annotationType = annotationType;
this.containerAnnotationType = (containerAnnotationType != null ? containerAnnotationType : this.containerAnnotationType = (containerAnnotationType != null ? containerAnnotationType :
resolveContainerAnnotationType(annotationType)); resolveContainerAnnotationType(annotationType));
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册