RFR: JEP 359-Records: reflection code

Vicente Romero vicente.romero at oracle.com
Sun Oct 27 23:41:22 UTC 2019


Hi Brian,

Thanks for your comments. I have published another review iteration [1]. 
Some comments inlined below.

On 10/25/19 5:04 PM, Brian Goetz wrote:
> Spec in Class.java:
>
>  - Various {@code RecordComponent} should be {@link RecordComponent}.

we could do that but the current approach is consistent with what we are 
doing in similar APIs like Class::getDeclaredFields()

>  - Rather than say "if this class was declared as a record in the 
> source code", instead say "is a record class", since record classes 
> are a term defined by the JLS.
fixed
>  - For isRecord/getRecordComponents, should include "@jls 8.10" link
done
>
> RecordComponent.java:
>
>  - Add @jls 8.10 link
>  - "Returns the name of the component represented by this record 
> component." -> "Returns the name of this record component." and 
> similar in other methods.  Since RC models a record component, its 
> clear enough what is meant.

done, the javadoc was following the same approach as in 
java.lang.reflect.Field

>  - For getGenericSignature, there should be a link back to @jls or 
> @jvms that describes the format of the signature string.
done, added @jvms 4.7.9.1 Signatures

>  - Doesn't getAnnotation() need some spec, or an {@inheritDoc}?

yep done

Thanks,
Vicente

[1] http://cr.openjdk.java.net/~vromero/records.review/reflection/webrev.01/


More information about the amber-dev mailing list