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

[Josiah Noel]

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

> The API and the SPI provided by the jdk.httpserver module have been designed to provide the basic minimal support to implement an HttpServer that is capable of handling a request response cycle over HTTP. 

This is all it needs to be, the API is currently flexible enough that one can implement all the required features.

> Nor is it a goal of this module at this time to consider adding support to the API/SPI for newer HTTP protocol versions or other protocols.

We're not saying you have to, it is already good enough that one can still implement HTTP/2. The enhancements proposed earlier were mainly to contribute back to the existing _implementation_ of the API, not to modify the API itself.

> The proposed text is meant to make it clear that it was not the goal of this module to provide a HTTP server fit for production deployment to be implemented.

It's one thing to say the current implementation of the API should only be used for testing. That's an understandable position as we can see the team is not keen on enhancement.

But it's another thing entirely to say the API _and its service provider interface_ must be implemented for non-testing use cases.

All I'm saying is we can make things clearer.  We should be unambiguous in saying that the default implementation provided by the module is only intended for testing without discouraging the efforts of existing implementations meant for other uses.

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

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