Сервлет Коды состояния HTTP
Формат сообщений HTTP-запроса и HTTP-ответа схож и имеет следующую структуру:
- Начальная строка состояния + возврат каретки и перевод строки (возврат каретки + перевод строки)
- Ноль или более строк заголовков + возврат каретки и перевод строки
- Пустая строка, т. е. возврат каретки и перевод строки
- Необязательное тело сообщения, например файл, данные запроса или выходные данные запроса
Например, заголовок ответа сервера выглядит следующим образом:
HTTP/1.1 200 OK Content-Type: text/html Header2: ... ... HeaderN: ... (Blank Line) <!doctype ...> <html> <head>...</head> <body> ... </body> </html>
Строка состояния включает версию HTTP (в этом примере HTTP/1.1), код состояния (в этом примере 200) и короткое сообщение, соответствующее коду состояния (в этом примере OK).
Ниже приведён список кодов состояния HTTP и связанной информации, которые может возвращать веб-сервер:
| Code | Сообщение | Описание |
|---|---|---|
| 100 | Continue | Сервер получил только часть запроса, но пока запрос не отклонён, клиент должен продолжить запрос. |
| 101 | Переключение протоколов | Сервер переключает протоколы. |
| 200 | ОК | Запрос выполнен успешно. |
| 201 | Создано | Запрос завершён и создаёт новый ресурс. |
| 202 | Принято | Запрос принят для обработки, но обработка не завершена. |
| 203 | Неавторитетная информация | |
| 204 | Нет содержимого | |
| 205 | Сброс содержимого | |
| 206 | Частичное содержимое | |
| 300 | Множественный выбор | Список ссылок. Пользователь может выбрать ссылку и перейти к этому расположению. До пяти адресов. |
| 301 | Перемещено навсегда | Запрошенная страница перемещена на новый URL. |
| 302 | Найдено | Запрошенная страница временно перемещена на новый URL. |
| 303 | Смотрите другое | Запрошенную страницу можно найти по другому URL. |
| 304 | Не изменено | |
| 305 | Использовать прокси | |
| 306 | Не используется | Этот код использовался в предыдущих версиях. Он больше не используется, но код всё ещё зарезервирован. |
| 307 | Временное перенаправление | Запрошенная страница временно перемещена на новый URL. |
| 400 | Некорректный запрос | Сервер не понимает запрос. |
| 401 | Не авторизован | Для запрошенной страницы требуются имя пользователя и пароль. |
| 402 | Требуется оплата | Вы пока не можете использовать этот код. |
| 403 | Запрещено | Доступ к запрошенной странице запрещён. |
| 404 | Не найдено | Сервер не может найти запрошенную страницу. |
| 405 | Метод не разрешён | Метод, указанный в запросе, не разрешён. |
| 406 | Неприемлемо | Сервер генерирует только ответ, который не принимается клиентом. |
| 407 | Требуется аутентификация прокси | Необходимо выполнить аутентификацию на прокси-сервере, прежде чем запрос будет доставлен. |
| 408 | Тайм-аут запроса | Запрос выполняется дольше, чем сервер может ждать; тайм-аут. |
| 409 | Конфликт | Не удалось выполнить запрос из-за конфликта. |
| 410 | Удалён | Запрошенная страница больше недоступна. |
| 411 | Требуется длина | "Content-Length" не определён. Сервер не может обработать информацию запроса, отправленную клиентом, без Content-Length. |
| 412 | Предварительное условие не выполнено | Предварительное условие, заданное в запросе, сервер оценивает как ложное. |
| 413 | Сущность запроса слишком велика | Сервер не принимает запрос, потому что сущность запроса слишком велика. |
| 414 | Слишком длинный Request-url | Сервер не принимает запрос, потому что URL слишком длинный. Это происходит, когда вы преобразуете запрос "post" в запрос "get" с длинной информацией запроса. |
| 415 | Неподдерживаемый тип медиа | Сервер не принимает запрос, потому что медиатип не поддерживается. |
| 417 | Ожидание не оправдалось | |
| 500 | Внутренняя ошибка сервера | Незавершённый запрос. Сервер столкнулся с непредвиденным условием. |
| 501 | Не реализовано | Незавершённый запрос. Сервер не поддерживает требуемую функциональность. |
| 502 | Плохой шлюз | Незавершённый запрос. Сервер получил недопустимый ответ от вышестоящего сервера. |
| 503 | Сервис недоступен | Незавершённый запрос. Сервер временно перегружен или недоступен. |
| 504 | Тайм-аут шлюза | Тайм-аут шлюза. |
| 505 | Версия HTTP не поддерживается | Сервер не поддерживает версию протокола HTTP. |
Методы установки кода состояния HTTP
Следующие методы можно использовать для установки кодов состояния HTTP в программе Servlet. Эти методы доступны через объектHttpServletResponse.
| Нет. | Метод и описание |
|---|---|
| 1 | public void setStatus ( int statusCode ) Этот метод устанавливает произвольный код состояния. Метод setStatus принимает int (код состояния) в качестве параметра. Если ваш ответ содержит специальный код состояния и документ, убедитесь, что вызвали setStatus перед тем, какPrintWriterфактически вернёт любое содержимое. |
| 2 | public void sendRedirect(String url) Этот метод генерирует ответ 302 вместе с заголовкомLocationс URL нового документа. |
| 3 | public void sendError(int code, String message) Этот метод отправляет код состояния (обычно 404) вместе с коротким сообщением, автоматически форматируемым внутри HTML-документа и отправляемым клиенту. |
Пример кода состояния HTTP
Следующий пример отправляет код ошибки 407 в браузер клиента, и браузер отобразит сообщение "Требуется аутентификация!!!".
// 导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
import javax.servlet.annotation.WebServlet;
@WebServlet("/showError")
// 扩展 HttpServlet 类
public class showError extends HttpServlet {
// 处理 GET 方法请求的方法
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置错误代码和原因
response.sendError(407, "Need authentication!!!" );
}
// 处理 POST 方法请求的方法
public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
Теперь вызов вышеуказанного сервлета отобразит следующий результат:
HTTP-статус 407 - Требуется аутентификация!!!тип Отчёт о состоянии сообщение Требуется аутентификация!!! описание Клиент должен сначала пройти аутентификацию на прокси-сервере (Требуется аутентификация!!!). Apache Tomcat/5.5.29 |