Enterprise Java

RESTful Error Handling with Spring

This post will illustrate a way in which exception handling can be implemented for RESTful web services in Spring in such a manner that the exception handling concerns are separated from the application logic.

Taking advantage of the @ControllerAdvice annotation we are able to create a global helper class for all controllers. By adding methods that we annotate with both @ExceptionHandler and @ResponseStatus we can specify which type of exception gets mapped to which HTTP response status. E.g., our custom NotFoundException can be mapped to a HTTP response of 404 Not Found, or all exceptions that are not caught elsewhere will result in HTTP status 500 Internal Server Error by catching java.lang.Exception, or an IllegalArgumentException can result in 400 Bad Request, or… well, I’m sure you got the general idea.

If required, you can also send back some more detail to the client by adding @ResponseBody into the mix.

Below is a very limited example to get you started.


package it.jdev.examples.spring.rest.exceptions;

import java.lang.invoke.MethodHandles;
import org.slf4j.*;
import org.springframework.core.Ordered;
import org.springframework.core.annotation.Order;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.context.request.ServletWebRequest;

public class GeneralRestExceptionHandler {

    private static final Logger LOGGER = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

    public void handleNotFoundException(final Exception exception) {

    public void handleForbiddenException(final Exception exception) {

    @ExceptionHandler({ CustomException.class, Exception.class })
    public void handleGeneralException(final Exception exception) {

    public void handleGeneralException(final Exception exception) {

    @ExceptionHandler({ CustomBadRequestException.class, IllegalArgumentException.class })
    public String handleBadRequestException(final Exception exception) {
        return exception.getMessage();

    // Add more exception handling as needed…
    // …

    private void logException(final Exception exception) {
        // ...

Reference: RESTful Error Handling with Spring from our JCG partner Wim van Haaren at the JDev blog.

Want to know how to develop your skillset to become a Java Rockstar?

Join our newsletter to start rocking!

To get you started we give you our best selling eBooks for FREE!


1. JPA Mini Book

2. JVM Troubleshooting Guide

3. JUnit Tutorial for Unit Testing

4. Java Annotations Tutorial

5. Java Interview Questions

6. Spring Interview Questions

7. Android UI Design


and many more ....


Receive Java & Developer job alerts in your Area

I have read and agree to the terms & conditions


Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

1 Comment
Newest Most Voted
Inline Feedbacks
View all comments
4 years ago

And How do i do for HTTPS?

Back to top button