Spring Exception Handling With Examples

Spring  In this article, I will be covering the various exception handling mechanisms in Spring.

Using an ExceptionHandler

The first approach is the ExceptionHandler approach. In this approach, you can designate a method in your controller with the @ExceptionHandler annotation. You can specify some exceptions with this annotation. When those exceptions occur, the code in the method will be executed.

The following code demonstrates this:

@Controllerpublic class PersonController {//controller methods@ExceptionHandler(RuntimeException.class)public void onRunTimeException(RuntimeException e){//exception handling code for RuntimeException}}

Edit

Here, the code specifies the @ExceptionHandler annotation on the onRuntimeException class. So this method is designated as an exception handling method. Whenever a RuntimeException occurs within any method in the PersonController, the code invokes this method.

You can specify any type and any number of arguments to a method that has the @ExceptionHandler annotation. In the above example,  only one argument which is an object of RuntimeException is specified. You may also specify the Request/Response/Model/ModelAndView objects as arguments. The method can also return data of any type. If it returns a void, it means that the exception handling method directly writes to the response stream.

The @ExceptionHandler annotation can be applied to a method in a controller class and handles only exceptions that occur in the controller class where it is specified.

The downside to this approach is that you need to have such an exception handling method in every controller in your code. So this may result in duplicate code.

Using ControllerAdvice annotation

The second option for exception handling within Spring is to have a separate class with exception handling methods. Such a class needs to have the @ControllerAdvice annotation specified. The advantage of this approach is that exceptions thrown by any part of the code can be handled by this class. So this class acts like a global exception handler.

The following code demonstrates this:

@ControllerAdvicepublic class CustomExceptonHandler {@ExceptionHandler(NullPointerException.class)@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)public void onNullPointerException(NullPointerException npe){// NullPointerException code}@ExceptionHandler(IllegalArgumentException.class)@ResponseStatus(HttpStatus.BAD_REQUEST)public void onIllegaArgumentException(IllegalArgumentException npe){//IllegalArgumentException code here}}

 

Here, the CustomExceptionHandler class has the @ControllerAdvice annotation. It has two exception handling methods, onNullPointerException and onIllegaArgumentException. Each method has the @ExceptionHandler annotation and the @ResponseStatus annotation. The @ExceptionHandler annotation specifies the exception that the method handles. The @ResponseStatus annotation specifies the HTTP response code that Spring should send to the client application when the particular exception occurs. So in the above code, when a NullPointerException occurs anywhere in the code, the Response code corresponding to Internal Server error will be sent to the client application.

Using ResponseStatusException

The third approach for Exception handling in Spring is using the ResponseStatusException. ResponseStatusException is a class that represents an exception. It is an alternative to use the @ResponseStatus annotation. Whenever an exception occurs in your code, you can create a ResponseStatusException with the appropriate HTTP error code and throw this exception. The following code demonstrates this:

 

@GetMapping(value = "/person")public Person loadPerson() {try {//code here} catch (Exception e) {throw new ResponseStatusException(HttpStatus.INTERNAL_SERVER_ERROR, "Exception occured");}}

In the above code, if an Exception occurs in the loadPerson method, it throws a ResponseStatusException with response code corresponding to Internal Server Error.

The advantage of using ResponseStatusException is that the exception class is not tied down to any particular status code, so you can use different status codes for the same exception, depending on the context in which the exception occurs. This is much better than the ExceptionHandler approach where the exception handling method can only handle the listed exceptions and also use only a single status code which is specified in the ResponseStatus annotation. Secondly, you do not need to create any custom exception classes, you can use this class as required with appropriate status codes.

The ResponseStatusException is a base exception. It has several sub-classes which you can use to handle different types of exceptions. So for example, the MediaTypeNotSupportedException is a sub-class of the ResponseStatusException. It corresponds to the HTTP status code 415.

Further Learning

Spring MasterClass
Spring Tutorial For Beginners
Step by Step Spring MVC Tutorial
Spring Framework in Easy Steps

Comments

Post a Comment

Popular posts from this blog

How to use logging in SpringBoot with code samples

Image
In this article, we will learn how to use logging in SpringBoot. Introduction There are several Java logging frameworks like logback, log4j, and so on. Spring Boot supports out-of-the-box support for logback. Let us learn how to use logging in SpringBoot with logback. Step 1 – Create a New Maven Project Create a new Maven project. (Refer to  this  blog post). This will create a project in Eclipse as follows:   Step 2 – Add the Spring Boot Dependencies Add the spring-boot-starter-web dependency to the pom.xml . So, the pom.xml should look as follows: <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.learnjava</groupId> <artifactId>learnjava-springboot-logging-example</artifactId> <version>0.0.1-SNAPSHOT&
Read more

Python While Loop with code samples

Much like a Java while loop, you can use a Python while loop to repeatedly execute a block of code as long as a condition is true. In this article, we will learn more about the Python while loop. Python While loop Syntax A while loop in Python has the following syntax: while <condition>: loop body The while keyword is followed by a condition. If the condition evaluates to true, the body of the loop is executed. Once the body of the loop is completed, the condition is checked again and this is repeated until the condition evaluates to false at which point the loop is exited. While loop Sample Code The following code demonstrates how you can use the while loop: num=10counter=1total=0while counter<=num: total += counter counter+=1print("sum of first 10 numbers is",total) This code adds the numbers from 1 to 10 and prints the sum. It uses a while loop to iterate from 1 to 10. The while loop checks the condition counter <= num and if so adds the current value of count
Read more

How to convert a List to a Set

In this blog post ,I will be showing you how you can convert a List to a Set. Consider the following code snippet: public class ListToSetDemo {public static void main(String[] args) {List<Integer> list = Arrays.asList(5,3,11,15,9);//Method 1Set<Integer> set = new HashSet<Integer>(list);System.out.println("Set is "+set);//method 2Set<Integer> set2 = new HashSet<Integer>();set2.addAll(list);System.out.println("Set is "+set2);}} This code demonstrates two ways to convert a List to a Set. Method 1 Here, we are creating a new HashSet . We are invoking the constructor that accepts a Collection object. Here, we are passing in the input list to this constructor.   Method 2 Here again, we are creating a new HashSet . However, we are using the default constructor. We are then invoking the addAll method and passing in the input list.   When you run this code, it will print the following output: Set is [3, 5, 9, 11, 15]Set is [3, 5, 9, 11, 15] No
Read more