Servlet Respuesta HTTP del servidor
Como se discutió en los capítulos anteriores, cuando un servidor web responde a una solicitud HTTP, la respuesta generalmente incluye una línea de estado, algunos encabezados de respuesta, una línea en blanco y el documento. Una respuesta típica 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 caso) y un mensaje corto correspondiente al código de estado (OK en este caso).
La siguiente tabla resume los encabezados de respuesta HTTP 1.1 más útiles que se devuelven del servidor web al navegador, y los usará con frecuencia en la programación web:
| Encabezado | Descripción |
|---|---|
| Allow | Este encabezado especifica los métodos de solicitud compatibles con el servidor (GET, POST, etc.). |
| Cache-Control | Este encabezado especifica en qué circunstancias el documento de respuesta puede almacenarse en caché de forma segura. Los valores posibles son:public、privateono-cacheetc. Public significa que el documento se puede almacenar en caché, Private significa que el documento es un documento privado para un solo usuario y solo puede almacenarse en caché privada (no compartida), y no-cache significa que el documento no debe almacenarse en caché. |
| Connection | Este encabezado indica si el navegador utiliza una conexión HTTP persistente. El valorcloseindica que el navegador no utiliza una conexión HTTP persistente, el valorkeep-alivesignifica que se utiliza una conexión persistente. |
| Content-Disposition | Este encabezado le permite solicitar al navegador que pida al usuario guardar la respuesta en el disco con un archivo de nombre determinado. |
| Content-Encoding | Este encabezado especifica la codificación de la página durante la transmisión. |
| Content-Language | Este encabezado indica el idioma utilizado para redactar el documento. Por ejemplo, en, en-us, ru, etc. |
| Content-Length | Este encabezado indica el número de bytes en la respuesta. Esta información solo es necesaria cuando el navegador utiliza una conexión HTTP persistente (keep-alive). |
| Content-Type | Este encabezado proporciona el tipo MIME (Multipurpose Internet Mail Extension) del documento de respuesta. |
| Expires | Este encabezado especifica el tiempo en que el contenido caduca, después del cual el contenido ya no se almacena en caché. |
| Last-Modified | Este encabezado indica la hora de última modificación del documento. Luego, el cliente puede almacenar el archivo en caché y, en solicitudes posteriores, medianteIf-Modified-Sinceun encabezado de solicitud proporciona una fecha. |
| Location | Este encabezado debe incluirse en todas las respuestas con códigos de estado. En el caso de los códigos 3xx, esto notifica al navegador la dirección del documento. El navegador se reconectará automáticamente a esta ubicación y obtendrá el nuevo documento. |
| Refresh | Este encabezado especifica cómo el navegador debe solicitar una página actualizada lo antes posible. Puede especificar los segundos para que la página se actualice. |
| Retry-After | Este encabezado se puede utilizar junto con la respuesta 503 (Service Unavailable - Servicio no disponible), lo que indica al cliente cuánto tiempo debe esperar antes de repetir su solicitud. |
| Set-Cookie | Este encabezado especifica una cookie asociada con la página. |
Métodos para configurar los encabezados de respuesta HTTP
Los siguientes métodos se pueden utilizar para configurar los encabezados de respuesta HTTP en un programa Servlet. Estos métodos están disponibles a través delHttpServletResponseobjeto.
| N.º | Método & Descripción |
|---|---|
| 1 | String encodeRedirectURL(String url) Codifica la URL especificada utilizada en el método sendRedirect, o si la codificación no es necesaria, devuelve la URL sin cambios. |
| 2 | String encodeURL(String url) Codifica la URL especificada que contiene el ID de sesión, o si la codificación no es necesaria, devuelve la URL sin cambios. |
| 3 | boolean containsHeader(String name) Devuelve un valor booleano que indica si ya se ha configurado el encabezado de respuesta nombrado. |
| 4 | boolean isCommitted() Devuelve un valor booleano que indica si la respuesta ya ha sido enviada. |
| 5 | void addCookie(Cookie cookie) Agrega la cookie especificada a la respuesta. |
| 6 | void addDateHeader(String name, long date) Agrega un encabezado de respuesta con el nombre y el valor de fecha dados. |
| 7 | void addHeader(String name, String value) Agrega un encabezado de respuesta con el nombre y el valor dados. |
| 8 | void addIntHeader(String name, int value) Agrega un encabezado de respuesta con el nombre y el valor entero dados. |
| 9 | void flushBuffer() Fuerza que cualquier contenido en el búfer se escriba en el cliente. |
| 10 | void reset() Limpia cualquier dato presente en el búfer, incluidos el código de estado y los encabezados. |
| 11 | void resetBuffer() Limpia el contenido del búfer subyacente en la respuesta, sin borrar el código de estado ni los encabezados. |
| 12 | void sendError(int sc) Envía una respuesta de error al cliente con el código de estado especificado y limpia el búfer. |
| 13 | void sendError(int sc, String msg) Envía una respuesta de error al cliente con el estado especificado. |
| 14 | void sendRedirect(String location) Envía una respuesta de redirección temporal al cliente con la URL de ubicación de redirección especificada. |
| 15 | void setBufferSize(int size) Establece el tamaño preferido del búfer para el cuerpo de la respuesta. |
| 16 | void setCharacterEncoding(String charset) Establece la codificación de caracteres (juego de caracteres MIME) de la respuesta enviada al cliente, por ejemplo, UTF-8. |
| 17 | void setContentLength(int len) Establece la longitud del cuerpo del contenido en la respuesta HTTP de Servlet; este método establece el encabezado HTTP Content-Length. |
| 18 | void setContentType(String type) Si la respuesta aún no ha sido enviada, establece el tipo de contenido de la respuesta enviada al cliente. |
| 19 | void setDateHeader(String name, long date) Establece un encabezado de respuesta con el nombre y el valor de fecha dados. |
| 20 | void setHeader(String name, String value) Establece un encabezado de respuesta con el nombre y el valor dados. |
| 21 | void setIntHeader(String name, int value) Establece un encabezado de respuesta con el nombre y el valor entero dados. |
| 22 | void setLocale(Locale loc) Si la respuesta aún no ha sido enviada, establece el locale (región) de la respuesta. |
| 23 | void setStatus(int sc) Establece el código de estado para la respuesta. |
Ejemplo de respuesta con encabezados HTTP
Ya ha visto el método setContentType() en los ejemplos anteriores; el siguiente ejemplo también utiliza el mismo método. Además, usaremos elsetIntHeader()método para establecer elRefreshencabezado.
//导入必需的 java 库
import java.io.IOException;
import java.io.PrintWriter;
import java.text.SimpleDateFormat;
import java.util.Calendar;
import java.util.Date;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/Refresh")
//扩展 HttpServlet 类
public class Refresh extends HttpServlet {
// 处理 GET 方法请求的方法
public void doGet(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException
{
// 设置刷新自动加载时间为 5 秒
response.setIntHeader("Refresh", 5);
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
//使用默认时区和语言环境获得一个日历
Calendar cale = Calendar.getInstance();
//将Calendar类型转换成Date类型
Date tasktime=cale.getTime();
//设置日期输出的格式
SimpleDateFormat df=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
//格式化输出
String nowTime = df.format(tasktime);
PrintWriter out = response.getWriter();
String title = "自动刷新 Header 设置 - Ejemplo实例";
String docType =
"<!DOCTYPE html>\n";
out.println(docType +
"<html>\n" +
"<head><title>" + title + "</title></head>\n"+
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + title + "</h1>\n" +
"<p>当前时间是:" + nowTime + "</p>\n");
}
// 处理 POST 方法请求的方法
public void doPost(HttpServletRequest request,
HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
El ejemplo de prueba anterior se encuentra en el proyecto TomcatTest, y la configuración correspondiente de web.xml es:
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<!-- 类名 -->
<servlet-name>Refresh</servlet-name>
<!-- 所在的包 -->
<servlet-class>com.ejemplo.test.Refresh</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Refresh</servlet-name>
<!-- 访问的网址 -->
<url-pattern>/TomcatTest/Refresh</url-pattern>
</servlet-mapping>
</web-app>
Ahora, invoque el Servlet anterior, que mostrará la hora actual del sistema cada 5 segundos. Simplemente ejecute el Servlet y espere un momento para ver el siguiente resultado:
