Re: JDK 13 RFR of JDK-8181869: getAnnotatedParameterTypes​() specification should be clarified

[Lance Andersen]

looks ok Joe
> On Jun 6, 2019, at 11:30 PM, Joe Darcy <joe.darcy at oracle.com> wrote:
> 
> Hello,
> 
> Please review the doc clarification below to address
> 
>     JDK-8181869: getAnnotatedParameterTypes​() specification should be clarified
> 
> Each of the three flavors of get-parameter-types methods (getParameterTypes, getGenericParameterTypes, getAnnotatedParameterTypes) gets the same disclaimer.
> 
> Thanks,
> 
> -Joe
> 
> diff -r 0d44bf1ead37 src/java.base/share/classes/java/lang/reflect/Executable.java
> --- a/src/java.base/share/classes/java/lang/reflect/Executable.java Fri Jun 07 04:57:51 2019 +0200
> +++ b/src/java.base/share/classes/java/lang/reflect/Executable.java Thu Jun 06 20:26:34 2019 -0700
> @@ -234,6 +234,9 @@
>       * parameter types, in declaration order, of the executable
>       * represented by this object.  Returns an array of length
>       * 0 if the underlying executable takes no parameters.
> +     * Note that the constructors of some inner classes
> +     * may have an implicitly declared parameter in addition to
> +     * explicitly declared ones.
>       *
>       * @return the parameter types for the executable this object
>       * represents
> @@ -257,6 +260,9 @@
>       * parameter types, in declaration order, of the executable represented by
>       * this object. Returns an array of length 0 if the
>       * underlying executable takes no parameters.
> +     * Note that the constructors of some inner classes
> +     * may have an implicitly declared parameter in addition to
> +     * explicitly declared ones.
>       *
>       * <p>If a formal parameter type is a parameterized type,
>       * the {@code Type} object returned for it must accurately reflect
> @@ -698,7 +704,9 @@
>       * declaration of the method/constructor.
>       *
>       * Returns an array of length 0 if the method/constructor declares no
> -     * parameters.
> +     * parameters. Note that the constructors of some inner classes
> +     * may have an implicitly declared parameter in addition to
> +     * explicitly declared ones.
>       *
>       * @return an array of objects representing the types of the
>       * formal parameters of the method or constructor represented by this
> 
> 

 <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif> <http://oracle.com/us/design/oracle-email-sig-198324.gif>
 <http://oracle.com/us/design/oracle-email-sig-198324.gif>Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com <mailto:Lance.Andersen at oracle.com>