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

doc updates for java.lang.Object

    XMLWordPrintable

Details

    • Bug
    • Resolution: Fixed
    • P4
    • 9
    • 8u31
    • core-libs
    • b49
    • x86
    • 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

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

                Dates

                  Created:
                  Updated:
                  Resolved: