Сервлет Коды состояния 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.

Нет.Метод и описание
1public void setStatus ( int statusCode )
Этот метод устанавливает произвольный код состояния. Метод setStatus принимает int (код состояния) в качестве параметра. Если ваш ответ содержит специальный код состояния и документ, убедитесь, что вызвали setStatus перед тем, какPrintWriterфактически вернёт любое содержимое.
2public void sendRedirect(String url)
Этот метод генерирует ответ 302 вместе с заголовкомLocationс URL нового документа.
3public 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

Другие расширения