Servlet Manejo de excepciones

Cuando un Servlet lanza una excepción, el contenedor web, en la configuración que utiliza el elemento exception-type,web.xmlbusca la configuración que coincida con el tipo de excepción lanzada.

Debe utilizar en web.xml elerror-pageelemento para especificar que, ante unaexcepcióno un código deestado HTTP,se debe realizar la llamada correspondiente del Servlet.

Configuración de web.xml

Supongamos que hay unErrorHandlerServlet que se invoca cuando se produce cualquier excepción o error definido. A continuación se muestra la entrada que se creará en web.xml.

<!-- servlet 定义 -->
<servlet>
        <servlet-name>ErrorHandler</servlet-name>
        <servlet-class>ErrorHandler</servlet-class>
</servlet>
<!-- servlet 映射 -->
<servlet-mapping>
        <servlet-name>ErrorHandler</servlet-name>
        <url-pattern>/ErrorHandler</url-pattern>
</servlet-mapping>

<!-- error-code 相关的错误页面 -->
<error-page>
    <error-code>404</error-code>
    <location>/ErrorHandler</location>
</error-page>
<error-page>
    <error-code>403</error-code>
    <location>/ErrorHandler</location>
</error-page>

<!-- exception-type 相关的错误页面 -->
<error-page>
    <exception-type>
          javax.servlet.ServletException
    </exception-type >
    <location>/ErrorHandler</location>
</error-page>

<error-page>
    <exception-type>java.io.IOException</exception-type >
    <location>/ErrorHandler</location>
</error-page>

Si desea tener un manejador de errores general para todas las excepciones, debe definir el siguiente error-page en lugar de definir elementos error-page separados para cada excepción:

<error-page>
    <exception-type>java.lang.Throwable</exception-type >
    <location>/ErrorHandler</location>
</error-page>

A continuación se presentan los puntos a tener en cuenta sobre el manejo de excepciones en el web.xml anterior:

  • El Servlet ErrorHandler se define de la misma manera que los demás Servlets y se configura en web.xml.
  • Si aparece un código de estado de error, ya sea 404 (Not Found - No encontrado) o 403 (Forbidden - Prohibido), se invocará el Servlet ErrorHandler.
  • Si la aplicación web lanza unaServletExceptionoIOExceptionentonces el contenedor web invocará el Servlet ErrorHandler.
  • Puede definir diferentes manejadores de errores para manejar diferentes tipos de errores o excepciones. El ejemplo anterior es muy genérico; esperamos que a través del ejemplo pueda comprender los conceptos básicos.

Atributos de solicitud - Errores/Excepciones

La siguiente es una lista de atributos de solicitud a los que puede acceder el Servlet de manejo de errores para analizar la naturaleza del error/excepción.

N.ºAtributo y descripción
1javax.servlet.error.status_code
Este atributo proporciona el código de estado, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.Integer.
2javax.servlet.error.exception_type
Este atributo proporciona información sobre el tipo de excepción, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.Class.
3javax.servlet.error.message
Este atributo proporciona información sobre el mensaje de error exacto, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.String.
4javax.servlet.error.request_uri
Este atributo proporciona información sobre la URL que invoca al Servlet, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.String.
5javax.servlet.error.exception
Este atributo proporciona información sobre la excepción generada, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.Throwable.
6javax.servlet.error.servlet_name
Este atributo proporciona el nombre del Servlet, que puede almacenarse y analizarse cuando se almacena como tipo de datos java.lang.String.

Ejemplo de manejador de errores de Servlet

A continuación se muestra un ejemplo de Servlet que actuará como manejador de errores cuando se produzca cualquier error o excepción que usted defina.

Este ejemplo le brinda una comprensión básica del manejo de excepciones en Servlets; puede utilizar los mismos conceptos para escribir aplicaciones de manejo de excepciones más complejas:

//导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;

//扩展 HttpServlet 类
public class ErrorHandler extends HttpServlet {

    // 处理 GET 方法请求的方法
    public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
    {
        Throwable throwable = (Throwable)
        request.getAttribute("javax.servlet.error.exception");
        Integer statusCode = (Integer)
        request.getAttribute("javax.servlet.error.status_code");
        String servletName = (String)
        request.getAttribute("javax.servlet.error.servlet_name");
        if (servletName == null){
            servletName = "Unknown";
        }
        String requestUri = (String)
        request.getAttribute("javax.servlet.error.request_uri");
        if (requestUri == null){
            requestUri = "Unknown";
        }
        // 设置响应内容类型
        response.setContentType("text/html;charset=UTF-8");
    
        PrintWriter out = response.getWriter();
        String title = "Ejemplo Error/Exception 信息";
       
        String docType = "<!DOCTYPE html>\n";
        out.println(docType +
            "<html>\n" +
             "<head><title>" + title + "</title></head>\n" +
             "<body bgcolor=\"#F0F0F0\">\n");
           out.println("<h1>Ejemplo异常信息实例演示</h1>");
           if (throwable == null && statusCode == null){
              out.println("<h2>错误信息丢失</h2>");
              out.println("请返回 <a href=\"" + 
            response.encodeURL("http://localhost:8080/") + 
                "\">主页</a>。");
           }else if (statusCode != null) {
              out.println("错误代码 : " + statusCode);
        }else{
               out.println("<h2>错误信息</h2>");
              out.println("Servlet Name : " + servletName + 
                              "</br></br>");
              out.println("异常类型 : " + 
                              throwable.getClass( ).getName( ) + 
                              "</br></br>");
              out.println("请求 URI: " + requestUri + 
                              "<br><br>");
              out.println("异常信息: " + 
                                  throwable.getMessage( ));
           }
           out.println("</body>");
           out.println("</html>");
    }
    // 处理 POST 方法请求的方法
    public void doPost(HttpServletRequest request,
                      HttpServletResponse response)
       throws ServletException, IOException {
        doGet(request, response);
    }
}

Compile de la manera habitualErrorHandler.javay coloque sus archivos de clase en <directorio-de-instalación-de-Tomcat>/webapps/ROOT/WEB-INF/classes.

Agreguemos la siguiente configuración en el archivo web.xml para manejar excepciones:

<?xml version="1.0" encoding="UTF-8"?>  
<web-app>  
<servlet>
        <servlet-name>ErrorHandler</servlet-name>
        <servlet-class>com.ejemplo.test.ErrorHandler</servlet-class>
</servlet>
<!-- servlet mappings -->
<servlet-mapping>
        <servlet-name>ErrorHandler</servlet-name>
        <url-pattern>/TomcatTest/ErrorHandler</url-pattern>
</servlet-mapping>
<error-page>
    <error-code>404</error-code>
    <location>/TomcatTest/ErrorHandler</location>
</error-page>
<error-page>
    <exception-type>java.lang.Throwable</exception-type >
    <location>/ErrorHandler</location>
</error-page>
</web-app>  

Ahora, intente usar un Servlet que genere una excepción, o ingrese una URL incorrecta; esto hará que el contenedor web invoque elErrorHandlerServlet y muestre un mensaje apropiado. Por ejemplo, si ingresa una URL incorrecta (como http://localhost:8080/TomcatTest/UnKonwPage), mostrará el siguiente resultado:

Otras extensiones