JSP - Codes d'état HTTP

Dans ce chapitre, nous aborderons les codes d'état Http dans JSP. Le format de la requête HTTP et des messages de réponse HTTP sont similaires et auront la structure suivante -

Une ligne d'état initial + CRLF (Retour chariot + Saut de ligne c'est-à-dire Nouvelle ligne)
Zéro ou plusieurs lignes d'en-tête + CRLF
Une ligne vierge ie. un CRLF
Un corps de message facultatif comme un fichier, des données de requête ou une sortie de requête.

Par exemple, un en-tête de réponse de serveur ressemble à ce qui suit -

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

<html>
   <head>...</head>
   
   <body>
      ...
   </body>
</html>

La ligne d'état se compose du HTTP version (HTTP/1.1 in the example), un code d'état (200 dans l'exemple), et un message très court correspondant au code d'état (OK in the example).

Le tableau suivant répertorie les codes d'état HTTP et les messages associés qui peuvent être renvoyés par le serveur Web -

Code	Message	La description
100	Continuer	Seule une partie de la demande a été reçue par le serveur, mais tant qu'elle n'a pas été rejetée, le client doit continuer avec la demande
101	Protocoles de commutation	Le serveur change de protocole.
200	D'accord	La demande est OK
201	Établi	La demande est terminée et une nouvelle ressource est créée
202	Accepté	La demande est acceptée pour le traitement, mais le traitement n'est pas terminé.
203	Informations ne faisant pas autorité
204	Pas de contenu
205	Réinitialiser le contenu
206	Contenu partiel
300	Choix multiples	Une liste de liens; l'utilisateur peut sélectionner un lien et accéder à cet emplacement. Maximum de cinq adresses.
301	Déplacé définitivement	La page demandée a été déplacée vers une nouvelle URL.
302	A trouvé	La page demandée a été déplacée temporairement vers une nouvelle URL.
303	Voir autre	La page demandée se trouve sous une URL différente.
304	Non modifié
305	Utiliser un proxy
306	Inutilisé	Ce code était utilisé dans une version précédente. Il n'est plus utilisé, mais le code est réservé.
307	Redirection temporaire	La page demandée a été déplacée temporairement vers une nouvelle URL.
400	Mauvaise Demande	Le serveur n'a pas compris la demande.
401	Non autorisé	La page demandée a besoin d'un nom d'utilisateur et d'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	Pas trouvé	Le serveur ne trouve pas la page demandée.
405	Méthode Non Autorisée	La méthode spécifiée dans la demande n'est pas autorisée.
406	Pas acceptable	Le serveur ne peut générer qu'une réponse non acceptée par le client.
407	Authentification proxy requise	Vous devez vous authentifier auprès d'un serveur proxy avant que cette demande puisse être servie.
408	Délai d'expiration de la demande	La demande a pris plus de temps que le serveur était prêt à attendre.
409	Conflit	La demande n'a pas pu être exécutée en raison d'un conflit.
410	Disparu	La page demandée n'est plus disponible.
411	Longueur requise	Le "Content-Length" n'est pas défini. Le serveur n'acceptera pas la demande sans elle.
412	La condition préalable a échoué	La condition préalable donnée dans la requête évaluée à false par le serveur.
413	Demande d'entité trop grande	Le serveur n'acceptera pas la demande, car l'entité de demande est trop volumineuse.
414	Request-url trop long	Le serveur n'acceptera pas la demande, car l'URL est trop longue. Cela se produit lorsque vous convertissez une demande «post» en une demande «get» avec des informations de requête longues.
415	Type de support non pris en charge	Le serveur n'acceptera pas la demande, car le type de média n'est pas pris en charge.
417	L'attente a échoué
500	Erreur Interne du Serveur	La demande n'a pas été complétée. Le serveur a rencontré une condition inattendue.
501	Pas mis en œuvre	La demande n'a pas été complétée. Le serveur ne prenait pas en charge la fonctionnalité requise.
502	Mauvaise passerelle	La demande n'a pas été complétée. Le serveur a reçu une réponse non valide du serveur en amont.
503	Service indisponible	La demande n'a pas été complétée. Le serveur est temporairement en surcharge ou en panne.
504	Délai d'expiration de la passerelle	La passerelle a expiré.
505	Version HTTP non prise en charge	Le serveur ne prend pas en charge le "http protocol" version.

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

Les méthodes suivantes peuvent être utilisées pour définir le code d'état HTTP dans votre programme de servlet. Ces méthodes sont disponibles avec l' objet HttpServletResponse .

S.No.	Méthode et description
1	public void setStatus ( int statusCode ) Cette méthode définit un code d'état arbitraire. La méthode setStatus prend un int (le code d'état) comme argument. Si votre réponse comprend un code de statut spécial et un document, n'oubliez pas d'appelersetStatusavant de retourner le contenu avec PrintWriter .
2	public void sendRedirect(String url) Cette méthode génère une réponse 302 avec un en- tête Location donnant l'URL du nouveau document.
3	public void sendError(int code, String message) Cette méthode envoie un code d'état (généralement 404) avec un court message qui est automatiquement mis en forme dans un document HTML et envoyé au client.

Exemple de code d'état HTTP

L'exemple suivant montre comment un code d'erreur 407 est envoyé au navigateur client. Après cela, le navigateur vous montrera "Need authentication!!!" message.

<html>
   <head>
      <title>Setting HTTP Status Code</title>
   </head>
   
   <body>
      <%
         // Set error code and reason.
         response.sendError(407, "Need authentication!!!" );
      %>
   </body>
</html>

Vous recevrez la sortie suivante -

HTTP Status 407 - Need authentication!!!
type Status report
message Need authentication!!!
description The client must first authenticate itself with the proxy (Need authentication!!!).
Apache Tomcat/5.5.29

Pour vous familiariser avec les codes d'état HTTP, essayez de définir différents codes d'état et leur description.