Polishing
This commit is contained in:
Sam Brannen
@@ -166,10 +166,10 @@ import java.lang.annotation.Target;
|
||||
* }</pre>
|
||||
*
|
||||
* <h3>Spring Annotations Supporting Attribute Aliases</h3>
|
||||
* <p>As of Spring Framework 4.2, several annotations within core Spring
|
||||
* have been updated to use {@code @AliasFor} to configure their internal
|
||||
* attribute aliases. Consult the Javadoc for individual annotations as well
|
||||
* as the reference manual for details.
|
||||
* <p>Many annotations within the Spring Framework and across the Spring
|
||||
* ecosystem rely on {@code @AliasFor} to configure attribute aliases. Consult
|
||||
* the Javadoc for individual annotations as well as reference documentation for
|
||||
* details.
|
||||
*
|
||||
* @author Sam Brannen
|
||||
* @since 4.2
|
||||
|
||||
@@ -237,8 +237,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* the annotation hierarchy <em>above</em> the supplied {@code element} and
|
||||
* merge that annotation's attributes with <em>matching</em> attributes from
|
||||
* annotations in lower levels of the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both
|
||||
* within a single annotation and within the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method delegates to {@link #getMergedAnnotationAttributes(AnnotatedElement, String)}.
|
||||
* @param element the annotated element
|
||||
* @param annotationType the annotation type to find
|
||||
@@ -262,8 +262,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* the annotation hierarchy <em>above</em> the supplied {@code element} and
|
||||
* merge that annotation's attributes with <em>matching</em> attributes from
|
||||
* annotations in lower levels of the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both
|
||||
* within a single annotation and within the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method delegates to {@link #getMergedAnnotationAttributes(AnnotatedElement, String, boolean, boolean)},
|
||||
* supplying {@code false} for {@code classValuesAsString} and {@code nestedAnnotationsAsMap}.
|
||||
* @param element the annotated element
|
||||
@@ -321,8 +321,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* merge that annotation's attributes with <em>matching</em> attributes from
|
||||
* annotations in lower levels of the annotation hierarchy, and synthesize
|
||||
* the result back into an annotation of the specified {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both
|
||||
* within a single annotation and within the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* @param element the annotated element
|
||||
* @param annotationType the annotation type to find
|
||||
* @return the merged, synthesized {@code Annotation}, or {@code null} if not found
|
||||
@@ -348,8 +348,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the annotation
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>get semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -375,8 +375,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the
|
||||
* annotation hierarchy and synthesize the results back into an annotation
|
||||
* of the corresponding {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>get semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -402,9 +402,9 @@ public abstract class AnnotatedElementUtils {
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>The container type that holds the repeatable annotations will be looked up
|
||||
* via {@link java.lang.annotation.Repeatable}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* via {@link java.lang.annotation.Repeatable @Repeatable}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>get semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -431,8 +431,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the annotation
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>get semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* <p><strong>WARNING</strong>: if the supplied {@code containerType} is not
|
||||
@@ -621,8 +621,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* merge that annotation's attributes with <em>matching</em> attributes from
|
||||
* annotations in lower levels of the annotation hierarchy, and synthesize
|
||||
* the result back into an annotation of the specified {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both
|
||||
* within a single annotation and within the annotation hierarchy.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>find semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element
|
||||
@@ -652,8 +652,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the annotation
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>find semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -677,8 +677,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the
|
||||
* annotation hierarchy and synthesize the results back into an annotation
|
||||
* of the corresponding {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>find semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -703,9 +703,9 @@ public abstract class AnnotatedElementUtils {
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>The container type that holds the repeatable annotations will be looked up
|
||||
* via {@link java.lang.annotation.Repeatable}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* via {@link java.lang.annotation.Repeatable @Repeatable}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>find semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* @param element the annotated element (never {@code null})
|
||||
@@ -732,8 +732,8 @@ public abstract class AnnotatedElementUtils {
|
||||
* <em>matching</em> attributes from annotations in lower levels of the annotation
|
||||
* hierarchy and synthesize the results back into an annotation of the specified
|
||||
* {@code annotationType}.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within a
|
||||
* single annotation and within annotation hierarchies.
|
||||
* <p>{@link AliasFor @AliasFor} semantics are fully supported, both within
|
||||
* a single annotation and within the annotation hierarchy.
|
||||
* <p>This method follows <em>find semantics</em> as described in the
|
||||
* {@linkplain AnnotatedElementUtils class-level javadoc}.
|
||||
* <p><strong>WARNING</strong>: if the supplied {@code containerType} is not
|
||||
|
||||
@@ -36,7 +36,7 @@ import org.springframework.util.Assert;
|
||||
* "merged" from different source values, typically:
|
||||
*
|
||||
* <ul>
|
||||
* <li>Explicit and Implicit {@link AliasFor @AliasFor} declarations on one or
|
||||
* <li>Explicit and implicit {@link AliasFor @AliasFor} declarations on one or
|
||||
* more attributes within the annotation</li>
|
||||
* <li>Explicit {@code @AliasFor} declarations for a meta-annotation</li>
|
||||
* <li>Convention based attribute aliases for a meta-annotation</li>
|
||||
|
||||
Reference in New Issue
Block a user