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.server.ResponseStatusException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

MediaTypeNotSupportedStatusException, MethodNotAllowedException, NotAcceptableStatusException, ServerErrorException, ServerWebInputException, UnsupportedMediaTypeStatusException

public class ResponseStatusException
extends NestedRuntimeException

Base class for exceptions associated with specific HTTP response status codes.

Since:

5.0

Author:

Rossen Stoyanchev, Juergen Hoeller

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	reason
private HttpStatus	status

Constructor Summary

Constructors

Constructor and Description
ResponseStatusException(HttpStatus status) Constructor with a response status.
ResponseStatusException(HttpStatus status, java.lang.String reason) Constructor with a response status and a reason to add to the exception message as explanation.
ResponseStatusException(HttpStatus status, java.lang.String reason, java.lang.Throwable cause) Constructor with a response status and a reason to add to the exception message as explanation, as well as a nested exception.

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.String>	getHeaders() Deprecated. as of 5.1.13 in favor of getResponseHeaders()
java.lang.String	getMessage() Return the detail message, including the message from the nested exception if there is one.
java.lang.String	getReason() The reason explaining the exception (potentially null or empty).
HttpHeaders	getResponseHeaders() Return headers associated with the exception that should be added to the error response, e.g.
HttpStatus	getStatus() Return the HTTP status associated with this exception.

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

Field Detail

status

private final HttpStatus status

reason

@Nullable
private final java.lang.String reason

Constructor Detail

ResponseStatusException

public ResponseStatusException(HttpStatus status)

Constructor with a response status.

Parameters:

status - the HTTP status (required)

ResponseStatusException

public ResponseStatusException(HttpStatus status,
                               @Nullable
                               java.lang.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(HttpStatus status,
                               @Nullable
                               java.lang.String reason,
                               @Nullable
                               java.lang.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)

Method Detail

getStatus

public HttpStatus getStatus()

Return the HTTP status associated with this exception.

getHeaders

@Deprecated
public java.util.Map<java.lang.String,java.lang.String> getHeaders()

Deprecated. as of 5.1.13 in favor of getResponseHeaders()

Return headers associated with the exception that should be added to the error response, e.g. "Allow", "Accept", etc.

The default implementation in this class returns an empty map.

Since:

5.1.11

getResponseHeaders

public HttpHeaders getResponseHeaders()

Return headers associated with the exception that should be added to the error response, e.g. "Allow", "Accept", etc.

The default implementation in this class returns empty headers.

Since:

5.1.13

getReason

@Nullable
public java.lang.String getReason()

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

getMessage

public java.lang.String getMessage()

Description copied from class: NestedRuntimeException

Return the detail message, including the message from the nested exception if there is one.

Overrides:

getMessage in class NestedRuntimeException