Servlet Codes de statut HTTP

Le format des messages de requête HTTP et de réponse HTTP est similaire, avec la structure suivante :

  • Ligne de statut initiale + retour chariot saut de ligne (retour chariot + saut de ligne)
  • Zéro ou plusieurs lignes d'en-tête + retour chariot saut de ligne
  • Une ligne vide, c'est-à-dire un retour chariot saut de ligne
  • Un corps de message facultatif, tel qu'un fichier, des données de requête ou une sortie de requête

Par exemple, l'en-tête de réponse du serveur est le suivant :

HTTP/1.1 200 OK
Content-Type: text/html
Header2: ...
...
HeaderN: ...
  (Blank Line)
<!doctype ...>
<html>
<head>...</head>
<body>
...
</body>
</html>

La ligne d'état inclut la version HTTP (HTTP/1.1 dans cet exemple), un code d'état (200 dans cet exemple), et un court message correspondant au code d'état (OK dans cet exemple).

Voici une liste des codes d'état HTTP et des informations associées qui peuvent être renvoyées par un serveur web :

Code Message Description
100 Continue Seule une partie de la requête a été reçue par le serveur, mais tant qu'elle n'a pas été rejetée, le client doit poursuivre la requête.
101 Switching Protocols Le serveur change de protocole.
200 OK La requête a réussi.
201 Created La requête est complète et crée une nouvelle ressource.
202 Accepted La requête a été acceptée pour traitement, mais le traitement n'est pas terminé.
203 Informations non faisant autorité  
204 Aucun contenu  
205 Réinitialiser le contenu  
206 Contenu partiel  
300 Choix multiples Liste de liens. L'utilisateur peut sélectionner un lien et se rendre à cet emplacement. Jusqu'à cinq adresses.
301 Déplacé définitivement La page demandée a été déplacée vers une nouvelle URL.
302 Trouvé La page demandée a été temporairement déplacée vers une nouvelle URL.
303 Voir autre La page demandée peut être trouvée à une URL différente.
304 Non modifié  
305 Utiliser un proxy  
306 Inutilisé Ce code était utilisé dans les versions précédentes. Il n'est plus utilisé, mais le code est toujours réservé.
307 Redirection temporaire La page demandée a été temporairement déplacée vers une nouvelle URL.
400Requête incorrecte Le serveur ne comprend pas la requête.
401 Non autorisé La page demandée nécessite un nom d'utilisateur et un mot de passe.
402 Paiement requis Vous ne pouvez pas encore utiliser ce code.
403 Interdit L'accès à la page demandée est interdit.
404 Non trouvé Le serveur ne trouve pas la page demandée.
405 Méthode non autorisée La méthode spécifiée dans la requête n'est pas autorisée.
406 Non acceptable Le serveur ne produit qu'une réponse qui n'est pas acceptée par le client.
407 Authentification proxy requise Vous devez utiliser l'authentification du serveur proxy avant que la requête ne soit transmise.
408 Délai d'attente de la requête dépassé La requête prend plus de temps que le serveur ne peut attendre ; délai d'attente dépassé.
409 Conflit La requête n'a pas pu être terminée en raison d'un conflit.
410 Disparu La page demandée n'est plus disponible.
411 Longueur requise "Content-Length" n'est pas défini. Le serveur ne peut pas traiter les informations de requête envoyées par le client sans Content-Length.
412 Échec de la précondition La précondition donnée dans la requête est évaluée comme fausse par le serveur.
413 Entité de requête trop grande Le serveur n'accepte pas la requête car l'entité de la requête est trop volumineuse.
414 URL de requête trop longue Le serveur n'accepte pas la requête car l'URL est trop longue. Cela se produit lorsque vous convertissez une requête "post" en une requête "get" avec de longues informations de requête.
415 Type de média non pris en charge Le serveur n'accepte pas la requête car le type de média n'est pas pris en charge.
417 Échec de l'attente  
500Erreur interne du serveur Requête incomplète. Le serveur a rencontré une condition inattendue.
501 Non implémenté Requête incomplète. Le serveur ne prend pas en charge la fonctionnalité requise.
502 Mauvaise passerelle Requête incomplète. Le serveur a reçu une réponse non valide d'un serveur en amont.
503 Service indisponible Requête incomplète. Le serveur est temporairement surchargé ou indisponible.
504 Délai d'attente de la passerelle Délai d'attente de la passerelle dépassé.
505 Version HTTP non prise en charge Le serveur ne prend pas en charge la version du protocole HTTP.

Méthodes pour définir le code d'état HTTP

Les méthodes suivantes peuvent être utilisées pour définir les codes d'état HTTP dans un programme Servlet. Ces méthodes sont disponibles via l'objetHttpServletResponse.

Non.Metode & Deskripsi
1public void setStatus ( int statusCode )
Cette méthode définit un code d'état arbitraire. La méthode setStatus accepte un int (code d'état) comme paramètre. Si votre réponse contient un code d'état spécial et un document, assurez-vous d'appeler setStatus avantPrintWriterde renvoyer réellement du contenu.
2public void sendRedirect(String url)
Cette méthode génère une réponse 302, accompagnée d'un en-têteLocationcontenant l'URL du nouveau document.
3public void sendError(int code, String message)
Cette méthode envoie un code d'état (généralement 404), accompagné d'un court message automatiquement formaté dans un document HTML et envoyé au client.

Exemple de code d'état HTTP

L'exemple suivant envoie le code d'erreur 407 au navigateur du client, et le navigateur affichera le message « Authentification requise !!! ».

// 导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
import java.util.*;
import javax.servlet.annotation.WebServlet;

@WebServlet("/showError")
// 扩展 HttpServlet 类
public class showError extends HttpServlet {
 
  // 处理 GET 方法请求的方法
  public void doGet(HttpServletRequest request,
                    HttpServletResponse response)
            throws ServletException, IOException
  {
      // 设置错误代码和原因
      response.sendError(407, "Need authentication!!!" );
  }
  // 处理 POST 方法请求的方法
  public void doPost(HttpServletRequest request,
                     HttpServletResponse response)
      throws ServletException, IOException {
     doGet(request, response);
  }
}

Maintenant, l'appel de la Servlet ci-dessus affichera le résultat suivant :

Statut HTTP 407 - Authentification requise !!!

type Rapport d'état

message Authentification requise !!!

description Le client doit d'abord s'authentifier auprès du proxy (Authentification nécessaire !!!).

Apache Tomcat/5.5.29

Autres extensions