Skip to content

status-matrix.md

Latest commit

 

History

History
212 lines (205 loc) · 52.5 KB

status-matrix.md

File metadata and controls

212 lines (205 loc) · 52.5 KB
Raw

Status Matrix

This matrix gives one place to answer three practical questions:

  • Is the feature final, preview, incubator, runtime, tooling, security, documentation, or notes-only in this repository?
  • Which class should I open?
  • Which test proves or documents the behavior?

Use this when you need to distinguish final, preview, incubator, notes-only, runtime, tooling, documentation, and security topics. Use feature-map.md for class-by-class navigation, jep-index.md for the release-level JEP list, and practical-demos.md for a shorter guide to hands-on demonstrations.

Status vocabulary:

Status values may be combined, such as final, security, executable example, when a feature has both an official maturity status and a repository representation.

  • final: stable feature in the named release
  • preview: available for feedback, may change later
  • incubator: non-final incubating API
  • notes-only: represented as a notes class in this repository; this does not imply the Java feature itself is non-final
  • executable example: represented by runnable example code and focused tests
  • executable native example: represented by runnable example code that calls native platform functionality
  • runtime: JVM, GC, diagnostics, startup, or migration behavior
  • tooling: command-line, launcher, JavaDoc, or development support
  • security: cryptography or security platform feature
  • removal: API or platform capability removed from the JDK
  • documentation: JavaDoc or documentation syntax feature
  • documentation example: represented by source documentation that is verified through JavaDoc generation
