Exception Handling in Servlets

Last updated on May 31 2022
Vivek Saxena

Table of Contents

Exception Handling in Servlets

When a servlet throws an exception, the web container searches the configurations in web.xml that use the exception-type element for a match with the thrown exception type.

You would have to use the error-page element in web.xml to specify the invocation of servlets in response to certain exceptions or HTTP status codes.

web.xml Configuration

Consider, you have an ErrorHandler servlet which would be called whenever there is any defined exception or error. Following would be the entry created in 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>

If you want to have a generic Error Handler for all the exceptions then you should define following error-page instead of defining separate error-page elements for every exception −

<error-page>

   <exception-type>java.lang.Throwable</exception-type >

   <location>/ErrorHandler</location>

</error-page>

Following are the points to be noted about above web.xml for Exception Handling −

  • The servlet ErrorHandler is defined in usual way as any other servlet and configured in web.xml.
  • If there is any error with status code either 404 (Not Found) or 403 (Forbidden ), then ErrorHandler servlet would be called.
  • If the web application throws either ServletException or IOException, then the web container invokes the /ErrorHandler servlet.
  • You can define different Error Handlers to handle different type of errors or exceptions. Above example is very much generic and hope it serve the purpose to explain you the basic concept.

Request Attributes − Errors/Exceptions

Following is the list of request attributes that an error-handling servlet can access to analyze the nature of error/exception.

Sr.No. Attribute & Description
1 javax.servlet.error.status_code

This attribute give status code which can be stored and analyzed after storing in a java.lang.Integer data type.

2 javax.servlet.error.exception_type

This attribute gives information about exception type which can be stored and analysed after storing in a java.lang.Class data type.

3 javax.servlet.error.message

This attribute gives information exact error message which can be stored and analyzed after storing in a java.lang.String data type.

4 javax.servlet.error.request_uri

This attribute gives information about URL calling the servlet and it can be stored and analysed after storing in a java.lang.String data type.

5 javax.servlet.error.exception

This attribute gives information about the exception raised, which can be stored and analysed.

6 javax.servlet.error.servlet_name

This attribute gives servlet name which can be stored and analyzed after storing in a java.lang.String data type.

Error Handler Servlet Example

This example would give you basic understanding of Exception Handling in Servlet, but you can write more sophisticated filter applications using the same concept −

// 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);

   }

}

Compile ErrorHandler.java in usual way and put your class file in /webapps/ROOT/WEB-INF/classes.

Let us add the following configuration in web.xml to handle exceptions −

<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>

Now try to use a servlet which raise any exception or type a wrong URL, this would trigger Web Container to call ErrorHandler servlet and display an appropriate message as programmed. For example, if you type a wrong URL then it would display the following result −

The status code : 404

The above code may not work with some web browsers. So, try with Mozilla and Safari and it should work.

So, this brings us to the end of blog. This Tecklearn ‘Exception Handling in Servlets’ blog helps you with commonly asked questions if you are looking out for a job in Java Programming. If you wish to learn Servlets and build a career Java Programming domain, then check out our interactive, Java and JEE Training, that comes with 24*7 support to guide you throughout your learning period. Please find the link for course details:

https://www.tecklearn.com/course/java-and-jee-training/

Java and JEE Training

About the Course

Java and JEE Certification Training is designed by professionals as per the industrial requirements and demands. This training encompasses comprehensive knowledge on basic and advanced concepts of core Java & J2EE along with popular frameworks like Hibernate, Spring & SOA. In this course, you will gain expertise in concepts like Java Array, Java OOPs, Java Function, Java Loops, Java Collections, Java Thread, Java Servlet, and Web Services using industry use-cases and this will help you to become a certified Java expert.

Why Should you take Java and JEE Training?

  • Java developers are in great demand in the job market. With average pay going between $90,000/- to $120,000/- depending on your experience and the employers.
  • Used by more than 10 Million developers worldwide to develop applications for 15 Billion devices.
  • Java is one of the most popular programming languages in the software world. Rated #1 in TIOBE Popular programming languages index (15th Consecutive Year)

What you will Learn in this Course?

Introduction to Java

  • Java Fundamentals
  • Introduction to Java Basics
  • Features of Java
  • Various components of Java language
  • Benefits of Java over other programming languages
  • Key Benefits of Java

Installation and IDE’s for Java Programming Language

  • Installation of Java
  • Setting up of Eclipse IDE
  • Components of Java Program
  • Editors and IDEs used for Java Programming
  • Writing a Simple Java Program

Data Handling and Functions

  • Data types, Operations, Compilation process, Class files, Loops, Conditions
  • Using Loop Constructs
  • Arrays- Single Dimensional and Multi-Dimensional
  • Functions
  • Functions with Arguments

OOPS in Java: Concept of Object Orientation

  • Object Oriented Programming in Java
  • Implement classes and objects in Java
  • Create Class Constructors
  • Overload Constructors
  • Inheritance
  • Inherit Classes and create sub-classes
  • Implement abstract classes and methods
  • Use static keyword
  • Implement Interfaces and use it

Polymorphism, Packages and String Handling

  • Concept of Static and Run time Polymorphism
  • Function Overloading
  • String Handling –String Class
  • Java Packages

Exception Handling and Multi-Threading

  • Exception handling
  • Various Types of Exception Handling
  • Introduction to multi-threading in Java
  • Extending the thread class
  • Synchronizing the thread

File Handling in Java

  • Input Output Streams
  • io Package
  • File Handling in Java

Java Collections

  • Wrapper Classes and Inner Classes: Integer, Character, Boolean, Float etc
  • Applet Programs: How to write UI programs with Applet, Java.lang, Java.io, Java.util
  • Collections: ArrayList, Vector, HashSet, TreeSet, HashMap, HashTable

Java Database Connectivity (JDBC)

  • Introduction to SQL: Connect, Insert, Update, Delete, Select
  • Introduction to JDBC and Architecture of JDBC
  • Insert/Update/Delete/Select Operations using JDBC
  • Batch Processing Transaction
  • Management: Commit and Rollback

Java Enterprise Edition – Servlets

  • Introduction to J2EE
  • Client Server architecture
  • URL, Port Number, Request, Response
  • Need for servlets
  • Servlet fundamentals
  • Setting up a web project in Eclipse
  • Configuring and running the web app with servlets
  • GET and POST request in web application with demo
  • Servlet lifecycle
  • Servlets Continued
  • Session tracking and filter
  • Forward and include Servlet request dispatchers

Java Server Pages (JSP)

  • Fundamentals of Java Server Page
  • Writing a code using JSP
  • The architecture of JSP
  • JSP Continued
  • JSP elements: Scriptlets, expressions, declaration
  • JSP standard actions
  • JSP directives
  • Introduction to JavaBeans
  • ServletConfig and ServletContext
  • Servlet Chaining
  • Cookies Management
  • Session Management

Hibernate

  • Introduction to Hibernate
  • Introduction to ORM
  • ORM features
  • Hibernate as an ORM framework
  • Hibernate features
  • Setting up a project with Hibernate framework
  • Basic APIs needed to do CRUD operations with Hibernate
  • Hibernate Architecture

POJO (Plain Old Java Object)

  • POJO (Plain Old Java Object)
  • Persistent Objects
  • Lifecycle of Persistent Object

Spring

  • Introduction to Spring
  • Spring Fundamentals
  • Advanced Spring

Got a question for us? Please mention it in the comments section and we will get back to you.

 

 

0 responses on "Exception Handling in Servlets"

Leave a Message

Your email address will not be published. Required fields are marked *