Servlet Requête HTTP client
Lorsqu'un navigateur demande une page web, il envoie des informations spécifiques au serveur web. Ces informations ne peuvent pas être lues directement car elles sont transmises dans l'en-tête de la requête HTTP. Vous pouvez vous référer àProtocole HTTPpour plus d'informations connexes.
Voici les informations d'en-tête importantes provenant du navigateur que vous pouvez fréquemment utiliser en programmation web :
| Informations d'en-tête | Description |
|---|---|
| Accept | Cet en-tête spécifie les types MIME que le navigateur ou d'autres clients peuvent gérer. Les valeursimage/pngouimage/jpegsont les deux valeurs possibles les plus courantes. |
| Accept-Charset | Cet en-tête spécifie le jeu de caractères que le navigateur peut utiliser pour afficher les informations. Par exemple, ISO-8859-1. |
| Accept-Encoding | Cet en-tête spécifie les types d'encodage que le navigateur sait gérer. La valeurgzipoucompresssont les deux valeurs possibles les plus courantes. |
| Accept-Language | Cet en-tête spécifie la langue préférée du client, auquel cas le Servlet peut produire des résultats dans plusieurs langues. Par exemple, en, en-us, ru, etc. |
| Authorization | Cet en-tête est utilisé par le client pour s'identifier lors de l'accès à des pages web protégées par mot de passe. |
| Connexion | Cet en-tête indique si le client peut gérer des connexions HTTP persistantes. Les connexions persistantes permettent au client ou à d'autres navigateurs de récupérer plusieurs fichiers avec une seule requête. La valeurKeep-Alivesignifie qu'une connexion persistante est utilisée. |
| Content-Length | Cet en-tête s'applique uniquement aux requêtes POST et donne la taille des données POST (en octets). |
| Cookie | Cet en-tête renvoie au serveur les cookies précédemment envoyés au navigateur. |
| Host | Cet en-tête spécifie l'hôte et le port dans l'URL d'origine. |
| If-Modified-Since | Cet en-tête indique que le client ne veut la page que si elle a été modifiée après la date spécifiée. Si aucun nouveau résultat n'est disponible, le serveur envoie un code 304, indiquant l'en-têteNot Modified. |
| If-Unmodified-Since | Cet en-tête est l'opposé de If-Modified-Since ; il spécifie que l'opération réussit uniquement lorsque le document est plus ancien que la date spécifiée. |
| Referer | Cet en-tête indique l'URL de la page web référencée. Par exemple, si vous êtes sur la page 1 et cliquez sur un lien vers la page 2, lorsque le navigateur demande la page 2, l'URL de la page 1 est incluse dans l'en-tête Referer. |
| User-Agent | Cet en-tête identifie le navigateur ou un autre client effectuant la requête, et peut renvoyer un contenu différent à différents types de navigateurs. |
Méthodes pour lire les en-têtes HTTP
Les méthodes suivantes peuvent être utilisées dans un programme Servlet pour lire les en-têtes HTTP. Ces méthodes sont disponibles via l'objetHttpServletRequest.
| Non. | Metode & Deskripsi |
|---|---|
| 1 | Cookie[] getCookies() Renvoie un tableau contenant tous les objets Cookie envoyés par le client avec la requête. |
| 2 | Enumeration getAttributeNames() Renvoie une énumération contenant les noms des attributs disponibles pour la requête. |
| 3 | Enumeration getHeaderNames() Renvoie une énumération contenant tous les noms d'en-têtes inclus dans la requête. |
| 4 | Enumeration getParameterNames() Renvoie une énumération d'objets String contenant les noms des paramètres inclus dans la requête. |
| 5 | HttpSession getSession() Renvoie la session actuelle associée à la requête, ou en crée une si la requête n'a pas de session. |
| 6 | HttpSession getSession(boolean create) Retourne l'HttpSession actuelle associée à la requête, ou, s'il n'y a pas de session actuelle et que create vaut true, retourne une nouvelle session. |
| 7 | Locale getLocale() Retourne la locale préférée pour l'acceptation du contenu par le client, en fonction de l'en-tête Accept-Language. |
| 8 | Object getAttribute(String name) Retourne la valeur d'un attribut nommé sous forme d'objet, ou retourne null si aucun attribut portant le nom donné n'existe. |
| 9 | ServletInputStream getInputStream() Récupère le corps de la requête sous forme de données binaires à l'aide de ServletInputStream. |
| 10 | String getAuthType() Retourne le nom du schéma d'authentification utilisé pour protéger la Servlet, par exemple "BASIC" ou "SSL", ou retourne null si la JSP n'est pas protégée. |
| 11 | String getCharacterEncoding() Retourne le nom de l'encodage de caractères utilisé dans le corps de la requête. |
| 12 | String getContentType() Renvoie le type MIME du corps de la requête, ou renvoie null si le type est inconnu. |
| 13 | String getContextPath() Renvoie la partie de l'URI de requête qui indique le contexte de la requête. |
| 14 | String getHeader(String name) Renvoie la valeur de l'en-tête de requête spécifié sous forme de chaîne de caractères. |
| 15 | String getMethod() Renvoie le nom de la méthode HTTP de la requête, par exemple GET, POST ou PUT. |
| 16 | String getParameter(String name) Renvoie la valeur d'un paramètre de requête sous forme de chaîne de caractères, ou null si le paramètre n'existe pas. |
| 17 | String getPathInfo() Renvoie toute information de chemin supplémentaire associée à l'URL que le client a envoyée au moment de la requête. |
| 18 | String getProtocol() Renvoie le nom et la version du protocole de la requête. |
| 19 | String getQueryString() Renvoie la chaîne de requête dans l'URL de la requête contenue après le chemin. |
| 20 | String getRemoteAddr() Renvoie l'adresse IP (Internet Protocol) du client qui a envoyé la requête. |
| 21 | String getRemoteHost() Renvoie le nom pleinement qualifié du client qui a envoyé la requête. |
| 22 | String getRemoteUser() Renvoie l'utilisateur connecté qui effectue la requête si l'utilisateur a été authentifié, ou renvoie null si l'utilisateur n'a pas été authentifié. |
| 23 | String getRequestURI() Renvoie la partie de l'URL de la requête depuis le nom du protocole jusqu'à la chaîne de requête dans la première ligne de la requête HTTP. |
| 24 | String getRequestedSessionId() Renvoie l’ID de session spécifié par le client. |
| 25 | String getServletPath() Renvoie la partie de l’URL de la requête qui a appelé la JSP. |
| 26 | String[] getParameterValues(String name) Renvoie un tableau d’objets String contenant toutes les valeurs du paramètre de requête donné, ou null si le paramètre n’existe pas. |
| 27 | boolean isSecure() Renvoie un booléen indiquant si la requête utilise un canal sécurisé, tel que HTTPS. |
| 28 | int getContentLength() Renvoie la longueur du corps de la requête en octets et fournit un flux d’entrée, ou renvoie -1 si la longueur est inconnue. |
| 29 | int getIntHeader(String name) Renvoie la valeur de l’en-tête de requête spécifié sous forme de valeur int. |
| 30 | int getServerPort() Renvoie le numéro de port qui a reçu cette requête. |
| 31 | int getParameterMap() Encapsule les paramètres dans un type Map. |
Exemple de requête d'en-tête HTTP
L'exemple suivant utilise la méthodegetHeaderNames()de HttpServletRequest pour lire les informations d'en-tête HTTP. Cette méthode renvoie une énumération contenant les informations d'en-tête liées à la requête HTTP actuelle.
Une fois que nous avons une énumération, nous pouvons la parcourir de manière standard, en utilisant la méthodehasMoreElements()pour déterminer quand nous devons arrêter, en utilisant la méthodenextElement()pour obtenir le nom de chaque paramètre.
//导入必需的 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 请求实例 - Example实例";
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);
}
}
L'exemple de test ci-dessus se trouve dans le projet TomcatTest, et la configuration web.xml correspondante est :
<?xml version="1.0" encoding="UTF-8"?>
<web-app>
<servlet>
<!-- 类名 -->
<servlet-name>DisplayHeader</servlet-name>
<!-- 所在的包 -->
<servlet-class>com.example.test.DisplayHeader</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>DisplayHeader</servlet-name>
<!-- 访问的网址 -->
<url-pattern>/TomcatTest/DisplayHeader</url-pattern>
</servlet-mapping>
</web-app>
Maintenant, appelez le Servlet ci-dessus et accédez àhttp://localhost:8080/TomcatTest/DisplayHeader , ce qui produira le résultat suivant :
