Обработка HTTP-ошибок 404, 500, 503 в Spring MVC

Обязательным условием любого уважающего себя сайта является корректная обработка HTTP-ошибок, а не отображения вместо них стандартной страницы с информацией об ошибке и ее описанием в стандартном для языка Java вида. В этой серии статей описывается несколько способов обработки как HTTP-ошибок, так и исключений. В конце статьи будет приведен исходник приложения, демонстрирующего/ обработку ошибок и исключений.

Также иногда появляются ситуации, когда веб-сервер обязан возвращать только код ошибки без какой-либо дополнительной информации. В этой ситуации также необходимо отлавливать HTTP-ошибки.

Если Вы знакомы с спецификацией сервлетов, то уже знаете, что контейнеры сервлетов могут обрабатывать исключения и HTTP-ошибки, используя простую конфигурацию в файле web.xml. Эта конфигурация может выглядеть следующим образом:

<!-- HTTP-error -->
<error-page>
<error-code>404</error-code>
<location>page-not-found.jsp</location>
</error-page>

<!-- Exception -->
<error-page>
<exception-type>java.lang.Exception</exception-type>
<location>uncaught-error.jsp</location>
</error-page>

Разберемся для начала, в чём разница между HTTP-ошибкой и исключениями.

HTTP-ошибки - это ошибки, которые описаны спецификацией RFC2616 и не являются исключением как таковым. Spring не отлавливает подобные ошибки, но есть возможность генерировать любую из них, используя код, подобный приведенному ниже:

HttpServletResponse response
// ... some code
response.sendError( httpErrorCode );

Ниже список возможных HTTP-ошибок (наиболее известные из них: 404, 500, 501, 503.):

• 400 - Bad Request
• 401 - Unauthorized
• 402 - Payment Required
• 403 - Forbidden
• 404 - Not Found
• 405 - Method Not Allowed
• 406 - Not Acceptable
• 407 - Proxy Authentication Required
• 408 - Request Time-out
• 409 - Conflict
• 410 - Gone
• 411 - Length Required
• 412 - Precondition Failed
• 413 - Request Entity Too Large
• 414 - Request-URI Too Large
• 415 - Unsupported Media Type
• 416 - Requested range not satisfiable
• 417 - Expectation Failed
• 500 - Internal Server Error
• 501 - Not Implemented
• 502 - Bad Gateway
• 503 - Service Unavailable
• 504 - Gateway Time-out
• 505 - HTTP Version not supported

Исключения (Exception) - второй тип ошибок, который можно указать в файле web.xml. В отличии от HTTP-ошибок, контейнер сервлетов возвращает страницу в случае если получено указанное исключение (в примере - java.lang.Exception), а не ошибка HTTP протокола.

Несколько причин, почему стоит использовать Spring при обработке ошибок:

• При использовании контейнера сервлетов нет комфортной среды для использования бизнес-логики. Конечно, есть возможность писать бизнес-логику прямо в jsp-файле, но так делать строго не рекомендуется. При использовании Spring есть возможность писать код вне jsp-файлов при возникновении ошибок. Также Вы можете свободно использовать логирование и любые аналитические и статистические операции
• При использовании контейнера сервлетов не выполняются фильтры. Контейнер сервлетов обходит фильтры если происходит ошибка. Со Spring такого не происходит.
• Мощность Spring-фреймворка. Если ошибки будут обрабатываться с помощью Spring MVC, то можно воспользоваться всеми преимуществами фреймворка Spring.
• Строгий код. В том смысле, что раз уж начали писать код с использованием фреймворка Spring MVC, то логично будет если весь сайт будет написан на нем

В следующих трёх статьях будет описано три способа обработки ошибок:

• С помощью аннотации @ExceptionHandler;
• Используя SimpleMappingExceptionResolver;
• И обработка ошибок HTTP-протокола (404, 500, 501 и т.д.);