Servlet Solicitud HTTP del cliente
Cuando el navegador solicita una página web, envía información específica al servidor web; esta información no puede leerse directamente porque se transmite como parte de las cabeceras de la solicitud HTTP. Puede consultarel protocolo HTTPpara obtener más información relacionada.
A continuación se muestra la información importante de cabeceras proveniente del navegador, que puede utilizar con frecuencia en la programación web:
| Cabecera | Descripción |
|---|---|
| Accept | Esta cabecera especifica los tipos MIME que el navegador u otros clientes pueden manejar. Los valoresimage/pngoimage/jpegson los dos valores posibles más comunes. |
| Accept-Charset | Esta cabecera especifica el conjunto de caracteres que el navegador puede utilizar para mostrar información. Por ejemplo, ISO-8859-1. |
| Accept-Encoding | Esta cabecera especifica los tipos de codificación que el navegador sabe cómo manejar. Los valoresgzipocompressson los dos valores posibles más comunes. |
| Accept-Language | Esta cabecera especifica el idioma preferido del cliente; en este caso, el Servlet generará resultados en varios idiomas. Por ejemplo, en, en-us, ru, etc. |
| Authorization | Esta cabecera se utiliza para que el cliente se identifique al acceder a páginas web protegidas por contraseña. |
| Connection | Esta cabecera indica si el cliente puede manejar conexiones HTTP persistentes. Las conexiones persistentes permiten al cliente u otros navegadores recuperar múltiples archivos mediante una sola solicitud. El valorKeep-Alivesignifica que se utiliza una conexión persistente. |
| Content-Length | Esta cabecera solo se aplica a solicitudes POST y proporciona el tamaño de los datos POST (en bytes). |
| Cookie | Esta cabecera devuelve al servidor las cookies que fueron enviadas previamente al navegador. |
| Host | Esta cabecera especifica el host y el puerto de la URL original. |
| If-Modified-Since | Esta cabecera indica que el cliente desea la página solo si ha sido modificada después de la fecha especificada. Si no hay un nuevo resultado disponible, el servidor enviará un código 304, indicandoNot Modifiedla cabecera. |
| If-Unmodified-Since | Esta cabecera es lo opuesto a If-Modified-Since; especifica que la operación tendrá éxito solo si el documento es anterior a la fecha especificada. |
| Referer | Esta cabecera indica la URL de la página web referente. Por ejemplo, si usted está en la página 1 y hace clic en un enlace a la página 2, cuando el navegador solicite la página 2, la URL de la página 1 se incluirá en la cabecera Referer. |
| User-Agent | Esta cabecera identifica al navegador u otro cliente que realiza la solicitud, y puede devolver contenido diferente a diferentes tipos de navegadores. |
Métodos para leer cabeceras HTTP
Los siguientes métodos se pueden utilizar en programas Servlet para leer cabeceras HTTP. Estos métodos están disponibles a través delHttpServletRequestobjeto.
| N.º | Método y descripción |
|---|---|
| 1 | Cookie[] getCookies() Devuelve una matriz que contiene todos los objetos Cookie que el cliente envió con la solicitud. |
| 2 | Enumeration getAttributeNames() Devuelve una enumeración que contiene los nombres de los atributos disponibles para la solicitud. |
| 3 | Enumeration getHeaderNames() Devuelve una enumeración que contiene todos los nombres de cabeceras incluidos en la solicitud. |
| 4 | Enumeration getParameterNames() Devuelve una enumeración de objetos String que contiene los nombres de los parámetros incluidos en la solicitud. |
| 5 | HttpSession getSession() Devuelve la sesión actual asociada con la solicitud, o si la solicitud no tiene sesión, crea una. |
| 6 | HttpSession getSession(boolean create) Devuelve el HttpSession actual asociado con la solicitud, o si no hay una sesión actual y create es verdadero, devuelve una nueva sesión. |
| 7 | Locale getLocale() Basado en la cabecera Accept-Language, devuelve la configuración regional preferida para el contenido aceptado por el cliente. |
| 8 | Object getAttribute(String name) Devuelve el valor del atributo nombrado como un objeto, o null si no existe un atributo con el nombre dado. |
| 9 | ServletInputStream getInputStream() Utiliza ServletInputStream para recuperar el cuerpo de la solicitud como datos binarios. |
| 10 | String getAuthType() Devuelve el nombre del esquema de autenticación utilizado para proteger el Servlet, por ejemplo, "BASIC" o "SSL", o null si el JSP no está protegido. |
| 11 | String getCharacterEncoding() Devuelve el nombre de la codificación de caracteres utilizada en el cuerpo de la solicitud. |
| 12 | String getContentType() Devuelve el tipo MIME del cuerpo de la solicitud, o null si se desconoce el tipo. |
| 13 | String getContextPath() Devuelve la parte del URI de la solicitud que indica el contexto de la solicitud. |
| 14 | String getHeader(String name) Devuelve el valor de la cabecera de solicitud especificada como una cadena. |
| 15 | String getMethod() Devuelve el nombre del método HTTP de la solicitud, por ejemplo, GET, POST o PUT. |
| 16 | String getParameter(String name) Devuelve el valor de un parámetro de solicitud como una cadena, o null si el parámetro no existe. |
| 17 | String getPathInfo() Cuando se realiza la solicitud, devuelve cualquier información de ruta adicional asociada con la URL enviada por el cliente. |
| 18 | String getProtocol() Devuelve el nombre y la versión del protocolo de la solicitud. |
| 19 | String getQueryString() Devuelve la cadena de consulta contenida en la URL de la solicitud después de la ruta. |
| 20 | String getRemoteAddr() Devuelve la dirección de Protocolo de Internet (IP) del cliente que envió la solicitud. |
| 21 | String getRemoteHost() Devuelve el nombre completamente calificado del cliente que envió la solicitud. |
| 22 | String getRemoteUser() Si el usuario ha sido autenticado, devuelve el usuario conectado que realizó la solicitud, o si el usuario no ha sido autenticado, devuelve null. |
| 23 | String getRequestURI() Devuelve la parte de la URL de la solicitud, desde el nombre del protocolo hasta la cadena de consulta en la primera línea de la solicitud HTTP. |
| 24 | String getRequestedSessionId() Devuelve el ID de sesión especificado por el cliente. |
| 25 | String getServletPath() Devuelve la parte de la URL de la solicitud que invocó al JSP. |
| 26 | String[] getParameterValues(String name) Devuelve una matriz de objetos String que contiene todos los valores del parámetro de solicitud dado, o null si el parámetro no existe. |
| 27 | boolean isSecure() Devuelve un valor booleano que indica si la solicitud utiliza un canal seguro, como HTTPS. |
| 28 | int getContentLength() Devuelve la longitud del cuerpo de la solicitud en bytes y proporciona el flujo de entrada, o devuelve -1 si se desconoce la longitud. |
| 29 | int getIntHeader(String name) Devuelve el valor de la cabecera de solicitud especificada como un valor int. |
| 30 | int getServerPort() Devuelve el número de puerto en el que se recibió esta solicitud. |
| 31 | int getParameterMap() Encapsula los parámetros en un tipo Map. |
Ejemplo de solicitud con cabeceras HTTP
El siguiente ejemplo utiliza el métodogetHeaderNames()de HttpServletRequest para leer la información de las cabeceras HTTP. Este método devuelve una enumeración que contiene la información de las cabeceras asociadas con la solicitud HTTP actual.
Una vez que tenemos una enumeración, podemos recorrerla de la manera estándar, utilizando el métodohasMoreElements()para determinar cuándo detenernos, y utilizando el métodonextElement()para obtener el nombre de cada parámetro.
//导入必需的 java 库
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Enumeration;
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("/DisplayHeader")
//扩展 HttpServlet 类
public class DisplayHeader extends HttpServlet {
// 处理 GET 方法请求的方法
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException
{
// 设置响应内容类型
response.setContentType("text/html;charset=UTF-8");
PrintWriter out = response.getWriter();
String title = "HTTP Header 请求实例 - Ejemplo实例";
String docType =
"<!DOCTYPE html> \n";
out.println(docType +
"<html>\n" +
"<head><meta charset=\"utf-8\"><title>" + title + "</title></head>\n"+
"<body bgcolor=\"#F0F0F0\">\n" +
"<h1 align=\"center\">" + title + "</h1>\n" +
"<table width=\"100%\" border=\"1\" align=\"center\">\n" +
"<tr bgcolor=\"#949494\">\n" +
"<th>Header 名称</th><th>Header 值</th>\n"+
"</tr>\n");
Enumeration headerNames = request.getHeaderNames();
while(headerNames.hasMoreElements()) {
String paramName = (String)headerNames.nextElement();
out.print("<tr><td>" + paramName + "</td>\n");
String paramValue = request.getHeader(paramName);
out.println("<td> " + paramValue + "</td></tr>\n");
}
out.println("</table>\n</body></html>");
}
// 处理 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>DisplayHeader</servlet-name>
<!-- 所在的包 -->
<servlet-class>com.ejemplo.test.DisplayHeader</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>DisplayHeader</servlet-name>
<!-- 访问的网址 -->
<url-pattern>/TomcatTest/DisplayHeader</url-pattern>
</servlet-mapping>
</web-app>
Ahora, al invocar el Servlet anterior y acceder ahttp://localhost:8080/TomcatTest/DisplayHeader se producirá el siguiente resultado:
