RFR: 8235786: Javadoc for com/sun/net/httpserver/HttpExchange.java#setAttribute is unclear [v2]

[Daniel Fuchs]

On Fri, 29 Nov 2024 12:44:16 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

>> Can I please get a review of this doc-only change which proposes to clarify the behaviour of `com.sun.net.httpserver.HttpExchange.setAttribute()` and `com.sun.net.httpserver.HttpExchange.getAttribute()` methods?
>> 
>> As noted in https://bugs.openjdk.org/browse/JDK-8235786, it's not clear from the javadoc of these methods that the attributes that are set or retrieved through the exchange are actually those that belong to the entire `com.sun.net.httpserver.HttpContext` and thus are shared by all exchanges.
>> 
>> The commit in this PR specifies this behaviour to match the current implementation. I'll file a CSR once we settle on the text.
>
> Jaikiran Pai has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Michael's suggestion - shorten the "@return"

Still looks good (and even better) :-)

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

Marked as reviewed by dfuchs (Reviewer).

PR Review: https://git.openjdk.org/jdk/pull/22454#pullrequestreview-2469887407