Java Feature Status Example or Notes Class Test Class Reference
1 Object-oriented basics foundational, executable example ObjectOrientedBasicsExamples ObjectOrientedBasicsExamplesTest java01 README
1 Interfaces foundational, executable example InterfaceExamples InterfaceExamplesTest java01 README
1 Checked exceptions foundational, executable example ExceptionHandlingBasicsExamples ExceptionHandlingBasicsExamplesTest java01 README
1 Threads and Runnable foundational, executable example ThreadBasicsExamples ThreadBasicsExamplesTest java01 README
1 java.io streams foundational, executable example IoBasicsExamples IoBasicsExamplesTest java01 README
1 Inner classes final, executable example InnerClassExamples InnerClassExamplesTest What's New in JDK 1.1
1 Reflection final, executable example ReflectionExamples ReflectionExamplesTest What's New in JDK 1.1
1 Serialization final, executable example SerializationExamples SerializationExamplesTest Object Serialization FAQ
1 JDBC final, executable example JdbcExamples JdbcExamplesTest What's New in JDK 1.1
1 RMI final, executable example RmiExamples RmiExamplesTest What's New in JDK 1.1
1 JavaBeans final, executable example JavaBeansExamples JavaBeansExamplesTest JavaBeans specification
2 Collections Framework final, executable example CollectionsFrameworkExamples CollectionsFrameworkExamplesTest java02 README
2 Sorting with Comparable and Comparator final, executable example SortingExamples SortingExamplesTest java02 README
2 strictfp final, executable example StrictFloatingPointExamples StrictFloatingPointExamplesTest Java language enhancements history
2 Swing final, tooling, executable example SwingExamples SwingExamplesTest java02 README
2 Java 2D final, executable example Java2DExamples Java2DExamplesTest Java 2 platform documentation
2 Security policy runtime, executable example SecurityPolicyExamples SecurityPolicyExamplesTest java02 README
3 Dynamic proxy final, executable example DynamicProxyExamples DynamicProxyExamplesTest java03 README
3 Timer and TimerTask final, executable example TimerExamples TimerExamplesTest java03 README
3 Shutdown hooks runtime, executable example ShutdownHookExamples ShutdownHookExamplesTest java03 README
3 JNDI final, executable example JndiExamples JndiExamplesTest java03 README
3 Legacy integration explanatory module LegacyIntegrationNotes LegacyIntegrationNotesTest java03 README
4 Assertions final, executable example AssertionExamples AssertionExamplesTest Java language enhancements history
4 Regular expressions final, executable example RegexExamples RegexExamplesTest J2SE 1.4 new features
4 NIO final, executable example NioExamples NioExamplesTest J2SE 1.4 new features
4 Logging API final, executable example LoggingExamples LoggingExamplesTest java04 README
4 Chained exceptions final, executable example ChainedExceptionExamples ChainedExceptionExamplesTest java04 README
4 Preferences API final, explanatory module PreferencesNotes PreferencesNotesTest java04 README
4 XML/JAXP final, executable example JaxpExamples JaxpExamplesTest J2SE 1.4 new features
4 Integrated security APIs security, executable example SecurityIntegrationExamples SecurityIntegrationExamplesTest J2SE 1.4 new features
5 Generics final, executable example GenericsExamples GenericsExamplesTest Oracle J2SE 5.0 new features
5 Enhanced for loop final, executable example EnhancedForLoopExamples EnhancedForLoopExamplesTest Oracle J2SE 5.0 new features
5 Autoboxing and unboxing final, executable example AutoboxingExamples AutoboxingExamplesTest Oracle J2SE 5.0 new features
5 Typesafe enums final, executable example EnumExamples EnumExamplesTest Oracle J2SE 5.0 new features
5 Varargs final, executable example VarargsExamples VarargsExamplesTest Oracle J2SE 5.0 new features
5 Static import final, executable example StaticImportExamples StaticImportExamplesTest Oracle J2SE 5.0 new features
5 Annotations final, executable example AnnotationExamples AnnotationExamplesTest Oracle J2SE 5.0 new features
5 Covariant return types final, executable example CovariantReturnExamples CovariantReturnExamplesTest java05 README
5 Formatted output final, executable example FormattingExamples FormattingExamplesTest Formatter API
5 Concurrency utilities final, executable example ConcurrencyUtilitiesExamples ConcurrencyUtilitiesExamplesTest Oracle J2SE 5.0 new features
6 Navigable collections and deques final, executable example NavigableCollectionExamples NavigableCollectionExamplesTest Oracle Java SE 6 features
6 Scripting support final, executable example ScriptingSupportExamples ScriptingSupportExamplesTest Java SE 6 scripting guide
6 Compiler API final, tooling, executable example CompilerApiExamples CompilerApiExamplesTest JavaCompiler API
6 Console API final, tooling, executable example ConsoleApiExamples ConsoleApiExamplesTest Console API
6 Monitoring and management runtime, tooling, executable example MonitoringManagementExamples MonitoringManagementExamplesTest Java SE 6 monitoring and management
6 Web-service support final, explanatory module WebServiceSupportNotes WebServiceSupportNotesTest Oracle Java SE 6 features
7 Try-with-resources final, executable example TryWithResourcesStatementExamples TryWithResourcesStatementExamplesTest Project Coin / JSR 334
7 Multi-catch and precise rethrow final, executable example ExceptionHandlingExamples ExceptionHandlingExamplesTest Project Coin / JSR 334
7 Diamond operator final, executable example DiamondOperatorExamples DiamondOperatorExamplesTest Project Coin / JSR 334
7 Strings in switch final, executable example StringSwitchExamples StringSwitchExamplesTest Project Coin / JSR 334
7 Binary literals and numeric underscores final, executable example NumericLiteralExamples NumericLiteralExamplesTest Project Coin / JSR 334
7 NIO.2 final, executable example Nio2Examples Nio2ExamplesTest JDK 7 adoption guide
7 Fork/join framework final, executable example ForkJoinExamples ForkJoinExamplesTest Java SE 7 concurrency enhancements
7 invokedynamic final, tooling, executable example InvokeDynamicExamples InvokeDynamicExamplesTest java.lang.invoke package
8 Lambdas final LambdaExamples LambdaExamplesTest JEP 126
8 Streams final StreamExamples StreamExamplesTest JEP 107
8 Optional final OptionalExamples OptionalExamplesTest java08 README
8 Method references final MethodReferenceExamples MethodReferenceExamplesTest JEP 126
8 CompletableFuture final CompletableFutureExamples CompletableFutureExamplesTest java08 README
8 Default methods final DefaultMethodExamples DefaultMethodExamplesTest JEP 126
8 Date/Time API final DateTimeApiExamples DateTimeApiExamplesTest JEP 150
9 Collection factories final CollectionFactoryExamples CollectionFactoryExamplesTest JEP 269
9 Optional enhancements final OptionalEnhancementExamples OptionalEnhancementExamplesTest java09 README
9 Stream enhancements final StreamEnhancementExamples StreamEnhancementExamplesTest java09 README
9 Private interface methods final PrivateInterfaceMethodExamples PrivateInterfaceMethodExamplesTest JEP 213
9 Try-with-resources improvement final TryWithResourcesExamples TryWithResourcesExamplesTest JEP 213
9 Process API final ProcessApiExamples ProcessApiExamplesTest JEP 102
9 StackWalker final StackWalkerExamples StackWalkerExamplesTest JEP 259
9 Module system final, executable example ModuleSystemExamples ModuleSystemExamplesTest JEP 261
10 Local variable type inference final LocalVariableTypeInferenceExamples LocalVariableTypeInferenceExamplesTest JEP 286
10 Unmodifiable collectors final UnmodifiableCollectorsExamples UnmodifiableCollectorsExamplesTest java10 README
10 Optional.orElseThrow() final OptionalOrElseThrowExamples OptionalOrElseThrowExamplesTest java10 README
11 String API additions final StringApiExamples StringApiExamplesTest java11 README
11 Files read/write string final FilesApiExamples FilesApiExamplesTest java11 README
11 HTTP Client final HttpClientExamples HttpClientExamplesTest JEP 321
11 Predicate.not final PredicateNotExamples PredicateNotExamplesTest java11 README
11 Lambda var final LambdaVarExamples LambdaVarExamplesTest JEP 323
11 Optional.isEmpty final OptionalIsEmptyExamples OptionalIsEmptyExamplesTest java11 README
12 Switch expressions preview preview SwitchExpressionPreviewExamples SwitchExpressionPreviewExamplesTest JEP 325
12 Teeing collector final TeeingCollectorExamples TeeingCollectorExamplesTest java12 README
12 String.indent final StringIndentExamples StringIndentExamplesTest java12 README
12 Files.mismatch final FilesMismatchExamples FilesMismatchExamplesTest java12 README
12 Compact number formatting final CompactNumberFormatExamples CompactNumberFormatExamplesTest java12 README
13 Text blocks preview preview TextBlockPreviewExamples TextBlockPreviewExamplesTest JEP 355
13 Switch yield preview preview SwitchYieldPreviewExamples SwitchYieldPreviewExamplesTest JEP 354
13 FileSystems.newFileSystem(Path) final FileSystemsNewFileSystemExamples FileSystemsNewFileSystemExamplesTest java13 README
14 Switch expressions final final SwitchExpressionExamples SwitchExpressionExamplesTest JEP 361
14 Helpful NullPointerExceptions runtime HelpfulNullPointerExceptionExamples HelpfulNullPointerExceptionExamplesTest JEP 358
14 Records preview preview RecordPreviewExamples RecordPreviewExamplesTest JEP 359
14 Pattern matching for instanceof preview preview PatternMatchingInstanceofPreviewExamples PatternMatchingInstanceofPreviewExamplesTest JEP 305
15 Text blocks final final TextBlockExamples TextBlockExamplesTest JEP 378
15 Sealed classes preview preview SealedClassesPreviewExamples SealedClassesPreviewExamplesTest JEP 360
15 Hidden classes final, executable example HiddenClassesExamples HiddenClassesExamplesTest JEP 371
16 Records final final RecordExamples RecordExamplesTest JEP 395
16 Pattern matching for instanceof final final PatternMatchingInstanceofExamples PatternMatchingInstanceofExamplesTest JEP 394
16 Stream.toList() final StreamToListExamples StreamToListExamplesTest java16 README
16 Unix-domain socket channels final, executable example UnixDomainSocketChannelExamples UnixDomainSocketChannelExamplesTest JEP 380
16 Vector API first incubator incubator, documentation java16 README No dedicated test JEP 338
16 Foreign Linker API incubator, documentation java16 README No dedicated test JEP 389
16 Foreign-Memory Access API third incubator incubator, documentation java16 README No dedicated test JEP 393
17 Sealed classes final final SealedClassesExamples SealedClassesExamplesTest JEP 409
17 Pattern matching for switch preview preview PatternMatchingSwitchPreviewExamples PatternMatchingSwitchPreviewExamplesTest JEP 406
17 Random Generator API final RandomGeneratorExamples RandomGeneratorExamplesTest JEP 356
17 HexFormat final HexFormatExamples HexFormatExamplesTest java17 README
17 Strong encapsulation runtime, executable example StrongEncapsulationExamples StrongEncapsulationExamplesTest JEP 403
18 UTF-8 default charset final Utf8DefaultCharsetExamples Utf8DefaultCharsetExamplesTest JEP 400
18 Simple Web Server tooling, executable example SimpleStaticFileServer SimpleStaticFileServerTest JEP 408
18 JavaDoc snippets tooling, documentation example JavaDocSnippetExamples JavaDocSnippetExamplesTest JEP 413
18 Internet-Address Resolution SPI final, executable example InetAddressResolutionExamples InetAddressResolutionExamplesTest JEP 418
19 Virtual threads preview preview VirtualThreadsPreviewExamples VirtualThreadsPreviewExamplesTest JEP 425
19 Record patterns preview preview RecordPatternsPreviewExamples RecordPatternsPreviewExamplesTest JEP 405
19 Pattern matching for switch preview preview PatternMatchingSwitchPreviewExamples PatternMatchingSwitchPreviewExamplesTest JEP 427
19 Structured concurrency incubator incubator, explanatory module StructuredConcurrencyPreviewNotes StructuredConcurrencyPreviewNotesTest JEP 428
19 Foreign Function and Memory API preview, notes-only ForeignFunctionMemoryApiPreviewNotes ForeignFunctionMemoryApiPreviewNotesTest JEP 424
20 Record patterns second preview preview RecordPatternsSecondPreviewExamples RecordPatternsSecondPreviewExamplesTest JEP 432
20 Pattern matching for switch fourth preview preview PatternMatchingSwitchFourthPreviewExamples PatternMatchingSwitchFourthPreviewExamplesTest JEP 433
20 Virtual threads second preview preview, notes-only VirtualThreadsSecondPreviewNotes VirtualThreadsSecondPreviewNotesTest JEP 436
20 Scoped values incubator incubator, explanatory module ScopedValuesIncubatorNotes ScopedValuesIncubatorNotesTest JEP 429
20 Structured concurrency second incubator incubator, explanatory module StructuredConcurrencySecondIncubatorNotes StructuredConcurrencySecondIncubatorNotesTest JEP 437
20 Foreign Function and Memory API second preview preview, notes-only ForeignFunctionMemorySecondPreviewNotes ForeignFunctionMemorySecondPreviewNotesTest JEP 434
20 Vector API fifth incubator incubator, executable example VectorApiFifthIncubatorExamples VectorApiFifthIncubatorExamplesTest JEP 438
21 Virtual threads final final VirtualThreadsExamples VirtualThreadsExamplesTest JEP 444
21 Record patterns final final RecordPatternsExamples RecordPatternsExamplesTest JEP 440
21 Pattern matching for switch final final PatternMatchingSwitchExamples PatternMatchingSwitchExamplesTest JEP 441
21 Sequenced collections final SequencedCollectionsExamples SequencedCollectionsExamplesTest JEP 431
21 Unnamed patterns and variables preview preview UnnamedPatternsVariablesPreviewExamples UnnamedPatternsVariablesPreviewExamplesTest JEP 443
21 Key Encapsulation Mechanism API final, security, executable example KeyEncapsulationExchange KeyEncapsulationExchangeTest JEP 452
21 Scoped values preview preview, explanatory module ScopedValuesPreviewNotes ScopedValuesPreviewNotesTest JEP 446
21 Structured concurrency preview preview, explanatory module StructuredConcurrencyPreviewNotes StructuredConcurrencyPreviewNotesTest JEP 453
22 Unnamed variables and patterns final final, executable example UnnamedVariablesPatternsExamples UnnamedVariablesPatternsExamplesTest JEP 456
22 Statements before super(...) preview preview, explanatory module StatementsBeforeSuperPreviewNotes StatementsBeforeSuperPreviewNotesTest JEP 447
22 Stream Gatherers preview preview, explanatory module StreamGatherersPreviewNotes StreamGatherersPreviewNotesTest JEP 461
22 Foreign Function and Memory API final final, executable native example NativeStringParser, NativeStringLength ForeignFunctionExamplesTest JEP 454
22 Multi-file source launcher final, tooling, executable example LaunchMultiFileSourceProgramsExamples LaunchMultiFileSourceProgramsExamplesTest JEP 458
22 Class-File API preview preview, explanatory module ClassFileApiPreviewNotes ClassFileApiPreviewNotesTest JEP 457
22 Scoped values second preview preview, explanatory module ScopedValuesSecondPreviewNotes ScopedValuesSecondPreviewNotesTest JEP 464
22 Structured concurrency second preview preview, explanatory module StructuredConcurrencySecondPreviewNotes StructuredConcurrencySecondPreviewNotesTest JEP 462
23 Markdown documentation comments tooling, documentation, executable example MarkdownDocumentationCommentsExamples MarkdownDocumentationCommentsExamplesTest JEP 467
23 Primitive patterns preview preview, explanatory module PrimitivePatternsPreviewNotes PrimitivePatternsPreviewNotesTest JEP 455
23 Module import declarations preview preview, explanatory module ModuleImportDeclarationsPreviewNotes ModuleImportDeclarationsPreviewNotesTest JEP 476
23 Flexible constructor bodies second preview preview, explanatory module FlexibleConstructorBodiesSecondPreviewNotes FlexibleConstructorBodiesSecondPreviewNotesTest JEP 482
23 Stream Gatherers second preview preview, explanatory module StreamGatherersSecondPreviewNotes StreamGatherersSecondPreviewNotesTest JEP 473
23 Class-File API second preview preview, explanatory module ClassFileApiSecondPreviewNotes ClassFileApiSecondPreviewNotesTest JEP 466
23 Scoped values third preview preview, explanatory module ScopedValuesThirdPreviewNotes ScopedValuesThirdPreviewNotesTest JEP 481
23 Structured concurrency third preview preview, explanatory module StructuredConcurrencyThirdPreviewNotes StructuredConcurrencyThirdPreviewNotesTest JEP 480
23 Unsafe memory-access deprecation runtime, executable example UnsafeMemoryAccessDeprecationExamples UnsafeMemoryAccessDeprecationExamplesTest JEP 471
23 ZGC generational mode runtime, executable example ZgcGenerationalModeExamples ZgcGenerationalModeExamplesTest JEP 474
24 Stream Gatherers final final, executable example StreamGatherersExamples StreamGatherersExamplesTest JEP 485
24 Class-File API final final, executable example ClassFileInspector ClassFileInspectorTest JEP 484
24 Security Manager disabled runtime, executable example SecurityManagerDisabledExamples SecurityManagerDisabledExamplesTest JEP 486
24 Virtual-thread synchronization runtime, executable example VirtualThreadSynchronizationExamples VirtualThreadSynchronizationExamplesTest JEP 491
24 Quantum-resistant crypto final, security, executable examples ModuleLatticeKemExample, ModuleLatticeDsaExample ModuleLatticeCryptoExamplesTest JEP 496, JEP 497
24 AOT class loading runtime, tooling, executable example AotClassLoadingExamples AotClassLoadingExamplesTest JEP 483
24 KDF preview security, preview, explanatory module KeyDerivationFunctionPreviewNotes KeyDerivationFunctionPreviewNotesTest JEP 478
24 Flexible constructor bodies third preview preview, explanatory module FlexibleConstructorBodiesThirdPreviewNotes FlexibleConstructorBodiesThirdPreviewNotesTest JEP 492
24 Module import declarations second preview preview, explanatory module ModuleImportDeclarationsSecondPreviewNotes ModuleImportDeclarationsSecondPreviewNotesTest JEP 494
24 Primitive patterns second preview preview, explanatory module PrimitivePatternsSecondPreviewNotes PrimitivePatternsSecondPreviewNotesTest JEP 488
24 Scoped values fourth preview preview, explanatory module ScopedValuesFourthPreviewNotes ScopedValuesFourthPreviewNotesTest JEP 487
24 Structured concurrency fourth preview preview, explanatory module StructuredConcurrencyFourthPreviewNotes StructuredConcurrencyFourthPreviewNotesTest JEP 499
25 Scoped values final final, executable example ScopedValuesExamples ScopedValuesExamplesTest JEP 506
25 Flexible constructor bodies final final FlexibleConstructorBodiesExamples FlexibleConstructorBodiesExamplesTest JEP 513
25 Module import declarations final final, tooling, executable example ModuleImportDeclarationsExamples ModuleImportDeclarationsExamplesTest JEP 511
25 Compact source files final final, tooling, executable example CompactSourceFilesExamples CompactSourceFilesExamplesTest JEP 512
25 Key Derivation Function API final final, security, executable example HkdfKeyDerivationExample HkdfKeyDerivationExampleTest JEP 510
25 Primitive patterns third preview preview, executable example PrimitivePatternsThirdPreviewExamples PrimitivePatternsThirdPreviewExamplesTest JEP 507
25 Stable values preview preview, executable example StableValuesPreviewExamples StableValuesPreviewExamplesTest JEP 502
25 PEM encodings preview security, preview, executable example PemEncodingsPreviewExamples PemEncodingsPreviewExamplesTest JEP 470
25 Structured concurrency fifth preview preview, executable example StructuredConcurrencyFifthPreviewExamples StructuredConcurrencyFifthPreviewExamplesTest JEP 505
25 Vector API tenth incubator incubator, executable example VectorApiTenthIncubatorExamples VectorApiTenthIncubatorExamplesTest JEP 508
25 AOT command-line ergonomics runtime, tooling, executable example AotCommandLineErgonomicsExamples AotCommandLineErgonomicsExamplesTest JEP 514
25 JFR enhancements runtime, executable example JfrEnhancementsExamples JfrEnhancementsExamplesTest JEP 509, JEP 518, JEP 520
25 Compact object headers runtime, executable example CompactObjectHeadersExamples CompactObjectHeadersExamplesTest JEP 519
25 Generational Shenandoah runtime, explanatory module GenerationalShenandoahNotes GenerationalShenandoahNotesTest JEP 521
26 Final field restrictions runtime, explanatory module FinalFieldRestrictionsNotes FinalFieldRestrictionsNotesTest JEP 500
26 Applet API removal final, removal, explanatory module AppletApiRemovalNotes AppletApiRemovalNotesTest JEP 504
26 AOT object caching runtime, explanatory module AotObjectCachingNotes AotObjectCachingNotesTest JEP 516
26 HTTP/3 for the HTTP Client API final, notes-only Http3ClientNotes Http3ClientNotesTest JEP 517
26 G1 synchronization reduction runtime, explanatory module G1SynchronizationNotes G1SynchronizationNotesTest JEP 522
26 PEM encodings second preview security, preview, notes-only PemEncodingsSecondPreviewNotes PemEncodingsSecondPreviewNotesTest JEP 524
26 Structured concurrency sixth preview preview, explanatory module StructuredConcurrencySixthPreviewNotes StructuredConcurrencySixthPreviewNotesTest JEP 525
26 Lazy Constants second preview preview, explanatory module LazyConstantsSecondPreviewNotes LazyConstantsSecondPreviewNotesTest JEP 526
26 Vector API eleventh incubator incubator, explanatory module VectorApiEleventhIncubatorNotes VectorApiEleventhIncubatorNotesTest JEP 529
26 Primitive patterns fourth preview preview, notes-only PrimitivePatternsFourthPreviewNotes PrimitivePatternsFourthPreviewNotesTest JEP 530