Search code examples
javahttptomcatservletshttpresponse

Disable all default HTTP error response content in Tomcat


By default, Tomcat sends some HTML content back to the client if it encounters something like an HTTP 404. I know that via web.xml an <error-page> can be configured to customize this content.

However, I'd just like for Tomcat to not send anything in terms of response content (I'd still like the status code, of course). Is there any way to easily configure this?

I'm trying to avoid A) explicitly sending empty content on the response stream from my Servlet, and B) configuring custom error pages for a whole bunch of HTTP error statuses in my web.xml.

For some background, I'm developing an HTTP API and am controlling my own response content. So for an HTTP 500, for example, I'm populating some XML content on the response containing error information. For situations like an HTTP 404, the HTTP response status is sufficient for clients, and the content tomcat is sending is unnecessary. If there's a different approach, I'm open to hearing it.

Edit: After continued investigation, I still can't find much in the way of a solution. If someone can definitively say this is not possible, or provide a resource with evidence that it will not work, I'll accept that as an answer and try and work around it.


Solution

  • If you do not want tomcat to show an error page, do not use sendError(...). Instead, use setStatus(...).

    e.g. if you want to give a 405 response, then you do

    response.setStatus(HttpServletResponse.SC_METHOD_NOT_ALLOWED);      
    response.getWriter().println("The method " + request.getMethod() + 
       " is not supported by this service.");
    

    Also, remember not to throw any Exceptions from your servlet. Instead, catch the Exception and, again, set the statusCode yourself.

    i.e.

    protected void service(HttpServletRequest request,
          HttpServletResponse response) throws IOException {
      try {
    
        // servlet code here, e.g. super.service(request, response);
    
      } catch (Exception e) {
        // log the error with a timestamp, show the timestamp to the user
        long now = System.currentTimeMillis();
        log("Exception " + now, e);
        response.setStatus(HttpServletResponse.SC_INTERNAL_SERVER_ERROR);
        response.getWriter().println("Guru meditation: " + now);
      }
    }
    

    Of course, if you do not want any content, just don't write anything to the writer, and just set the status.