On Wed, 29 Oct 2025 14:28:41 GMT, Chen Liang <[email protected]> wrote:
>> src/java.base/share/classes/java/lang/reflect/InvocationHandler.java line 59:
>>
>>> 57: * the method invoked on the proxy instance; the declaring
>>> 58: * class of the {@code Method} object may be a proxy interface,
>>> 59: * one of their superinterfaces, or the {@code Object} class
>>
>> Hello Chen, would it be better to word that latter part of the sentence as:
>>
>>> the declaring class of the {@code Method} will either be one of the
>>> interfaces implemented by the proxy instance, or one of their super
>>> interfaces, or the {@code Object} class.
>
> Hi Jai, the term "proxy interface" is defined in java.lang.reflect.Proxy,
> together with "proxy instance":
>
>> A <em>proxy class</em> is a class created at runtime that implements a
>> specified
>> list of interfaces, known as <em>proxy interfaces</em>. A <em>proxy
>> instance</em>
>> is an instance of a proxy class.
>
> So I believe the term "proxy interface" makes sense when you have a "proxy
> instance" in the context.
Thank you for quoting that text - you are right, that term is already
specified, so the changes you have here looks good to me.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/28024#discussion_r2473606063
