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

doc updates for java.lang.Object

    Details

    • Type: Bug
    • Status: Closed
    • Priority: P4
    • Resolution: Fixed
    • Affects Version/s: 8u31
    • Fix Version/s: 9
    • Component/s: core-libs
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      b49
    • CPU:
      x86
    • OS:
      solaris_11

      Backports

        Description

        A DESCRIPTION OF THE PROBLEM :
        The documentation includes the sentence

        (This is typically implemented by converting the internal address of
        the object into an integer, but this implementation technique is not
        required by the Java™ programming language.)

        I don't think any of our Java implementations has returned the internal address of an object since we started having exact garbage collectors that moved objects. (JDK-1.2?) The address of an object may change if the collector moves the object; and if the collector moves the object, some other object may appear at the original address when it comes time to assign that object a System.identityHashCode().

        I am pretty sure that the way System.identityHashCode() is implemented is by calling Object.hashCode(), (rather than any override?) if that has not been done before, and storing the result in some number of bits in the header of the object. I don't know if we want to document that behavior either.

        EXPECTED VERSUS ACTUAL BEHAVIOR :
        EXPECTED -
        -- Nothing --
        ACTUAL -
        (This is typically implemented by converting the internal address of
        the object into an integer, but this implementation technique is not
        required by the Javaâ„¢ programming language.)

        URL OF FAULTY DOCUMENTATION :
        http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--

          Attachments

            Issue Links

              Activity

                People

                • Assignee:
                  darcy Joe Darcy
                  Reporter:
                  webbuggrp Webbug Group
                • Votes:
                  0 Vote for this issue
                  Watchers:
                  4 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved: