A versão 2.5.13 do Apache Struts2 apresenta mudanças pontuais, mas críticas, em relação às versões anteriores, especialmente no que diz respeito à declaração de filtros no descritor de implantação da aplicação. Abaixo, detalhamos as etapas para configurar corretamente o ambiente.

1. Conifguração do arquivo web.xml

Diferente das versões mais antigas, onde um único filtro centralizado era a norma, o Struts2 2.5.x pode exigir a separação das responsabilidades de preparação e execução do ciclo de vida da requisição em filtros distintos no web.xml.

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

    <display-name>AppCalculadora</display-name>

    <!-- Filtro de Preparação -->
    <filter>
        <filter-name>struts-prep</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsPrepareFilter</filter-class>
    </filter>

    <!-- Filtro de Execução -->
    <filter>
        <filter-name>struts-exec</filter-name>
        <filter-class>org.apache.struts2.dispatcher.filter.StrutsExecuteFilter</filter-class>
    </filter>

    <filter-mapping>
        <filter-name>struts-prep</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <filter-mapping>
        <filter-name>struts-exec</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

Embora o StrutsPrepareAndExecuteFilter ainda seja amplamente utilizado, a estrutura acima garante maior controle sobre o pipeline de processamento nesta versão específica.

2. Dependências e Bibliotecas

Certifique-se de que as bibliotecas (JARs) essenciais do Struts2 Core estejam presentes no diretório WEB-INF/lib. Nesta versão, a ausência de bibliotecsa de suporte como log4j-api ou commons-lang3 pode causar falhas silenciosas na inicialização do servidor.

3. Definição de Ações no struts.xml

O arquivo struts.xml deve ser posicionado na raiz do diretório de fontes (src) para que seja compilado e movido para WEB-INF/classes. A sintaxe básica de mapeamento de ações permanece consistente, conforme o exemplo abaixo:

<?xml version="1.0" encoding="UTF-8" ?>


<struts>
    <package name="operacoes" namespace="/" extends="struts-default">
        <action name="processarCalculo" class="com.projeto.web.CalculoAction" method="executarSoma">
            <result name="sucesso">/resultado_positivo.jsp</result>
            <result name="erro">/resultado_negativo.jsp</result>
        </action>    
    </package>
</struts>

Note que, a partir da versão 2.5, há uma verificação mais rigorosa de segurança para chamadas de métodos. Caso utilize métodos personalizados, certifique-se de que a configuração do pacote permita a invocação ou utilize a anotação @AllowedMethods se necessário.