Skip to main content

Migrate to Struts 6.0

org.openrewrite.java.struts.migrate6.MigrateStruts6

Migrate Struts 2.x to Struts 6.0.

Recipe source​

This recipe is only available to users of Moderne.

This recipe is available under the Moderne Proprietary License.

Examples​

Example 1​

MigrateInterceptorDisabledParamTest#migrateExcludeMethodsToDisabled

Before​
<struts>
    <package name="default" extends="struts-default">
        <action name="save" class="com.example.SaveAction">
            <interceptor-ref name="defaultStack">
                <param name="validation.excludeMethods">input,back,cancel</param>
            </interceptor-ref>
            <result>/success.jsp</result>
        </action>
    </package>
</struts>
After​
<struts>
    <package name="default" extends="struts-default">
        <action name="save" class="com.example.SaveAction">
            <interceptor-ref name="defaultStack">
                <param name="validation.disabled">input,back,cancel</param>
            </interceptor-ref>
            <result>/success.jsp</result>
        </action>
    </package>
</struts>
Example 2​

MigrateTilesListenerTest#migrateTilesListener

Before​
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <listener>
        <listener-class>org.apache.tiles.web.startup.TilesListener</listener-class>
    </listener>

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

</web-app>
After​
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <listener>
        <listener-class>org.apache.struts2.tiles.StrutsTilesListener</listener-class>
    </listener>

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

</web-app>
Example 3​

MigrateInterceptorDisabledParamTest#migrateExcludeMethodsToDisabled

Before​
<struts>
    <package name="default" extends="struts-default">
        <action name="save" class="com.example.SaveAction">
            <interceptor-ref name="defaultStack">
                <param name="validation.excludeMethods">input,back,cancel</param>
            </interceptor-ref>
            <result>/success.jsp</result>
        </action>
    </package>
</struts>
After​
<struts>
    <package name="default" extends="struts-default">
        <action name="save" class="com.example.SaveAction">
            <interceptor-ref name="defaultStack">
                <param name="validation.disabled">input,back,cancel</param>
            </interceptor-ref>
            <result>/success.jsp</result>
        </action>
    </package>
</struts>
Example 4​

MigrateTilesListenerTest#migrateTilesListener

Before​
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <listener>
        <listener-class>org.apache.tiles.web.startup.TilesListener</listener-class>
    </listener>

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

</web-app>
After​
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">

    <listener>
        <listener-class>org.apache.struts2.tiles.StrutsTilesListener</listener-class>
    </listener>

    <filter>
        <filter-name>struts2</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>

</web-app>

Usage​

This recipe has no required configuration options. Users of Moderne can run it via the Moderne CLI.

You will need to have configured the Moderne CLI on your machine before you can run the following command.

shell
mod run . --recipe MigrateStruts6

If the recipe is not available locally, then you can install it using:

mod config recipes jar install org.openrewrite.recipe:rewrite-struts:0.26.0

See how this recipe works across multiple open-source repositories​

Run this recipe on OSS repos at scale with the Moderne SaaS.

The community edition of the Moderne platform enables you to easily run recipes across thousands of open-source repositories.

Please contact Moderne for more information about safely running the recipes on your own codebase in a private SaaS.

Data Tables​

Static OGNL method access​

org.openrewrite.java.struts.table.StaticOgnlMethodAccess

Locations where OGNL expressions use static method access, which is disabled by default in Struts 6.

Column NameDescription
Source fileThe source file containing the OGNL expression.
OGNL expressionThe full OGNL expression containing the static method access.
Static classThe fully qualified class name being accessed statically.
Static methodThe static method being called.