This is an automated email from the ASF dual-hosted git repository.
lukaszlenart pushed a commit to branch support/struts-6-x-x
in repository https://gitbox.apache.org/repos/asf/struts.git
The following commit(s) were added to refs/heads/support/struts-6-x-x by this
push:
new 52333e798 WW-5707 chore(core): deprecate legacy restful and restful2
action mappers (#1883)
52333e798 is described below
commit 52333e798f1acefd39a37d7922241a857503601b
Author: Lukasz Lenart <[email protected]>
AuthorDate: Mon Aug 31 20:05:01 2026 +0200
WW-5707 chore(core): deprecate legacy restful and restful2 action mappers
(#1883)
The core restful (RestfulActionMapper) and restful2 (Restful2ActionMapper)
mappers predate the Struts REST plugin, which is the maintained way to build
REST-style applications. Mark both classes @Deprecated and point their
javadoc
to the REST plugin; removal is tracked as WW-5708.
Fixes: https://issues.apache.org/jira/browse/WW-5707
Claude-Session: https://claude.ai/code/session_016XMyQ1CRuYZkqygmD4aGHv
Co-authored-by: Claude Opus 4.8 <[email protected]>
---
.../org/apache/struts2/dispatcher/mapper/Restful2ActionMapper.java | 4 ++++
.../org/apache/struts2/dispatcher/mapper/RestfulActionMapper.java | 4 ++++
core/src/main/resources/struts-beans.xml | 2 ++
3 files changed, 10 insertions(+)
diff --git
a/core/src/main/java/org/apache/struts2/dispatcher/mapper/Restful2ActionMapper.java
b/core/src/main/java/org/apache/struts2/dispatcher/mapper/Restful2ActionMapper.java
index 1a11b06bf..d750bc80c 100644
---
a/core/src/main/java/org/apache/struts2/dispatcher/mapper/Restful2ActionMapper.java
+++
b/core/src/main/java/org/apache/struts2/dispatcher/mapper/Restful2ActionMapper.java
@@ -33,7 +33,11 @@ import java.util.StringTokenizer;
/**
* Extended version of {@link RestfulActionMapper}, see documentation for more
details
* <a
href="https://struts.apache.org/core-developers/restful-action-mapper.html";>Restful2ActionMapper</a>
+ *
+ * @deprecated since 6.12.0, this legacy mapper predates the Struts REST
plugin, which is the maintained
+ * way to build REST-style applications with Struts. Scheduled for removal in
the next major release.
*/
+@Deprecated
public class Restful2ActionMapper extends DefaultActionMapper {
private static final Logger LOG =
LogManager.getLogger(Restful2ActionMapper.class);
diff --git
a/core/src/main/java/org/apache/struts2/dispatcher/mapper/RestfulActionMapper.java
b/core/src/main/java/org/apache/struts2/dispatcher/mapper/RestfulActionMapper.java
index 56b111aa3..31220e67e 100644
---
a/core/src/main/java/org/apache/struts2/dispatcher/mapper/RestfulActionMapper.java
+++
b/core/src/main/java/org/apache/struts2/dispatcher/mapper/RestfulActionMapper.java
@@ -36,7 +36,11 @@ import java.util.regex.Pattern;
* Simple Restfull Action Mapper to support REST application
* See docs for more information
* <a
href="https://struts.apache.org/core-developers/restful-action-mapper.html";>RestfulActionMapper</a>
+ *
+ * @deprecated since 6.12.0, this legacy mapper predates the Struts REST
plugin, which is the maintained
+ * way to build REST-style applications with Struts. Scheduled for removal in
the next major release.
*/
+@Deprecated
public class RestfulActionMapper implements ActionMapper {
protected static final Logger LOG =
LogManager.getLogger(RestfulActionMapper.class);
diff --git a/core/src/main/resources/struts-beans.xml
b/core/src/main/resources/struts-beans.xml
index 878692bdf..1d7bc103c 100644
--- a/core/src/main/resources/struts-beans.xml
+++ b/core/src/main/resources/struts-beans.xml
@@ -79,6 +79,8 @@
class="org.apache.struts2.dispatcher.mapper.CompositeActionMapper"/>
<bean type="org.apache.struts2.dispatcher.mapper.ActionMapper"
name="prefix"
class="org.apache.struts2.dispatcher.mapper.PrefixBasedActionMapper"/>
+ <!-- Deprecated for removal: the legacy "restful" and "restful2" mappers
predate the Struts REST
+ plugin, which is the maintained way to build REST-style applications.
-->
<bean type="org.apache.struts2.dispatcher.mapper.ActionMapper"
name="restful"
class="org.apache.struts2.dispatcher.mapper.RestfulActionMapper"/>
<bean type="org.apache.struts2.dispatcher.mapper.ActionMapper"
name="restful2"
