Servlets - Códigos de estado HTTP
El formato de la solicitud HTTP y los mensajes de respuesta HTTP son similares y tendrán la siguiente estructura:
Una línea de estado inicial + CRLF (retorno de carro + salto de línea, es decir, nueva línea)
Cero o más líneas de encabezado + CRLF
Una línea en blanco, es decir, un CRLF
Un cuerpo de mensaje opcional como archivo, datos de consulta o salida de consulta.
Por ejemplo, un encabezado de respuesta del servidor tiene el siguiente aspecto:
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 consta de la versión HTTP (HTTP / 1.1 en el ejemplo), un código de estado (200 en el ejemplo) y un mensaje muy corto correspondiente al código de estado (OK en el ejemplo).
A continuación se muestra una lista de códigos de estado HTTP y mensajes asociados que pueden devolverse desde el servidor web:
| Código | Mensaje | Descripción |
|---|---|---|
| 100 | Seguir | El servidor solo ha recibido una parte de la solicitud, pero mientras no haya sido rechazada, el cliente debe continuar con la solicitud. |
| 101 | Protocolos de conmutación | El servidor cambia de protocolo. |
| 200 | Okay | La solicitud está bien |
| 201 | Creado | La solicitud está completa y se crea un nuevo recurso |
| 202 | Aceptado | La solicitud se acepta para su procesamiento, pero el procesamiento no está completo. |
| 203 | Información no autorizada | |
| 204 | Sin contenido | |
| 205 | Restablecer contenido | |
| 206 | Contenido parcial | |
| 300 | Múltiples opciones | Una lista de enlaces. El usuario puede seleccionar un enlace e ir a esa ubicación. Máximo cinco direcciones |
| 301 | Movido permanentemente | La página solicitada se ha movido a una nueva URL. |
| 302 | Encontró | La página solicitada se ha movido temporalmente a una nueva URL. |
| 303 | Ver otros | La página solicitada se puede encontrar en una URL diferente |
| 304 | No modificado | |
| 305 | Usa proxy | |
| 306 | No usado | Este código se utilizó en una versión anterior. Ya no se usa, pero el código está reservado |
| 307 | Redireccionamiento temporal | La página solicitada se ha movido temporalmente a una nueva URL. |
| 400 | Solicitud incorrecta | El servidor no entendió la solicitud. |
| 401 | No autorizado | La página solicitada necesita un nombre de usuario y una contraseña |
| 402 | pago requerido | Todavía no puedes usar este código |
| 403 | Prohibido | Prohibido el acceso a la página solicitada |
| 404 | Extraviado | El servidor no puede encontrar la página solicitada. |
| 405 | Método no permitido | El método especificado en la solicitud no está permitido. |
| 406 | Inaceptable | El servidor solo puede generar una respuesta que no es aceptada por el cliente. |
| 407 | Se requiere autenticación proxy | Debe autenticarse con un servidor proxy antes de que se pueda atender esta solicitud. |
| 408 | Pide tiempo fuera | La solicitud tardó más de lo que el servidor estaba preparado para esperar. |
| 409 | Conflicto | La solicitud no se pudo completar debido a un conflicto. |
| 410 | Ido | La página solicitada ya no está disponible. |
| 411 | Longitud requerida | La "Longitud del contenido" no está definida. El servidor no aceptará la solicitud sin ella. |
| 412 | Condición previa Falló | La condición previa dada en la solicitud evaluada como falsa por el servidor. |
| 413 | Solicitar entidad demasiado grande | El servidor no aceptará la solicitud porque la entidad de la solicitud es demasiado grande. |
| 414 | URL de solicitud demasiado larga | El servidor no aceptará la solicitud porque la URL es demasiado larga. Ocurre cuando convierte una solicitud de "publicación" en una solicitud de "obtención" con una información de consulta larga. |
| 415 | Tipo de papel no admitido | El servidor no aceptará la solicitud porque el tipo de medio no es compatible. |
| 417 | Expectativa fallida | |
| 500 | error de servidor interno | La solicitud no se completó. El servidor se encontró con una condición inesperada. |
| 501 | No se ha implementado | La solicitud no se completó. El servidor no admitía la funcionalidad requerida. |
| 502 | Puerta de enlace incorrecta | La solicitud no se completó. El servidor recibió una respuesta no válida del servidor ascendente. |
| 503 | Servicio no disponible | La solicitud no se completó. El servidor se está sobrecargando o cayendo temporalmente. |
| 504 | Tiempo de espera de puerta de enlace | Se agotó el tiempo de espera de la puerta de enlace. |
| 505 | Versión HTTP no compatible | El servidor no admite la versión "protocolo http". |
Métodos para establecer el código de estado HTTP
Los siguientes métodos se pueden utilizar para configurar el código de estado HTTP en su programa de servlet. Estos métodos están disponibles con el objeto HttpServletResponse .
| No Señor. | Método y descripción |
|---|---|
| 1 | public void setStatus ( int statusCode ) Este método establece un código de estado arbitrario. El método setStatus toma un int (el código de estado) como argumento. Si su respuesta incluye un código de estado especial y un documento, asegúrese de llamar a setStatus antes de devolver el contenido con PrintWriter . |
| 2 | public void sendRedirect(String url) Este método genera una respuesta 302 junto con un encabezado de ubicación que proporciona la URL del nuevo documento |
| 3 | public 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ódigo de estado HTTP
El siguiente es el ejemplo que enviaría un código de error 407 al navegador del cliente y el navegador le mostraría "¡Necesita autenticación!" mensaje.
// Import required java libraries
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
// Extend HttpServlet class
public class showError extends HttpServlet {
// Method to handle GET method request.
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
// Set error code and reason.
response.sendError(407, "Need authentication!!!" );
}
// Method to handle POST method request.
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}Ahora llamar al servlet anterior mostraría el siguiente resultado:
HTTP Status 407 - Need authentication!!!
type Status report
messageNeed authentication!!!
descriptionThe client must first authenticate itself with the proxy (Need authentication!!!).
Apache Tomcat/5.5.29