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:

EncabezadoDescripción
AllowEste encabezado especifica los métodos de solicitud compatibles con el servidor (GET, POST, etc.).
Cache-ControlEste 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é.
ConnectionEste 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-DispositionEste encabezado le permite solicitar al navegador que pida al usuario guardar la respuesta en el disco con un archivo de nombre determinado.
Content-EncodingEste encabezado especifica la codificación de la página durante la transmisión.
Content-LanguageEste encabezado indica el idioma utilizado para redactar el documento. Por ejemplo, en, en-us, ru, etc.
Content-LengthEste 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-TypeEste encabezado proporciona el tipo MIME (Multipurpose Internet Mail Extension) del documento de respuesta.
ExpiresEste encabezado especifica el tiempo en que el contenido caduca, después del cual el contenido ya no se almacena en caché.
Last-ModifiedEste 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.
LocationEste 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.
RefreshEste 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-AfterEste 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-CookieEste 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
1String 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.
2String 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.
3boolean containsHeader(String name)
Devuelve un valor booleano que indica si ya se ha configurado el encabezado de respuesta nombrado.
4boolean isCommitted()
Devuelve un valor booleano que indica si la respuesta ya ha sido enviada.
5void addCookie(Cookie cookie)
Agrega la cookie especificada a la respuesta.
6void addDateHeader(String name, long date)
Agrega un encabezado de respuesta con el nombre y el valor de fecha dados.
7void addHeader(String name, String value)
Agrega un encabezado de respuesta con el nombre y el valor dados.
8void addIntHeader(String name, int value)
Agrega un encabezado de respuesta con el nombre y el valor entero dados.
9void flushBuffer()
Fuerza que cualquier contenido en el búfer se escriba en el cliente.
10void reset()
Limpia cualquier dato presente en el búfer, incluidos el código de estado y los encabezados.
11void resetBuffer()
Limpia el contenido del búfer subyacente en la respuesta, sin borrar el código de estado ni los encabezados.
12void sendError(int sc)
Envía una respuesta de error al cliente con el código de estado especificado y limpia el búfer.
13void sendError(int sc, String msg)
Envía una respuesta de error al cliente con el estado especificado.
14void sendRedirect(String location)
Envía una respuesta de redirección temporal al cliente con la URL de ubicación de redirección especificada.
15void setBufferSize(int size)
Establece el tamaño preferido del búfer para el cuerpo de la respuesta.
16void setCharacterEncoding(String charset)
Establece la codificación de caracteres (juego de caracteres MIME) de la respuesta enviada al cliente, por ejemplo, UTF-8.
17void 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.
18void setContentType(String type)
Si la respuesta aún no ha sido enviada, establece el tipo de contenido de la respuesta enviada al cliente.
19void setDateHeader(String name, long date)
Establece un encabezado de respuesta con el nombre y el valor de fecha dados.
20void setHeader(String name, String value)
Establece un encabezado de respuesta con el nombre y el valor dados.
21void setIntHeader(String name, int value)
Establece un encabezado de respuesta con el nombre y el valor entero dados.
22void setLocale(Locale loc)
Si la respuesta aún no ha sido enviada, establece el locale (región) de la respuesta.
23void 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:

Otras extensiones