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

[JEP 390] Define & apply annotation jdk.internal.ValueBased

    Details

    • Type: Enhancement
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 16
    • Component/s: core-libs
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      master

      Description

      Define a JDK-internal annotation, jdk.internal.ValueBased, which indicates that a class or interface is value-based, per:

      https://docs.oracle.com/javase/8/docs/api/java/lang/doc-files/ValueBased.html

      Apply the annotation wherever existing documentation references ValueBased.html, including:

      - The primitive wrapper classes in java.lang;

      - The class java.lang.Runtime.Version;

      - The "optional" classes in java.util: Optional, OptionalInt, OptionalLong, and OptionalDouble;

      - Many classes in the java.time API: Instant, LocalDate, LocalTime, LocalDateTime, ZonedDateTime, ZoneId, OffsetTime, OffsetDateTime, ZoneOffset, Duration, Period, Year, YearMonth, and MonthDay, and, in java.time.chrono: MinguoDate, HijrahDate, JapaneseDate, and ThaiBuddhistDate;

      - The interface java.lang.ProcessHandle and its implementation classes;

      - The implementation classes of the collection factories in java.util: List.of, List.copyOf, Set.of, Set.copyOf, Map.of, Map.copyOf, Map.ofEntries, and Map.entry;

      - [ Removed from JEP 390] - All subinterfaces and implementation classes—other than java.lang.String—of java.lang.constant.ConstantDesc, including ClassDesc, MethodTypeDesc, MethodHandleDesc, DirectMethodHandleDesc, DynamicCallSiteDesc, and DynamicConstantDesc, and the classes java.lang.Enum.EnumDesc and java.lang.invoke.VarHandle.VarHandleDesc;

      - [ Removed from JEP 390] - The value-based classes in the jdk.incubator.foreign module

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                rriggs Roger Riggs
                Reporter:
                dlsmith Dan Smith
              • Votes:
                0 Vote for this issue
                Watchers:
                9 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: