Servlet Códigos de estado HTTP

Los formatos de los mensajes de solicitud HTTP y respuesta HTTP son similares, con la siguiente estructura:

  • Línea de estado inicial + retorno de carro y avance de línea (retorno + nueva línea)
  • Cero o más líneas de encabezado + retorno de carro y avance de línea
  • Una línea en blanco, es decir, retorno de carro y avance de línea
  • Un cuerpo de mensaje opcional, como un archivo, datos de consulta o salida de consulta

Por ejemplo, el encabezado de respuesta del servidor se muestra a continuación:

HTTP/1.1 200 OK
Content-Type: text/html
Header2: ...
...
HeaderN: ...
  (Blank Line)
<!doctype ...>
<html>
<head>...</head>
<body>
...
</body>
</html>

La línea de estado incluye la versión HTTP (HTTP/1.1 en este ejemplo), un código de estado (200 en este ejemplo) y un mensaje corto correspondiente al código de estado (OK en este ejemplo).

La siguiente es una lista de códigos de estado HTTP y la información relacionada que pueden devolverse desde un servidor web:

Código Mensaje Descripción
100 Continue Solo una parte de la solicitud ha sido recibida por el servidor, pero mientras no haya sido rechazada, el cliente debe continuar con la solicitud.
101 Switching Protocols El servidor cambia de protocolo.
200 OK Solicitud exitosa.
201 Created La solicitud es completa y crea un nuevo recurso.
202 Accepted La solicitud ha sido aceptada para procesamiento, pero el procesamiento está incompleto.
203 Non-authoritative Information  
204 No Content  
205 Reset Content  
206 Partial Content  
300 Multiple Choices Lista de enlaces. El usuario puede seleccionar un enlace para ir a esa ubicación. Hasta cinco direcciones.
301 Moved Permanently La página solicitada se ha movido a una nueva URL.
302 Found La página solicitada se ha movido temporalmente a una nueva URL.
303 See Other La página solicitada se puede encontrar en una URL diferente.
304 Not Modified  
305 Use Proxy  
306 Unused Este código se usaba en versiones anteriores. Ya no se utiliza, pero el código se conserva.
307 Temporary Redirect La página solicitada se ha movido temporalmente a una nueva URL.
400Bad Request El servidor no entiende la solicitud.
401 Unauthorized La página solicitada requiere nombre de usuario y contraseña.
402 Payment Required Aún no puede utilizar este código.
403 Forbidden Prohibido el acceso a la página solicitada.
404 Not Found El servidor no puede encontrar la página solicitada.
405 Method Not Allowed El método especificado en la solicitud no está permitido.
406 Not Acceptable El servidor solo genera una respuesta que el cliente no acepta.
407 Proxy Authentication Required Debe utilizar la autenticación de un servidor proxy antes de que se entregue la solicitud.
408 Request Timeout La solicitud tarda más tiempo del que el servidor puede esperar, se agota el tiempo.
409 Conflict La solicitud no se puede completar debido a un conflicto.
410 Gone La página solicitada ya no está disponible.
411 Length Required 'Content-Length' no está definido. El servidor no puede procesar la información de solicitud enviada por el cliente sin Content-Length.
412 Precondition Failed Las condiciones previas dadas en la solicitud son evaluadas como falsas por el servidor.
413 Request Entity Too Large El servidor no acepta la solicitud porque la entidad de la solicitud es demasiado grande.
414 Request-url Too Long El servidor no acepta la solicitud porque la URL es demasiado larga. Esto ocurre cuando convierte una solicitud 'post' en una solicitud 'get' con información de consulta larga.
415 Unsupported Media Type El servidor no acepta la solicitud porque el tipo de medio no es compatible.
417 Expectation Failed  
500Internal Server Error Solicitud no completada. El servidor encontró una situación inesperada.
501 Not Implemented Solicitud no completada. El servidor no admite la funcionalidad requerida.
502 Bad Gateway Solicitud no completada. El servidor recibió una respuesta no válida de un servidor ascendente.
503 Service Unavailable Solicitud no completada. El servidor está temporalmente sobrecargado o caído.
504 Gateway Timeout Tiempo de espera de la puerta de enlace.
505 HTTP Version Not Supported El servidor no admite la versión del protocolo HTTP.

Métodos para configurar códigos de estado HTTP

Los siguientes métodos se pueden utilizar para configurar códigos de estado HTTP en programas Servlet. Estos métodos están disponibles a través delHttpServletResponseobjeto.

N.ºMétodo & descripción
1public void setStatus ( int statusCode )
Este método establece un código de estado arbitrario. El método setStatus acepta un int (código de estado) como parámetro. Si su respuesta contiene un código de estado y un documento especiales, asegúrese dePrintWriterllamar a setStatus antes de devolver cualquier contenido real.
2public void sendRedirect(String url)
Este método genera una respuesta 302, junto con unLocationencabezado que contiene la URL del nuevo documento.
3public void sendError(int code, String message)
Este método envía un código de estado (generalmente 404), junto con un mensaje corto que se formatea automáticamente dentro de un documento HTML y se envía al cliente.

Ejemplo de códigos de estado HTTP

El siguiente ejemplo envía el código de error 407 al navegador del cliente, el navegador mostrará el mensaje 'Need authentication!!!'.

// 导入必需的 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);
  }
}

Ahora, invocar el Servlet anterior mostrará el siguiente resultado:

HTTP Status 407 - Need authentication!!!

type Status report

message Need authentication!!!

description The client must first authenticate itself with the proxy (Need authentication!!!).

Apache Tomcat/5.5.29

Otras extensiones