RFR: 4397513: (reflect) InvocationHandler.invoke javadoc slightly misleading for "method" parameter [v3]

[Chen Liang]

On Thu, 23 Oct 2025 23:49:25 GMT, Chen Liang <liach at openjdk.org> wrote:

>> The `method` parameter documentation for `InvocationHandler::invoke` does not indicate that it may be one of the 3 Object methods `hashCode`, `equals`, or `toString`. This doc-only improvement clarifies that, links to the Proxy section about declaring class selection, and updates the "the interface method" occurrences to be "the invoked method" to reflect the method may be from `Object`.
>
> Chen Liang has updated the pull request incrementally with one additional commit since the last revision:
> 
>   grammar

src/java.base/share/classes/java/lang/reflect/Proxy.java line 134:

> 132:  *     to the invocation handler. An invocation handler can invoke a default
> 133:  *     method of a proxy interface by calling {@link
> 134:  *     InvocationHandler#invokeDefault InvocationHandler::invokeDefault}.

These two items might be moved to API notes. Thoughts?

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/27943#discussion_r2457973871