HTML CSS JAVASCRIPT PYTHON PYTHON2 JAVA C C++ C# SQL Excel Linux AI BOOTSTRAP PHP 教程库 参考手册 技术文章 测验 练习 HOWTO FAQ
❮ 上一节 下一节 ❯

Servlet - 异常处理

当 servlet 抛出异常时，Web 容器会在 web.xml 中使用 exception-type 元素搜索与抛出的异常类型匹配的配置。

您必须使用 web.xml 中的 error-page 元素来指定对某些 异常 或 HTTP 状态代码 的 servlet 调用。

web.xml 配置

假设您有一个 ErrorHandler servlet，只要出现任何定义的异常或错误，就会调用该 servlet。以下是在 web.xml 中创建的条目。

<!-- servlet definition -->
<servlet>
   <servlet-name>ErrorHandler</servlet-name>
   <servlet-class>ErrorHandler</servlet-class>
</servlet>

<!-- servlet mappings -->
<servlet-mapping>
   <servlet-name>ErrorHandler</servlet-name>
   <url-pattern>/ErrorHandler</url-pattern>
</servlet-mapping>

<!-- error-code related error pages -->
<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 related error pages -->
<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>

如果您想要为所有异常设置一个通用的错误处理程序，那么您应该定义以下错误页面，而不是为每个异常定义单独的错误页面元素 −

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

以下是关于上述 web.xml 异常处理需要注意的几点 −

  • servlet ErrorHandler 的定义方式与任何其他 servlet 一样，并在 web.xml 中配置。

  • 如果出现任何错误，状态代码为 404(未找到)或 403(禁止访问)，则会调用 ErrorHandler servlet。

  • 如果 Web 应用程序抛出 ServletException 或 IOException，则 Web 容器将调用 /ErrorHandler servlet。

  • 您可以定义不同的错误处理程序来处理不同类型的错误或异常。上面的例子非常通用，希望它能够帮助您解释基本概念。

请求属性 − 错误/异常

以下是错误处理 servlet 可以访问以分析错误/异常性质的请求属性列表。

Sr.No. 属性 &描述
1

javax.servlet.error.status_code

此属性提供状态代码，可在 java.lang.Integer 数据类型中存储和分析。
2

javax.servlet.error.exception_type

此属性提供有关异常类型的信息，可在 java.lang.Class 数据类型中存储和分析。
3

javax.servlet.error.message

此属性提供准确的错误消息，可在 java.lang.String 数据类型中存储和分析。
4

javax.servlet.error.request_uri

此属性提供有关调用 servlet 的 URL 的信息，可在 java.lang.String 数据类型中存储和分析。
5

javax.servlet.error.exception

此属性提供有关引发的异常的信息，可以存储和分析这些信息。
6

javax.servlet.error.servlet_name

此属性提供 servlet 名称，可以将其存储在 java.lang.String 数据类型中，然后进行存储和分析。

错误处理程序 Servlet 示例

此示例将让您对 Servlet 中的异常处理有基本的了解，但您可以使用相同的概念编写更复杂的过滤器应用程序 −

// 导入所需的 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 {
         
      // Analyze the servlet exception       
      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");

      PrintWriter out = response.getWriter();
      String title = "Error/Exception Information";
      String docType =
         "<!doctype html public \"-//w3c//dtd html 4.0 " +
         "transitional//en\">";
         
      out.println(docType +
         "<html>" ++
         "<head><title>" + title + "</title></head>" ++
         "<body bgcolor = \"#f0f0f0\">
");

      if (throwable == null && statusCode == null) {
         out.println("<h2>Error information is missing</h2>");
         out.println("Please return to the <a href=\"" + 
            response.encodeURL("http://localhost:8080/") + 
            "\">Home Page</a>.");
      } else if (statusCode != null) {
         out.println("The status code : " + statusCode);
      } else {
         out.println("<h2>Error information</h2>");
         out.println("Servlet Name : " + servletName + "</br></br>");
         out.println("Exception Type : " + throwable.getClass( ).getName( ) + "</br></br>");
         out.println("The request URI: " + requestUri + "<br><br>");
         out.println("The exception message: " + throwable.getMessage( ));
      }
      out.println("</body>");
      out.println("</html>");
   }
   
   // 处理 POST 方法请求的方法。
   public void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
      
      doGet(request, response);
   }
}

按通常方式编译 ErrorHandler.java，并将类文件放在 /webapps/ROOT/WEB-INF/classes 中。

让我们在 web.xml 中添加以下配置来处理异常 −

<servlet>
   <servlet-name>ErrorHandler</servlet-name>
   <servlet-class>ErrorHandler</servlet-class>
</servlet>

<!-- servlet mappings -->
<servlet-mapping>
   <servlet-name>ErrorHandler</servlet-name>
   <url-pattern>/ErrorHandler</url-pattern>
</servlet-mapping>

<error-page>
   <error-code>404</error-code>
   <location>/ErrorHandler</location>
</error-page>

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

现在尝试使用引发任何异常或输入错误 URL 的 servlet，这将触发 Web 容器调用 ErrorHandler servlet 并按编程显示适当的消息。例如，如果您输入错误的 URL，则将显示以下结果 −

The status code : 404

上述代码可能无法在某些 Web 浏览器上运行。因此，请尝试使用 Mozilla 和 Safari，它应该可以运行。

❮ 上一节 下一节 ❯