Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8252585

Fix doclint warnings in jdk.net.httpserver

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Approved
    • Icon: P4 P4
    • 16
    • core-libs
    • None
    • source
    • minimal
    • Explicit no-args protected constructor added to two abstract classes that previous had an implicit default no-args public constructor
    • Java API
    • JDK

      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.

            pconcannon Patrick Concannon (Inactive)
            dfuchs Daniel Fuchs
            Daniel Fuchs
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: