jdk/src/share/classes/java/lang/reflect/AnnotatedElement.java
changeset 18546 862067c6481c
parent 16037 1cf21ce98a25
child 18817 0b6120f7f884
equal deleted inserted replaced
18545:5f4e734fad1b 18546:862067c6481c
   128 
   128 
   129    /**
   129    /**
   130      * Returns this element's annotation for the specified type if
   130      * Returns this element's annotation for the specified type if
   131      * such an annotation is present, else null.
   131      * such an annotation is present, else null.
   132      *
   132      *
       
   133      * @param <T> the type of the annotation to query for and return if present
   133      * @param annotationClass the Class object corresponding to the
   134      * @param annotationClass the Class object corresponding to the
   134      *        annotation type
   135      *        annotation type
   135      * @return this element's annotation for the specified annotation type if
   136      * @return this element's annotation for the specified annotation type if
   136      *     present on this element, else null
   137      *     present on this element, else null
   137      * @throws NullPointerException if the given annotation class is null
   138      * @throws NullPointerException if the given annotation class is null
   152      * annotation.
   153      * annotation.
   153      *
   154      *
   154      * The caller of this method is free to modify the returned array; it will
   155      * The caller of this method is free to modify the returned array; it will
   155      * have no effect on the arrays returned to other callers.
   156      * have no effect on the arrays returned to other callers.
   156      *
   157      *
       
   158      * @param <T> the type of the annotation to query for and return if present
   157      * @param annotationClass the Class object corresponding to the
   159      * @param annotationClass the Class object corresponding to the
   158      *        annotation type
   160      *        annotation type
   159      * @return all this element's annotations for the specified annotation type if
   161      * @return all this element's annotations for the specified annotation type if
   160      *     present on this element, else an array of length zero
   162      *     present on this element, else an array of length zero
   161      * @throws NullPointerException if the given annotation class is null
   163      * @throws NullPointerException if the given annotation class is null
   182      * such an annotation is present, else null.
   184      * such an annotation is present, else null.
   183      *
   185      *
   184      * This method ignores inherited annotations. (Returns null if no
   186      * This method ignores inherited annotations. (Returns null if no
   185      * annotations are directly present on this element.)
   187      * annotations are directly present on this element.)
   186      *
   188      *
       
   189      * @param <T> the type of the annotation to query for and return if present
   187      * @param annotationClass the Class object corresponding to the
   190      * @param annotationClass the Class object corresponding to the
   188      *        annotation type
   191      *        annotation type
   189      * @return this element's annotation for the specified annotation type if
   192      * @return this element's annotation for the specified annotation type if
   190      *     present on this element, else null
   193      *     present on this element, else null
   191      * @throws NullPointerException if the given annotation class is null
   194      * @throws NullPointerException if the given annotation class is null
   207      * through" a container annotation.
   210      * through" a container annotation.
   208      *
   211      *
   209      * The caller of this method is free to modify the returned array; it will
   212      * The caller of this method is free to modify the returned array; it will
   210      * have no effect on the arrays returned to other callers.
   213      * have no effect on the arrays returned to other callers.
   211      *
   214      *
       
   215      * @param <T> the type of the annotation to query for and return
       
   216      * if directly present
   212      * @param annotationClass the Class object corresponding to the
   217      * @param annotationClass the Class object corresponding to the
   213      *        annotation type
   218      *        annotation type
   214      * @return all this element's annotations for the specified annotation type if
   219      * @return all this element's annotations for the specified annotation type if
   215      *     present on this element, else an array of length zero
   220      *     present on this element, else an array of length zero
   216      * @throws NullPointerException if the given annotation class is null
   221      * @throws NullPointerException if the given annotation class is null