Servlets 简明教程
Servlets - Exception Handling
当 servlet 引发异常时,Web 容器会搜索 web.xml 中使用 exception-type 元素匹配引发异常类型的配置。
您需要在 web.xml 中使用 error-page 元素,以指定根据特定 exceptions 或 HTTP status codes 来调用 servlet。
web.xml Configuration
假设您有一个 ErrorHandler 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,而不是针对每个异常定义单独的 error-page 元素 −
<error-page>
<exception-type>java.lang.Throwable</exception-type >
<location>/ErrorHandler</location>
</error-page>
以下是在 Exception Handling 的 web.xml 中要注意的要点 −
-
servlet ErrorHandler 以与任何其他 servlet 相同的方式定义,并在 web.xml 中进行配置。
-
如果存在状态代码为 404(未找到)或 403(禁止)的任何错误,则将调用 ErrorHandler servlet。
-
如果 Web 应用程序引发 ServletException 或 IOException,则 Web 容器将调用 /ErrorHandler servlet。
-
您可以定义不同的 Error Handler 来处理不同类型的错误或异常。上述示例具有很强的通用性,希望有助于向您解释基本概念。
Request Attributes − Errors/Exceptions
以下是错误处理 servlet 可访问的请求属性列表,用于分析错误/异常的本质。
Sr.No. |
Attribute & Description |
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 数据类型中并进行分析后存储。 |
Error Handler Servlet Example
此示例将使您基本了解 Servlet 中的异常处理,但是您可以使用相同概念编写更复杂的筛选器应用程序−
// Import required java libraries
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// Extend HttpServlet class
public class ErrorHandler extends HttpServlet {
// Method to handle GET method request.
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";
}
// Set response content type
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\">\n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n" +
"<body bgcolor = \"#f0f0f0\">\n");
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>");
}
// Method to handle POST method request.
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,它应该可以正常工作。