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

Clarify API note in Class::getName and MethodType::toMethodDescriptorString

    XMLWordPrintable

Details

    Backports

      Description

        The API specification for descriptorString not being a strict inverse of Class::forName and MethodType::fromDescriptorString are not entirely correct.

        1. Class::descriptorString was never an inverse of Class::forName, which takes a binary name instead. Class::getName was a partial inverse instead.
        2. MethodType::toMethodDescriptorString ends with a meaningless sentence: "fromMethodDescriptorString, because the latter requires a suitable class loader argument.", and the "Note:" section can be replaced with an `@apiNote`.
        3. Both of these didn't mention hidden classes as a reason that prevents the inversion operation, in addition to distinct classloaders.

        A few user-defined anchor links are replaced with updated javadoc link tag format as well.

        Attachments

          Issue Links

            backported by

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8311210 Clarify API note in Class::getName and MethodType::toMethodDescriptorString

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved

            Backport - A issue that is required to port a Bug or Feature into another product release. This issue type is generally associated with the main Bug/Feature to represent each individual release of the port. JDK-8311374 Clarify API note in Class::getName and MethodType::toMethodDescriptorString

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            csr for

            CSR - null JDK-8309823 Clarify API note in Class::getName and MethodType::toMethodDescriptorString

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Closed
            relates to

            Bug - A problem which impairs or prevents the functions of the product. JDK-8310242 Clarify the name parameter to Class::forName

            • P4 - Minor loss of function, or other problem where easy workaround is present.
            • Resolved
            links to

            Commit Commit openjdk/jdk21/8088bc40

            Commit Commit openjdk/jdk/8c8e9d91

            Review Review openjdk/jdk21/89

            Review Review openjdk/jdk/14411

            Activity

              People

                liach Chen Liang
                liach Chen Liang
                Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved: