8302344: Compiler Implementation for Unnamed patterns and variables (Preview)

8307444: java.lang.AssertionError when using unnamed patterns
8307482: Compiler should accept var _ in nested patterns in switch case
8307007: Implementation for javax.lang.model for unnamed variables (Preview)
8308312: Compiler should fail when a local variable declaration does not include an Identifier and does not have an initializer
8308309: Compiler should accept mixed masked and unmasked variables in lambda parameters

Co-authored-by: Jan Lahoda <jlahoda@openjdk.org>
Co-authored-by: Aggelos Biboudis <abimpoudis@openjdk.org>
Reviewed-by: vromero, darcy

Author: biboudis

src/java.base/share/classes/jdk/internal/javac/PreviewFeature.java

@@ -70,6 +70,8 @@ public enum Feature {
         FOREIGN,
         @JEP(number=430, title="String Templates", status="First Preview")
         STRING_TEMPLATES,
+        @JEP(number=443, title="Unnamed Patterns and Variables")
+        UNNAMED,
         /**
          * A key for testing.
          */

src/java.compiler/share/classes/javax/lang/model/element/Element.java

@@ -131,9 +131,10 @@ public interface Element extends javax.lang.model.AnnotatedConstruct {
      * {@code java.util.Set<E>} is {@code "Set"}.
      *
      * If this element represents an unnamed {@linkplain
-     * PackageElement#getSimpleName package} or unnamed {@linkplain
-     * ModuleElement#getSimpleName module}, an {@linkplain
-     * Name##empty_name empty name} is returned.
+     * PackageElement#getSimpleName package}, an unnamed {@linkplain
+     * ModuleElement#getSimpleName module} or an unnamed {@linkplain
+     * VariableElement#getSimpleName variable}, an {@linkplain Name##empty_name empty name}
+     * is returned.
      *
      * If it represents a {@linkplain ExecutableElement#getSimpleName
      * constructor}, the name "{@code <init>}" is returned.  If it

src/java.compiler/share/classes/javax/lang/model/element/VariableElement.java

@@ -25,6 +25,8 @@
 
 package javax.lang.model.element;
 
+import jdk.internal.javac.PreviewFeature;
+
 import javax.lang.model.util.Elements;
 import javax.lang.model.type.TypeMirror;
 import javax.lang.model.type.TypeKind;
@@ -81,6 +83,9 @@ public interface VariableElement extends Element {
      * parameters of the same executable.  If the original source
      * names are not available, an implementation may synthesize names
      * subject to the distinctness requirement above.
+     *
+     * <p>For variables, the name of each variable is returned, or an empty name
+     * if the variable is unnamed.
      */
     @Override
     Name getSimpleName();
@@ -93,4 +98,21 @@ public interface VariableElement extends Element {
      */
     @Override
     Element getEnclosingElement();
+
+    /**
+     * {@return {@code true} if this is an unnamed variable and {@code
+     * false} otherwise}
+     *
+     * @implSpec
+     * The default implementation of this method calls {@code
+     * getSimpleName()} and returns {@code true} if the result is
+     * empty and {@code false} otherwise.
+     *
+     * @jls 6.1 Declarations
+     * @jls 14.4 Local Variable Declarations
+     *
+     * @since 21
+     */
+    @PreviewFeature(feature=PreviewFeature.Feature.UNNAMED, reflective = true)
+    default boolean isUnnamed() { return getSimpleName().isEmpty(); }
 }

src/jdk.compiler/share/classes/com/sun/source/tree/AnyPatternTree.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2023, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+package com.sun.source.tree;
+
+import jdk.internal.javac.PreviewFeature;
+
+/**
+ * A tree node for a binding pattern that matches a pattern
+ * with a variable of any name and a type of the match candidate;
+ * an unnamed pattern.
+ *
+ * For example the use of underscore {@code _} below:
+ * <pre>
+ *   if (r instanceof R(_)) {}
+ * </pre>
+ *
+ * @jls 14.30.1 Kinds of Patterns
+ *
+ * @since 21
+ */
+@PreviewFeature(feature=PreviewFeature.Feature.UNNAMED)
+public interface AnyPatternTree extends PatternTree {
+}

src/jdk.compiler/share/classes/com/sun/source/tree/Tree.java

@@ -227,6 +227,14 @@ public enum Kind {
          */
         PARENTHESIZED(ParenthesizedTree.class),
 
+        /**
+         * Used for instances of {@link BindingPatternTree}.
+         *
+         * @since 21
+         */
+        @PreviewFeature(feature=PreviewFeature.Feature.UNNAMED)
+        ANY_PATTERN(AnyPatternTree.class),
+
         /**
          * Used for instances of {@link BindingPatternTree}.
          *

src/jdk.compiler/share/classes/com/sun/source/tree/TreeVisitor.java

@@ -268,6 +268,16 @@ public interface TreeVisitor<R,P> {
     @PreviewFeature(feature=PreviewFeature.Feature.STRING_TEMPLATES, reflective=true)
     R visitStringTemplate(StringTemplateTree node, P p);
 
+    /**
+     * Visits a {@code AnyPatternTree} node.
+     * @param node the node being visited
+     * @param p a parameter value
+     * @return a result value
+     * @since 21
+     */
+    @PreviewFeature(feature=PreviewFeature.Feature.UNNAMED)
+    R visitAnyPattern(AnyPatternTree node, P p);
+
     /**
      * Visits a {@code BindingPatternTree} node.
      * @param node the node being visited

src/jdk.compiler/share/classes/com/sun/source/tree/VariableTree.java

@@ -51,7 +51,8 @@ public interface VariableTree extends StatementTree {
     ModifiersTree getModifiers();
 
     /**
-     * Returns the name of the variable being declared.
+     * Returns the name of the variable being declared or empty name if both the variable
+     * is unnamed and the preview features are enabled (Unnamed Patterns and Variables).
      * @return the name
      */
     Name getName();

src/jdk.compiler/share/classes/com/sun/source/util/SimpleTreeVisitor.java

@@ -641,6 +641,22 @@ public R visitStringTemplate(StringTemplateTree node, P p) {
         return defaultAction(node, p);
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @implSpec This implementation calls {@code defaultAction}.
+     *
+     * @param node {@inheritDoc}
+     * @param p {@inheritDoc}
+     * @return  the result of {@code defaultAction}
+     * @since 21
+     */
+    @Override
+    @PreviewFeature(feature=PreviewFeature.Feature.UNNAMED)
+    public R visitAnyPattern(AnyPatternTree node, P p) {
+        return defaultAction(node, p);
+    }
+
     /**
      * {@inheritDoc}
      *

src/jdk.compiler/share/classes/com/sun/source/util/TreeScanner.java

@@ -760,6 +760,21 @@ public R visitInstanceOf(InstanceOfTree node, P p) {
         return r;
     }
 
+    /**
+     * {@inheritDoc}
+     *
+     * @implSpec This implementation returns {@code null}.
+     *
+     * @param node  {@inheritDoc}
+     * @param p  {@inheritDoc}
+     * @return the result of scanning
+     * @since 21
+     */
+    @Override
+    public R visitAnyPattern(AnyPatternTree node, P p) {
+        return null;
+    }
+
     /**
      * {@inheritDoc}
      *

src/jdk.compiler/share/classes/com/sun/tools/javac/code/Preview.java

@@ -210,7 +210,7 @@ public boolean isEnabled() {
     public boolean isPreview(Feature feature) {
         return switch (feature) {
             case STRING_TEMPLATES -> true;
-
+            case UNNAMED_VARIABLES -> true;
             //Note: this is a backdoor which allows to optionally treat all features as 'preview' (for testing).
             //When real preview features will be added, this method can be implemented to return 'true'
             //for those selected features, and 'false' for all the others.