Upgrade PMD to 7.0.0 (#462)

* Upgrade PMD to 7.0.0

Add support for Java 21.

https://docs.pmd-code.org/pmd-doc-7.0.0/pmd_release_notes.html

Signed-off-by: Holger Friedrich <mail@holger-friedrich.de>
Co-authored-by: Wouter Born <github@maindrain.net>

Author: holgerfriedrich

custom-checks/pmd/src/main/java/org/openhab/tools/analysis/pmd/UseSLF4JLoggerRule.java

@@ -15,13 +15,11 @@
 import java.util.HashSet;
 import java.util.Set;
 
-import net.sourceforge.pmd.lang.ast.Node;
-import net.sourceforge.pmd.lang.java.ast.ASTClassOrInterfaceType;
 import net.sourceforge.pmd.lang.java.ast.ASTImportDeclaration;
-import net.sourceforge.pmd.lang.java.ast.ASTReferenceType;
 import net.sourceforge.pmd.lang.java.ast.ASTType;
 import net.sourceforge.pmd.lang.java.ast.ASTVariableDeclarator;
 import net.sourceforge.pmd.lang.java.rule.AbstractJavaRule;
+import net.sourceforge.pmd.lang.java.symbols.JTypeDeclSymbol;
 
 /**
  * Checks if a logger other than the one provided by slf4j is used
@@ -41,11 +39,16 @@ public UseSLF4JLoggerRule() {
         forbiddenLoggers.add("org.apache.commons.logging.Log");
     }
 
+    @Override
+    public String getMessage() {
+        return "The org.slf4j Logger should be used";
+    }
+
     @Override
     public Object visit(ASTImportDeclaration node, Object data) {
         String fullImportName = node.getImportedName();
         if (forbiddenLoggers.contains(fullImportName)) {
-            addViolation(data, node);
+            asCtx(data).addViolation(node);
         } else if ("org.slf4j.Logger".equals(fullImportName)
                 || ("org.slf4j".equals(fullImportName) && node.isImportOnDemand())) {
             isSlf4jPackageImported = true;
@@ -55,19 +58,13 @@ public Object visit(ASTImportDeclaration node, Object data) {
 
     @Override
     public Object visit(ASTVariableDeclarator node, Object data) {
-        ASTType typeNode = node.getParent().getFirstChildOfType(ASTType.class);
-        if (typeNode != null) {
-            Node reftypeNode = typeNode.getChild(0);
-            if (reftypeNode instanceof ASTReferenceType) {
-                ASTClassOrInterfaceType classOrInterfaceType = reftypeNode
-                        .getFirstChildOfType(ASTClassOrInterfaceType.class);
-                if (classOrInterfaceType != null) {
-                    String className = classOrInterfaceType.getImage();
-
-                    if (isClassNameForbidden(className)) {
-                        addViolation(data, typeNode);
-                    }
-                }
+        ASTType typeNode = node.getParent().firstChild(ASTType.class);
+        if (typeNode != null && typeNode.getTypeMirror().isClassOrInterface()) {
+            JTypeDeclSymbol symbol = typeNode.getTypeMirror().getSymbol();
+            String className = symbol.getPackageName().equals(symbol.getSimpleName()) ? symbol.getSimpleName()
+                    : symbol.getPackageName() + "." + symbol.getSimpleName();
+            if (isClassNameForbidden(className)) {
+                asCtx(data).addViolation(typeNode);
             }
         }
         return super.visit(node, data);
@@ -77,8 +74,8 @@ private boolean isClassNameForbidden(String className) {
         if (forbiddenLoggers.contains(className)) {
             return true;
         }
-        // If the classname is Logger but org.slf4j is not in the imports,
-        // that means the current Logger literal is not a sfl4j.Logger
+        // If the className is Logger but org.slf4j is not in the imports,
+        // that means the current Logger literal is not an org.slf4j.Logger
         return LOGGER_LITERAL.equals(className) && !isSlf4jPackageImported;
     }
 }

custom-checks/pmd/src/test/java/org/openhab/tools/analysis/pmd/test/ClasspathTest.java

@@ -14,7 +14,7 @@
 
 import org.junit.jupiter.api.BeforeEach;
 
-import net.sourceforge.pmd.testframework.SimpleAggregatorTst;
+import net.sourceforge.pmd.test.SimpleAggregatorTst;
 
 /**
  * Test class that includes all custom PMD tests for the .classpath files

custom-checks/pmd/src/test/java/org/openhab/tools/analysis/pmd/test/CustomRulesTest.java

@@ -14,7 +14,7 @@
 
 import org.junit.jupiter.api.BeforeEach;
 
-import net.sourceforge.pmd.testframework.SimpleAggregatorTst;
+import net.sourceforge.pmd.test.SimpleAggregatorTst;
 
 /**
  * Test class that tests all custom PMD rules.

custom-checks/pmd/src/test/java/org/openhab/tools/analysis/pmd/test/PomTest.java

@@ -14,7 +14,7 @@
 
 import org.junit.jupiter.api.BeforeEach;
 
-import net.sourceforge.pmd.testframework.SimpleAggregatorTst;
+import net.sourceforge.pmd.test.SimpleAggregatorTst;
 
 /**
  * Test class that includes all custom PMD tests for the pom.xml files

custom-checks/pmd/src/test/resources/pmd/ruleset/classpath.xml

@@ -6,7 +6,7 @@
 
   <!-- This is an example how to define a Rule with XPath expression -->
   <rule name="AvoidMavenPomderivedInClasspath" message="The classpath file contains maven.pomderived attribute "
-    class="net.sourceforge.pmd.lang.rule.XPathRule" language="xml">
+    class="net.sourceforge.pmd.lang.rule.xpath.XPathRule" language="xml">
     <description>
       Eclipse is adding the attribute "maven.pomderived" automatically to the classpath, when converting a
       project to Maven project, but most of the time it is not required

custom-checks/pmd/src/test/resources/pmd/ruleset/customrules.xml

@@ -1,5 +1,5 @@
 <ruleset name="Classpath Ruleset" xmlns="http://pmd.sourceforge.net/ruleset/2.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.net/ruleset_2_0_0.xsd">
   <description>Rule set that contains custom defined rules regarding the .classpath files</description>
-  <rule class="org.openhab.tools.analysis.pmd.UseSLF4JLoggerRule" name="UseSLF4JLoggerRule"/>
+  <rule class="org.openhab.tools.analysis.pmd.UseSLF4JLoggerRule" name="UseSLF4JLoggerRule" language="java"/>
 </ruleset>

custom-checks/pmd/src/test/resources/pmd/ruleset/pom.xml

@@ -5,7 +5,7 @@
   <description>Rule set that contains custom defined rules regarding the pom.xml files</description>
 
   <rule name="AvoidOverridingParentPomConfiguration" message="Avoid overriding configuration inherited by parent pom"
-    class="net.sourceforge.pmd.lang.rule.XPathRule" language="pom">
+    class="net.sourceforge.pmd.lang.rule.xpath.XPathRule" language="pom">
     <description>
   Avoid overriding configuration inherited by parent pom
   </description>

docs/maven-plugin.md

@@ -87,7 +87,7 @@ Parameters:
 | ------ | ------| -------- |
 | **pmdRuleset** | String | Relative path of the XML configuration to use. If not set the default ruleset file will be used |
 | **pmdFilter** | String | Relative path of a suppression.properties file that lists classes and rules to be excluded from failures. If not set no classes and no rules will be excluded |
-| **maven.pmd.version** | String | The version of the maven-pmd-plugin that will be used (Default value is **3.15.0**)|
+| **maven.pmd.version** | String | The version of the maven-pmd-plugin that will be used (Default value is **3.21.2**)|
 | **pmdPlugins** | List<Dependency> | A list with artifacts that contain additional checks for PMD |
 
 ### sat-plugin:checkstyle

pom.xml

@@ -3,7 +3,6 @@
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 
   <modelVersion>4.0.0</modelVersion>
-
   <groupId>org.openhab.tools.sat</groupId>
   <artifactId>pom</artifactId>
   <version>0.16.0-SNAPSHOT</version>
@@ -67,7 +66,7 @@
     <commons.lang3.version>3.12.0</commons.lang3.version>
     <mockito.version>4.10.0</mockito.version>
     <maven.resources.version>3.3.0</maven.resources.version>
-    <pmd.version>6.53.0</pmd.version>
+    <pmd.version>7.0.0</pmd.version>
     <checkstyle.version>10.14.0</checkstyle.version>
     <spotbugs.version>4.8.3</spotbugs.version>
     <maven.core.version>3.6.0</maven.core.version>
@@ -94,6 +93,11 @@
   </properties>
 
   <dependencies>
+    <dependency>
+      <groupId>net.sourceforge.pmd</groupId>
+      <artifactId>pmd-compat6</artifactId>
+      <version>7.0.0</version>
+    </dependency>
     <dependency>
       <groupId>javax.xml.bind</groupId>
       <artifactId>jaxb-api</artifactId>

sat-plugin/src/main/java/org/openhab/tools/analysis/tools/PmdChecker.java

@@ -60,7 +60,7 @@ public class PmdChecker extends AbstractChecker {
     /**
      * The version of the maven-pmd-plugin that will be used
      */
-    @Parameter(property = "maven.pmd.version", defaultValue = "3.20.0")
+    @Parameter(property = "maven.pmd.version", defaultValue = "3.21.2")
     private String mavenPmdVersion;
 
     /**
@@ -69,7 +69,7 @@ public class PmdChecker extends AbstractChecker {
     @Parameter
     private List<Dependency> pmdPlugins = new ArrayList<>();
 
-    private static final String PMD_VERSION = "6.53.0";
+    private static final String PMD_VERSION = "7.0.0";
     /**
      * Location of the properties files that contains configuration options for the maven-pmd-plugin
      */