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. |
| 400 | Bad 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 | |
| 500 | Internal 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 |
|---|---|
| 1 | public 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. |
| 2 | public void sendRedirect(String url) Este método genera una respuesta 302, junto con unLocationencabezado que contiene 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ó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 |