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. |
| 400 | Requê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 | |
| 500 | Erreur 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 |
|---|---|
| 1 | public 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. |
| 2 | public 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. |
| 3 | public 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 |