Summary

Address the warnings generated by javadoc -Xdoclint due to missing/incomplete API documentation for several classes within jdk.net.httpserver.

Problem

The following classes contain fields and/or methods that have missing or incomplete javadocs:

• com.sun.net.httpserver.Authenticator
• com.sun.net.httpserver.BasicAuthenticator
• com.sun.net.httpserver.Filter
• com.sun.net.httpserver.Headers
• com.sun.net.httpserver.HttpContext
• com.sun.net.httpserver.HttpExchange
• com.sun.net.httpserver.HttpPrincipal
• com.sun.net.httpserver.HttpServer
• com.sun.net.httpserver.HttpsParameters
• com.sun.net.httpserver.spi.HttpServerProvider

While the classes below have implicit default constructors:

• com.sun.net.httpserver.Authenticator
• com.sun.net.httpserver.Authenticator.Result

Solution

Update missing documentation where necessary. Transform implicit default constructors into explicit constructors, changing the visibility to protected when the class is abstract.

Specification

The full API documentation changes can be found in the specdiff: http://cr.openjdk.java.net/~pconcannon/8251496/specdiff/specout.02/overview-summary.html, and also in the zip attached below.