Interface HttpRequestHandler

Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface HttpRequestHandler
Plain handler interface for components that process HTTP requests, analogous to a Servlet. Only declares ServletException and IOException, to allow for usage within any HttpServlet. This interface is essentially the direct equivalent of an HttpServlet, reduced to a central handle method.

The easiest way to expose an HttpRequestHandler bean in Spring style is to define it in Spring's root web application context and define an HttpRequestHandlerServlet in web.xml, pointing to the target HttpRequestHandler bean through its servlet-name which needs to match the target bean name.

Supported as a handler type within Spring's

invalid reference 
org.springframework.web.servlet.DispatcherServlet
, being able to interact with the dispatcher's advanced mapping and interception facilities. This is the recommended way of exposing an HttpRequestHandler, while keeping the handler implementations free of direct dependencies on a DispatcherServlet environment.

Typically implemented to generate binary responses directly, with no separate view resource involved. This differentiates it from a

invalid reference 
org.springframework.web.servlet.mvc.Controller
within Spring's Web MVC framework. The lack of a
invalid reference 
org.springframework.web.servlet.ModelAndView
return value gives a clearer signature to callers other than the DispatcherServlet, indicating that there will never be a view to render.
Since:
2.0
Author:
Juergen Hoeller
See Also:
  • HttpRequestHandlerServlet
  • invalid reference 
    org.springframework.web.servlet.DispatcherServlet
  • invalid reference 
    org.springframework.web.servlet.ModelAndView
  • invalid reference 
    org.springframework.web.servlet.mvc.Controller
  • invalid reference 
    org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    handleRequest(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)
    Process the given request, generating a response.

  • Method Details

    • handleRequest

      void handleRequest(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response) throws jakarta.servlet.ServletException, IOException
      Process the given request, generating a response.
      Parameters:
      request - current HTTP request
      response - current HTTP response
      Throws:
      jakarta.servlet.ServletException - in case of general errors
      IOException - in case of I/O errors