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

[Josiah Noel]

On Thu, 9 Jan 2025 13:06:55 GMT, Jaikiran Pai <jpai at openjdk.org> wrote:

> Can I please get a review of this doc-only change which clarifies the purpose of the HTTP server that's provided in the JDK's `jdk.httpserver` module? This should help avoid any confusion on the purpose of the server.

To talk more about the change specifically, it seems to imply that all implementations of the API/SPI  should be intended for testing use cases. There are already [multiple fully featured implementations of the API/SPI](https://mail.openjdk.org/pipermail/core-libs-dev/2024-January/118266.html) (Jetty has one for example), so is this really the correct thing to say?

perhaps the wording can be amended to something of the effect of

> The default implementation provided by this module is intended
for simple usages...

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

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