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

Clarify implementation note in Clock.java to match implementation changes made by JDK-8068730

    Details

    • Subcomponent:
    • Resolved In Build:
      b172
    • Verification:
      Not verified

      Backports

        Description

        In JDK 9, the implementation of Clock has been improved to be better
        than millisecond in most cases. However, the Javadoc of the "Implementation Note" is now wrong. It says:

        "The clock implementation provided here is based on
        System.currentTimeMillis(). That method provides little to no
        guarantee about the accuracy of the clock. Applications requiring a
        more accurate clock must implement this abstract class themselves
        using a different external clock, such as an NTP server."

        This needs to be updated to match the changes to the implementation.
        Suggested replacement text:

        "The clock implementation provided here is based on the same
        underlying clock as System.currentTimeMillis(), but may have a
        precision finer than milliseconds if available. However, little to no
        guarantee is provided about the accuracy of the underlying clock.
        Applications requiring a more accurate clock must implement this
        abstract class themselves using a different external clock, such
         as an NTP server."

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  dfuchs Daniel Fuchs
                  Reporter:
                  dfuchs Daniel Fuchs
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  3 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: