You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by sl...@apache.org on 2026/10/04 11:30:31 UTC

(maven-enforcer) branch master updated: Name enforcer 4.0.0 as the release that removes the legacy rule API

This is an automated email from the ASF dual-hosted git repository.

slachiewicz pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-enforcer.git


The following commit(s) were added to refs/heads/master by this push:
     new 8dbec6d0 Name enforcer 4.0.0 as the release that removes the legacy rule API
8dbec6d0 is described below

commit 8dbec6d08b039045e18dbf4b9fd1b76e07414b9e
Author: Sylwester Lachiewicz <sl...@apache.org>
AuthorDate: Thu Oct 1 07:27:07 2026 +0200

    Name enforcer 4.0.0 as the release that removes the legacy rule API
---
 .../src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule.java | 3 ++-
 .../main/java/org/apache/maven/enforcer/rule/api/EnforcerRule2.java    | 3 ++-
 .../java/org/apache/maven/enforcer/rule/api/EnforcerRuleHelper.java    | 3 ++-
 .../apache/maven/plugins/enforcer/internal/EnforcerRuleManager.java    | 2 +-
 4 files changed, 7 insertions(+), 4 deletions(-)

diff --git a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule.java b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule.java
index dba86da4..6b5447c4 100644
--- a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule.java
+++ b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule.java
@@ -25,7 +25,8 @@ import javax.annotation.Nullable;
  * Interface to be implemented by any rules executed by the enforcer.
  *
  * @author <a href="mailto:brianf@apache.org">Brian Fox</a>
- * @deprecated Please see
+ * @deprecated Will be removed in Maven Enforcer 4.0.0 (the Maven 4 API line). Implement
+ *         {@link AbstractEnforcerRule} instead; see
  *         <a href="https://maven.apache.org/enforcer/enforcer-api/writing-a-custom-rule.html">Writing a custom rule</a>
  */
 @Deprecated
diff --git a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule2.java b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule2.java
index b9e05412..2476643a 100644
--- a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule2.java
+++ b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRule2.java
@@ -23,7 +23,8 @@ package org.apache.maven.enforcer.rule.api;
  *
  * @author Mirko Friedenhagen
  * @since 1.4
- * @deprecated Please see
+ * @deprecated Will be removed in Maven Enforcer 4.0.0 (the Maven 4 API line). Implement
+ *         {@link AbstractEnforcerRule} instead; see
  *         <a href="https://maven.apache.org/enforcer/enforcer-api/writing-a-custom-rule.html">Writing a custom rule</a>
  */
 @Deprecated
diff --git a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRuleHelper.java b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRuleHelper.java
index eeaec78d..2e1c5f61 100644
--- a/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRuleHelper.java
+++ b/enforcer-api/src/main/java/org/apache/maven/enforcer/rule/api/EnforcerRuleHelper.java
@@ -35,7 +35,8 @@ import org.codehaus.plexus.component.repository.exception.ComponentLookupExcepti
  * rules.
  *
  * @author <a href="mailto:brianf@apache.org">Brian Fox</a>
- * @deprecated Please see
+ * @deprecated Will be removed in Maven Enforcer 4.0.0 (the Maven 4 API line). Rules extending
+ *         {@link AbstractEnforcerRule} use injected components instead; see
  *         <a href="https://maven.apache.org/enforcer/enforcer-api/writing-a-custom-rule.html">Writing a custom rule</a>
  */
 @Deprecated
diff --git a/maven-enforcer-plugin/src/main/java/org/apache/maven/plugins/enforcer/internal/EnforcerRuleManager.java b/maven-enforcer-plugin/src/main/java/org/apache/maven/plugins/enforcer/internal/EnforcerRuleManager.java
index 9ea3f08c..b8fb1e69 100644
--- a/maven-enforcer-plugin/src/main/java/org/apache/maven/plugins/enforcer/internal/EnforcerRuleManager.java
+++ b/maven-enforcer-plugin/src/main/java/org/apache/maven/plugins/enforcer/internal/EnforcerRuleManager.java
@@ -161,7 +161,7 @@ public class EnforcerRuleManager {
             EnforcerRuleBase rule = (EnforcerRuleBase) Class.forName(ruleClass).newInstance();
             log.warn(
                     "ruleName " + ruleName + " with implementation " + ruleClass
-                            + " uses the deprecated Maven Enforcer Plugin API. This will not be supported in a future version of the plugin. Please contact the rule maintainer to upgrade the rule implementation to the current API.");
+                            + " uses the deprecated Maven Enforcer Plugin API. This API will be removed in Maven Enforcer 4.0.0. Please contact the rule maintainer to migrate the rule to AbstractEnforcerRule (see https://maven.apache.org/enforcer/enforcer-api/writing-a-custom-rule.html).");
             return new EnforcerRuleDesc(ruleName, rule);
         } catch (Exception e) {
             throw new EnforcerRuleManagerException(