PLUGINAPI-38 Add filenamePatterns on the Language extension point

Author: henryju

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 9.16
+
+* Extension point `org.sonar.api.resources.Language` now supports `filenamePatterns` to detect files' language based on more complex filename patterns than only filename extensions.
+
 ## 9.15
 
 * `org.sonar.api.utils.log.Loggers` and `org.sonar.api.utils.log.Logger` are now deprecated in favor of the direct use of [SLF4J](https://www.slf4j.org/):

plugin-api/src/main/java/org/sonar/api/resources/Language.java

@@ -48,8 +48,12 @@ public interface Language {
   String getName();
 
   /**
-   * For example ["jav", "java"].
-   * If empty, then all files in source directories are considered as sources.
+   * Filename extensions, without the dot. For example <code>["jav", "java"]</code>. Source files having any of those extensions will
+   * be associated to this language. This is equivalent to have {@link #filenamePatterns()}
+   * returning <code>["&#42;&#42;/&#42;.jav", "&#42;&#42;/&#42;.java"]</code>.<br/>
+   * The filename extension matching is case-insensitive, so declaring <code>["java"]</code> will match "src/main/java/Foo.java" and
+   * "src/main/java/Foo.JAVA".<br/>
+   * If both {@link #getFileSuffixes()} and {@link #filenamePatterns()} are provided, both will be considered.
    */
   String[] getFileSuffixes();
 
@@ -60,4 +64,17 @@ public interface Language {
   default boolean publishAllFiles() {
     return true;
   }
+
+  /**
+   * Provide a list of patterns following the {@link org.sonar.api.utils.WildcardPattern} syntax. Source files matching any of those patterns will
+   * be associated to this language.
+   * Pattern are considered relative: <code>["pom.xml"]</code> is equivalent to <code>["&#42;&#42;/pom.xml"]</code> <br/>
+   * The filename extension matching is case-insensitive, so declaring <code>["&#42;&#42;/&#42;Test.java"]</code> will match "FooTest.java" and
+   * "FooTest.JAVA" but <strong>not</strong> "FooTEST.java".<br/>
+   * If both {@link #getFileSuffixes()} and {@link #filenamePatterns()} are provided, both will be considered.
+   * @since 9.16
+   */
+  default String[] filenamePatterns() {
+    return new String[0];
+  }
 }

plugin-api/src/main/java/org/sonar/api/utils/WildcardPattern.java

@@ -53,10 +53,7 @@
  * e.g. <code>org/Foo.java</code> or <code>org/foo/Bar.java</code> or <code>org/foo/bar/Baz.java</code></li>
  * </ul>
  * <p>
- * Another implementation, which is also based on Java Regular Expressions, can be found in
- * <a href="https://github.com/JetBrains/intellij-community/blob/idea/107.743/platform/util/src/com/intellij/openapi/util/io/FileUtil.java#L847">FileUtil</a>
- * from IntelliJ OpenAPI.
- * 
+ *
  * @since 1.10
  */
 @ThreadSafe