RFR: 8345577: Additional clarification to the com.sun.net.httpserver.HttpExchange.getAttribute() and setAttribute() methods after JDK-8235786

[Michael McMahon]

On Thu, 5 Dec 2024 13:27:18 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

> Can I please get a review of this doc-only change which proposes to address https://bugs.openjdk.org/browse/JDK-8345577?
> 
> As noted in that issue, a recent update (in the current JDK mainline) to the javadoc of these methods made some existing external subclasses overridding these methods to contradict the specification of the methods. The update in this current PR relaxes the normative text and clarifies the JDK built-in implementation through a `@implSpec`.
> 
> No new tests have been added given the nature of this change. The CSR is ready for review https://bugs.openjdk.org/browse/JDK-8345582.

We're going to revert the doc change that this PR was going to clarify (in another PR) in 24. So this PR will be closed and we will take another approach towards the original issue in 25.

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

PR Comment: https://git.openjdk.org/jdk/pull/22577#issuecomment-2527708612