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

1.5: Robust handling of code using essential APIs associated with preview features

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Fixed
    • P4
    • 14
    • 13
    • specification

    Description

      Per http://openjdk.java.net/jeps/12#Relationship-to-Java-SE-APIs:

      - The use of an essential API element associated with a preview feature must cause either a compile-time error or a suppressible warning, depending on whether preview features are disabled or enabled respectively. JLS 1.5 must specify the presence of the error/warning, and enumerate which types/methods in Java SE 14 cause it. JLS 9.6.4.5 must record that the warning is suppressible via `@SuppressWarnings("preview")`.

      - The use of a reflective API element associated with a preview feature is worthy of a warning regardless of whether preview features are disabled or enabled -- but technically this is a compiler-specific warning, not a JLS-mandated warning. Reflective APIs, whether in java.*, javax.*, or com.sun.source.*, are outside the JLS's scope.

      Attachments

        Issue Links

          relates to

          Enhancement - null JDK-8229211 9.6.4.10: PreviewFeature

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

          Bug - A problem which impairs or prevents the functions of the product. JDK-8231147 9.6.4.5: Clarify that @SuppressWarnings requires unknown strings to be ignored

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

          Enhancement - null JDK-8249554 1.5: Expand preview features to include preview APIs

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

          CSR - null JDK-8231411 Improve javac messages for using an API associated with a preview feature

          • P3 - Major loss of function.
          • Closed

          JEP - Java Enhancement Proposal JDK-8195734 JEP 12: Preview Features

          • P2 - Crashes, loss of data, severe memory leak.
          • Completed

          Activity

            People

              abuckley Alex Buckley
              abuckley Alex Buckley
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: