Package org.springframework.web.servlet

Class NoHandlerFoundException

java.lang.Object

java.lang.Throwable

java.lang.Exception

jakarta.servlet.ServletException

org.springframework.web.servlet.NoHandlerFoundException

All Implemented Interfaces:

Serializable, ErrorResponse

public class NoHandlerFoundException
extends ServletException
implements ErrorResponse

By default, when the DispatcherServlet can't find a handler for a request it sends a 404 response. However, if its property "throwExceptionIfNoHandlerFound" is set to true this exception is raised and may be handled with a configured HandlerExceptionResolver.

Since:

4.0

Author:

Brian Clozel

See Also:

• DispatcherServlet.setThrowExceptionIfNoHandlerFound(boolean)
• DispatcherServlet.noHandlerFound(HttpServletRequest, HttpServletResponse)
• Serialized Form

Nested Class Summary

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

ErrorResponse.Builder

Constructor Summary

Constructors

Constructor	Description
NoHandlerFoundException(String httpMethod, String requestURL, HttpHeaders headers)	Constructor for NoHandlerFoundException.

Method Summary

Modifier and Type	Method	Description
ProblemDetail	getBody()	Return the body for the response, formatted as an RFC 7807 ProblemDetail whose status should match the response status.
HttpHeaders	getHeaders()	Return headers to use for the response.
String	getHttpMethod()
HttpHeaders	getRequestHeaders()	Return the headers of the request.
String	getRequestURL()
HttpStatusCode	getStatusCode()	Return the HTTP status code to use for the response.

Methods inherited from class jakarta.servlet.ServletException

getRootCause

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, 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, getDetailMessageArguments, getDetailMessageCode, getTitleMessageCode, updateAndGetBody

Constructor Details

NoHandlerFoundException

public NoHandlerFoundException(String httpMethod,
 String requestURL,
 HttpHeaders headers)

Constructor for NoHandlerFoundException.

Parameters:

httpMethod - the HTTP method

requestURL - the HTTP request URL

headers - the HTTP request headers

Method Details

getStatusCode

public HttpStatusCode getStatusCode()

Description copied from interface: ErrorResponse

Return the HTTP status code to use for the response.

Specified by:

getStatusCode in interface ErrorResponse

getHttpMethod

public String getHttpMethod()

getRequestURL

public String getRequestURL()

getHeaders

public HttpHeaders getHeaders()

Return headers to use for the response.

Note: As of 6.0 this method overlaps with ErrorResponse.getHeaders() and therefore no longer returns request headers. Use getRequestHeaders() instead for request headers.

Specified by:

getHeaders in interface ErrorResponse

getRequestHeaders

public HttpHeaders getRequestHeaders()

Return the headers of the request.

Since:

6.0.3

getBody

public ProblemDetail getBody()

Description copied from interface: ErrorResponse

Return the body for the response, formatted as an RFC 7807 ProblemDetail whose status should match the response status.

Note: The returned ProblemDetail may be updated before the response is rendered, e.g. via ErrorResponse.updateAndGetBody(MessageSource, Locale). Therefore, implementing methods should use an instance field, and should not re-create the ProblemDetail on every call, nor use a static variable.

Specified by:

getBody in interface ErrorResponse