Pra que serve e como funciona o ServletRequestAttributeListener

O ServletRequestAttributeListener é uma interface que serve para monitorar os atributos adicionados, alterados e removidos de uma requisição. Sempre que se adiciona um atributo no objeto ServletRequest, o método attributeAdded do listener que implementa essa interface é chamado. Sempre que se substitui um atributo do objeto ServletRequest, o método attributeReplaced do listener que implementa essa interface é chamado. E finalmente, sempre que se remove um atributo do objeto ServletRequest o método attributeRemoved é chamado.

Veja abaixo o exemplo de uma classe que implementa esse listener para exibir o nome e o valor do parâmetro que foi adicionado, alterado e removido:

import javax.servlet.ServletRequestAttributeListener;
import javax.servlet.ServletRequestAttributeEvent;
import javax.servlet.http.HttpServletRequest;

public class MeuServletRequestAttributeListener implements ServletRequestAttributeListener
{
    public void attributeAdded(ServletRequestAttributeEvent e)
    {
        System.out.println("Atributo adicionado -> nome: " 
            + e.getName() + ", valor: " + e.getValue() );
    }
    
    public void attributeRemoved(ServletRequestAttributeEvent e)
    {
        System.out.println("Atributo removido -> nome: " 
            + e.getName() + ", valor: " + e.getValue() );
    }
    
    public void attributeReplaced(ServletRequestAttributeEvent e)
    {
        System.out.println("Atributo alterado -> nome: " 
            + e.getName() + ", valorAntigo: " + e.getValue() );
    }
}

Para testar esse listener criei ainda um Servlet mapeado com o endereço /TesteAtributoRequest.do. Este Servlet faz forward para si mesmo decrementando o atributo "numero" que é guardado na requisição. Veja como fica o código:

public void doGet(HttpServletRequest request, HttpServletResponse response) 
 throws IOException, ServletException
{
    int numero;
    
    if( request.getAttribute("numero") != null )
    {
        numero = ( (Integer)request.getAttribute("numero") ).intValue();
        numero--;
    }
    else
    {
        try
        {
            numero = Integer.parseInt( request.getParameter("numero") );
        }
        catch(NumberFormatException e)
        {
            numero = 3;
        }
    }
    
    if( numero <= 0 ) 
    {
        request.removeAttribute("numero");
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.print("Acaboooou");
    }
    else
    {
        request.setAttribute("numero", new Integer(numero));
        request.getRequestDispatcher( "/TesteAtributoRequest.do" ).forward(request,response);
    }
}

Ao executá-lo mandando o parâmetro "numero" com valor igual a 5 por exemplo, o listener configurado irá exibir a seguinte saída:

Atributo adicionado -> nome: numero, valor: 5
Atributo alterado -> nome: numero, valorAntigo: 5
Atributo alterado -> nome: numero, valorAntigo: 4
Atributo alterado -> nome: numero, valorAntigo: 3
Atributo alterado -> nome: numero, valorAntigo: 2
Atributo removido -> nome: numero, valor: 1