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êteDescription
AcceptCet 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-CharsetCet 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-EncodingCet 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-LanguageCet 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.
AuthorizationCet 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.
ConnexionCet 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-LengthCet en-tête s'applique uniquement aux requêtes POST et donne la taille des données POST (en octets).
CookieCet en-tête renvoie au serveur les cookies précédemment envoyés au navigateur.
HostCet en-tête spécifie l'hôte et le port dans l'URL d'origine.
If-Modified-SinceCet 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-SinceCet 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.
RefererCet 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-AgentCet 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
1Cookie[] getCookies()
Renvoie un tableau contenant tous les objets Cookie envoyés par le client avec la requête.
2Enumeration getAttributeNames()
Renvoie une énumération contenant les noms des attributs disponibles pour la requête.
3Enumeration getHeaderNames()
Renvoie une énumération contenant tous les noms d'en-têtes inclus dans la requête.
4Enumeration getParameterNames()
Renvoie une énumération d'objets String contenant les noms des paramètres inclus dans la requête.
5HttpSession getSession()
Renvoie la session actuelle associée à la requête, ou en crée une si la requête n'a pas de session.
6HttpSession 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.
7Locale 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.
8Object 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.
9ServletInputStream getInputStream()
Récupère le corps de la requête sous forme de données binaires à l'aide de ServletInputStream.
10String 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.
11String getCharacterEncoding()
Retourne le nom de l'encodage de caractères utilisé dans le corps de la requête.
12String getContentType()
Renvoie le type MIME du corps de la requête, ou renvoie null si le type est inconnu.
13String getContextPath()
Renvoie la partie de l'URI de requête qui indique le contexte de la requête.
14String getHeader(String name)
Renvoie la valeur de l'en-tête de requête spécifié sous forme de chaîne de caractères.
15String getMethod()
Renvoie le nom de la méthode HTTP de la requête, par exemple GET, POST ou PUT.
16String 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.
17String getPathInfo()
Renvoie toute information de chemin supplémentaire associée à l'URL que le client a envoyée au moment de la requête.
18String getProtocol()
Renvoie le nom et la version du protocole de la requête.
19String getQueryString()
Renvoie la chaîne de requête dans l'URL de la requête contenue après le chemin.
20String getRemoteAddr()
Renvoie l'adresse IP (Internet Protocol) du client qui a envoyé la requête.
21String getRemoteHost()
Renvoie le nom pleinement qualifié du client qui a envoyé la requête.
22String 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é.
23String 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.
24String getRequestedSessionId()
Renvoie l’ID de session spécifié par le client.
25String getServletPath()
Renvoie la partie de l’URL de la requête qui a appelé la JSP.
26String[] 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.
27boolean isSecure()
Renvoie un booléen indiquant si la requête utilise un canal sécurisé, tel que HTTPS.
28int 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.
29int getIntHeader(String name)
Renvoie la valeur de l’en-tête de requête spécifié sous forme de valeur int.
30int getServerPort()
Renvoie le numéro de port qui a reçu cette requête.
31int 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 :

Autres extensions