RFR: 8349206: j.u.l.Handler classes create deadlock risk via synchronized publish() method [v5]

[Roger Riggs]

On Mon, 24 Feb 2025 19:10:29 GMT, Chen Liang <liach at openjdk.org> wrote:

>> @RogerRiggs - Is overriding a method and calling `super` considered a use of the API? Because these notes are only useful for people implemeting custom subclasses of Handler...
>
> Yep, I think overriding methods are considered usages of API. Implementation applies to the exact method implementation.

There are elements of both implNote and ApiNote, maybe there is clarity in separating the descriptions into two notes. ImplNote says what it does and ApiNote says how to subclass. If both cases, the language of the prose is written to describe in one case and to recommend in the other. My observation was on the mixing of the two. I'm aware the version as written covering difficult to describe behaviors.

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23491#discussion_r1968295565