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

javadoc leaking package-private types into serialized-form.html


    • Type: Bug
    • Status: Resolved
    • Priority: P2
    • Resolution: Not an Issue
    • Affects Version/s: 8
    • Fix Version/s: None
    • Component/s: tools
    • Labels:


      In the Oracle/OpenJDK implementation we have the following class hierarchy:
      public class DoubleAccumulator extends package-private class Striped64
      package-private class Striped64 extends public abstract class Number
      public abstract class Number implements Serializable.

      In the documentation
      API javadoc: public class DoubleAccumulator extends Number implements Serializable
      Serialized Form: Class DoubleAccumulator extends Striped64 implements Serializable

      Thus, there are 2 different parents for DoubleAccumulator and 3 other classes. This seems strange:
      1. The only mention of class Striped64 is in Serialized Form. So licenceees' DoubleAccumulator must extend Striped64. But Striped64 is not a part of the public specification!
      2. On the other hand, according to the specifications of the API, licencees implementations must inherit it from Number.

      Where is the truth?

      JCK engineers think that this is not very good idea to make Striped64 package-private. Making it protected may solve the problem.


          Issue Links



              • Assignee:
                jjg Jonathan Gibbons
                alfedoro Alexey Fedorov (Inactive)
              • Votes:
                0 Vote for this issue
                14 Start watching this issue


                • Created: