Servlet - 異常處理

當servlet丟擲異常時，web容器會在web.xml中搜索使用exception-type元素的配置，以匹配丟擲的異常型別。

您必須在web.xml中使用error-page元素來指定響應某些異常或HTTP狀態碼而呼叫的servlet。

web.xml 配置

假設您有一個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>

以下是關於上述web.xml異常處理需要注意的幾點：

servlet ErrorHandler的定義方式與任何其他servlet相同，並在web.xml中進行配置。
如果出現狀態碼為404（未找到）或403（禁止）的錯誤，則將呼叫ErrorHandler servlet。
如果web應用程式丟擲ServletException或IOException，則web容器將呼叫/ErrorHandler servlet。
您可以定義不同的錯誤處理程式來處理不同型別的錯誤或異常。上面的例子非常通用，希望能達到解釋基本概念的目的。

請求屬性 - 錯誤/異常

以下是錯誤處理servlet可以訪問以分析錯誤/異常性質的請求屬性列表。

序號	屬性及描述
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中異常處理的基本理解，但您可以使用相同的概念編寫更復雜的過濾器應用程式：

// 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("https://: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>

現在嘗試使用引發任何異常的servlet或鍵入錯誤的URL，這將觸發Web容器呼叫ErrorHandler servlet並顯示已程式設計的適當訊息。例如，如果您輸入錯誤的URL，它將顯示以下結果：

The status code : 404

以上程式碼可能無法與某些Web瀏覽器一起使用。因此，請嘗試使用Mozilla和Safari，它應該可以工作。

列印頁面