RFR: 8347348: Clarify that the HTTP server in jdk.httpserver module is not a full featured server

[Ethan McCue]

On Fri, 10 Jan 2025 14:26:22 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

> Like you note, there are existing external implementations based on this SPI/API which provide a full feature server. This proposed text isn't meant to imply that existing API/SPI contract will be broken (in fact, nothing is being deprecated).

The proposed text *does* imply that existing external implementations must be "intended for simple usages like local testing, development, and debugging." 

> Ultimately, in its current form the entire jdk.httpserver module, including the API, SPI and the JDK's implementation has a very narrow focus of being a simple and minimal HTTP server that allows usages like development time testing (bringing the up a server instance, issuing a request to the server and expecting some respone) and support for tools like jwebserver. Any enhancements to the API/SPI of this module are very closely tied to such usages of the HTTP server within the JDK or for such JDK tools.

I feel the need to emphasize that this language creates more ambiguity, not less.

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

PR Comment: https://git.openjdk.org/jdk/pull/23004#issuecomment-2582850611