Custom Http Status Code in Spring

Question

I am using Spring Boot and I am using Exception Classes thoughout my business logic code. One might look like this:

@ResponseStatus(HttpStatus.BAD_REQUEST)
public class ExternalDependencyException extends RuntimeException {

    public ExternalDependencyException() {
        super("External Dependency Failed");
    }
    public ExternalDependencyException(String message) {
        super(message);
    }

}

Well now there are Exception, where no predefined Http Status code is fitting, so I would like to use a status code like 460 or similar, which is still free, but the annotation ResponseStatus just accepts values from the enum HttpStatus. Is there a way to achieve an Exception class with a custom status code in the java spring boot environment?

mdeterman · Accepted Answer · 2017-09-28 14:36:54Z

10

I'm not aware of a way to do this with @ResponseStatus.

One way to solve is this issue is with @RestControllerAdvice. This will allow you to customize how you return your Exception.

@RestControllerAdvice
public class WebRestControllerAdvice  {

    @ExceptionHandler(ExternalDependencyException.class)
    public String handleGitlabException(ExternalDependencyException ex, HttpServletResponse response) {
        try {
            response.sendError(460);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return ex.getMessage();
    }
}

answered Sep 28, 2017 at 14:36

mdeterman

4,3991 gold badge10 silver badges9 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

mdeterman Over a year ago

Just to note this is since 4.3

Volodymyr Kret · Accepted Answer · 2020-08-11 13:21:28Z

3

In general, @mdeterman answer is good, but I believe the right thing to do is setStatus to response, not sendError directly. Example:

@RestControllerAdvice
public class CustomExceptionHandler { 
    @ExceptionHandler(CustomException.class)
    public String handleException(Exception ex, HttpServletResponse response) {
        response.setStatus(460);
        return ex.getMessage();
    }
}

It seems to be possible only because of @RestControllerAdvice. @ControllerAdvice reset status code on view resolver level (for some strange reason). Also it is important to understand: any custom status code (not mentioned in org.apache.http.HttpStatus - RFC1945, RFC2616 , and RFC2518) will cause UnknownHttpStatusCodeException if client service is based on spring.

edited Aug 11, 2020 at 13:21

answered Aug 11, 2020 at 13:15

Volodymyr Kret

1,52915 silver badges16 bronze badges

Comments

Axzial · Accepted Answer · 2021-10-18 15:52:31Z

1

Yes, sendError() will use Spring default Template. You also need to use RestControllerAdvice instead of ControllerAdvice, then setStatus() will do the trick :)

@RestControllerAdvice
public class ExceptionService {

    @SneakyThrows
    @ExceptionHandler({CustomException.class})
    public CustomExceptionDto handle(HttpServletResponse resp, CustomException e) {
        resp.setStatus(e.getStatus().value()); //Using Spring HttpStatus
        return e.toDto();
    }

}

answered Oct 18, 2021 at 15:52

Axzial

114 bronze badges

Comments

MiguelPuyol · Accepted Answer · 2019-10-02 09:31:44Z

0

In Spring Boot 2.1.8.RELEASE I did something similar but without using the HttpServletResponse:

@RestControllerAdvice
public class RestExceptionHandler {

    @ExceptionHandler(MyCustomException.class)
    @ResponseStatus(HttpStatus.NOT_ACCEPTABLE)
    public ApiErrorResponse handleTemplateEngineException(MyCustomException ex) {

        //custom ApiErrorResponse class
        return ApiErrorResponse.builder()
                .status(HttpStatus.NOT_ACCEPTABLE)
                .errorCode("NOT_ACCEPTABLE")
                .message(ex.getLocalizedMessage()).build();
    }
}

answered Oct 2, 2019 at 9:31

MiguelPuyol

4393 silver badges10 bronze badges

Collectives™ on Stack Overflow

Custom Http Status Code in Spring

4 Answers 4

1 Comment

Comments

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

4 Answers 4

1 Comment

Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related