Package org.springframework.web.server

Class ResponseStatusException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

org.springframework.core.NestedRuntimeException

org.springframework.web.ErrorResponseException

org.springframework.web.server.ResponseStatusException

All Implemented Interfaces:

Serializable, ErrorResponse

Direct Known Subclasses:

HandlerMethodValidationException, MethodNotAllowedException, NoResourceFoundException, NotAcceptableStatusException, PayloadTooLargeException, ServerErrorException, ServerWebInputException, UnsupportedMediaTypeStatusException

public class ResponseStatusException
extends ErrorResponseException

Subclass of ErrorResponseException that accepts a "reason", and by default maps that to the "detail" of the ProblemDetail.

Since:

5.0

Author:

Rossen Stoyanchev, Juergen Hoeller

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.web.ErrorResponse

ErrorResponse.Builder, ErrorResponse.Interceptor

Constructor Summary

Constructors

Modifier	Constructor	Description
	ResponseStatusException(int rawStatusCode, @Nullable String reason, @Nullable Throwable cause)	Constructor with a response status and a reason to add to the exception message as explanation, as well as a nested exception.
	ResponseStatusException(HttpStatusCode status)	Constructor with a response status.
	ResponseStatusException(HttpStatusCode status, @Nullable String reason)	Constructor with a response status and a reason to add to the exception message as explanation.
	ResponseStatusException(HttpStatusCode status, @Nullable String reason, @Nullable Throwable cause)	Constructor with a response status and a reason to add to the exception message as explanation, as well as a nested exception.
protected	ResponseStatusException(HttpStatusCode status, @Nullable String reason, @Nullable Throwable cause, @Nullable String messageDetailCode, Object @Nullable [] messageDetailArguments)	Constructor with a message code and arguments for resolving the error "detail" via MessageSource.

Method Summary

Modifier and Type	Method	Description
HttpHeaders	getHeaders()	Return headers to add to the error response, for example, "Allow", "Accept", etc.
String	getMessage()
@Nullable String	getReason()	The reason explaining the exception (potentially null or empty).
ProblemDetail	updateAndGetBody(@Nullable MessageSource messageSource, Locale locale)	Use the given MessageSource to resolve the type, title, and detail message codes, and then use the resolved values to update the corresponding fields in ErrorResponse.getBody().

Methods inherited from class org.springframework.web.ErrorResponseException

getBody, getDetailMessageArguments, getDetailMessageCode, getStatusCode, setDetail, setInstance, setTitle, setType

Methods inherited from class org.springframework.core.NestedRuntimeException

contains, getMostSpecificCause, getRootCause

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.springframework.web.ErrorResponse

getDetailMessageArguments, getTitleMessageCode, getTypeMessageCode

Constructor Details

ResponseStatusException

public ResponseStatusException(HttpStatusCode status)

Constructor with a response status.

Parameters:

status - the HTTP status (required)

ResponseStatusException

public ResponseStatusException(HttpStatusCode status,
 @Nullable String reason)

Constructor with a response status and a reason to add to the exception message as explanation.

Parameters:

status - the HTTP status (required)

reason - the associated reason (optional)

ResponseStatusException

public ResponseStatusException(int rawStatusCode,
 @Nullable String reason,
 @Nullable Throwable cause)

Constructor with a response status and a reason to add to the exception message as explanation, as well as a nested exception.

Parameters:

rawStatusCode - the HTTP status code value

reason - the associated reason (optional)

cause - a nested exception (optional)

Since:

5.3

ResponseStatusException

public ResponseStatusException(HttpStatusCode status,
 @Nullable String reason,
 @Nullable Throwable cause)

Constructor with a response status and a reason to add to the exception message as explanation, as well as a nested exception.

Parameters:

status - the HTTP status (required)

reason - the associated reason (optional)

cause - a nested exception (optional)

ResponseStatusException

protected ResponseStatusException(HttpStatusCode status,
 @Nullable String reason,
 @Nullable Throwable cause,
 @Nullable String messageDetailCode,
 Object @Nullable [] messageDetailArguments)

Constructor with a message code and arguments for resolving the error "detail" via MessageSource.

Parameters:

status - the HTTP status (required)

reason - the associated reason (optional)

cause - a nested exception (optional)

Since:

6.0

Method Details

getReason

public @Nullable String getReason()

The reason explaining the exception (potentially null or empty).

getHeaders

public HttpHeaders getHeaders()

Return headers to add to the error response, for example, "Allow", "Accept", etc.

Specified by:

getHeaders in interface ErrorResponse

Overrides:

getHeaders in class ErrorResponseException

updateAndGetBody

public ProblemDetail updateAndGetBody(@Nullable MessageSource messageSource,
 Locale locale)

Description copied from interface: ErrorResponse

Use the given MessageSource to resolve the type, title, and detail message codes, and then use the resolved values to update the corresponding fields in ErrorResponse.getBody().

Parameters:

messageSource - the MessageSource to use for the lookup

locale - the Locale to use for the lookup

getMessage

public String getMessage()

Overrides:

getMessage in class ErrorResponseException