Servlet HTTP-Statuscodes
Das Format von HTTP-Anfrage- und HTTP-Antwortnachrichten ist ähnlich und hat die folgende Struktur:
- Initiale Statuszeile + Wagenrücklauf-Zeilenumbruch (Wagenrücklauf + Zeilenumbruch)
- Null oder mehr Header-Zeilen + Wagenrücklauf-Zeilenumbruch
- Eine Leerzeile, d. h. Wagenrücklauf-Zeilenumbruch
- Ein optionaler Nachrichtenkörper, z. B. eine Datei, Abfragedaten oder eine Abfrageausgabe
Beispielsweise sieht der Antwort-Header des Servers wie folgt aus:
HTTP/1.1 200 OK Content-Type: text/html Header2: ... ... HeaderN: ... (Blank Line) <!doctype ...> <html> <head>...</head> <body> ... </body> </html>
Die Statuszeile enthält die HTTP-Version (in diesem Beispiel HTTP/1.1), einen Statuscode (in diesem Beispiel 200) und eine kurze Meldung, die dem Statuscode entspricht (in diesem Beispiel OK).
Das Folgende ist eine Liste von HTTP-Statuscodes und zugehörigen Informationen, die von einem Webserver zurückgegeben werden können:
| Code | Nachricht | Beschreibung |
|---|---|---|
| 100 | Continue | Nur ein Teil der Anfrage wurde vom Server empfangen, aber solange sie nicht abgelehnt wurde, sollte der Client mit der Anfrage fortfahren. |
| 101 | Protokollwechsel | Der Server wechselt das Protokoll. |
| 200 | Gut | Die Anfrage war erfolgreich. |
| 201 | Erstellt | Die Anfrage ist abgeschlossen und erstellt eine neue Ressource. |
| 202 | Akzeptiert | Die Anfrage wurde zur Verarbeitung angenommen, aber die Verarbeitung ist noch nicht abgeschlossen. |
| 203 | Nicht autoritative Informationen | |
| 204 | Kein Inhalt | |
| 205 | Inhalt zurücksetzen | |
| 206 | Partieller Inhalt | |
| 300 | Mehrere Auswahlmöglichkeiten | Linkliste. Der Benutzer kann einen Link auswählen und zu dieser Adresse navigieren. Bis zu fünf Adressen. |
| 301 | Dauerhaft verschoben | Die angeforderte Seite wurde zu einer neuen URL verschoben. |
| 302 | Gefunden | Die angeforderte Seite wurde vorübergehend zu einer neuen URL verschoben. |
| 303 | Siehe auch | Die angeforderte Seite ist unter einer anderen URL zu finden. |
| 304 | Nicht geändert | |
| 305 | Proxy verwenden | |
| 306 | Nicht verwendet | Dieser Code wurde in früheren Versionen verwendet. Er wird nicht mehr verwendet, aber der Code ist weiterhin reserviert. |
| 307 | Temporäre Weiterleitung | Die angeforderte Seite wurde vorübergehend zu einer neuen URL verschoben. |
| 400 | Ungültige Anfrage | Der Server versteht die Anfrage nicht. |
| 401 | Nicht autorisiert | Die angeforderte Seite erfordert einen Benutzernamen und ein Passwort. |
| 402 | Zahlung erforderlich | Sie können diesen Code noch nicht verwenden. |
| 403 | Verboten | Der Zugriff auf die angeforderte Seite ist verboten. |
| 404 | Nicht gefunden | Der Server kann die angeforderte Seite nicht finden. |
| 405 | Methode nicht zulässig | Die in der Anfrage angegebene Methode ist nicht zulässig. |
| 406 | Nicht akzeptabel | Der Server erzeugt nur eine Antwort, die vom Client nicht akzeptiert wird. |
| 407 | Proxy-Authentifizierung erforderlich | Sie müssen die Proxy-Server-Authentifizierung verwenden, bevor die Anfrage zugestellt wird. |
| 408 | Zeitüberschreitung der Anfrage | Die Anfrage dauert länger, als der Server warten kann; Zeitüberschreitung. |
| 409 | Konflikt | Die Anfrage konnte aufgrund eines Konflikts nicht abgeschlossen werden. |
| 410 | Nicht mehr vorhanden | Die angeforderte Seite ist nicht mehr verfügbar. |
| 411 | Länge erforderlich | "Content-Length" ist nicht definiert. Der Server kann die vom Client gesendeten Anfrageinformationen ohne Content-Length nicht verarbeiten. |
| 412 | Vorbedingung fehlgeschlagen | Die in der Anfrage angegebene Vorbedingung wird vom Server als falsch ausgewertet. |
| 413 | Anfrage-Entität zu groß | Der Server akzeptiert die Anfrage nicht, weil die Request-Entity zu groß ist. |
| 414 | Anfrage-URL zu lang | Der Server akzeptiert die Anfrage nicht, weil die URL zu lang ist. Dies tritt auf, wenn Sie eine "post"-Anfrage in eine "get"-Anfrage mit langen Query-Informationen umwandeln. |
| 415 | Nicht unterstützter Medientyp | Der Server akzeptiert die Anfrage nicht, weil der Medientyp nicht unterstützt wird. |
| 417 | Erwartung fehlgeschlagen | |
| 500 | Interner Serverfehler | Unvollständige Anfrage. Der Server ist auf eine unerwartete Bedingung gestoßen. |
| 501 | Nicht implementiert | Unvollständige Anfrage. Der Server unterstützt die erforderliche Funktionalität nicht. |
| 502 | Ungültiges Gateway | Unvollständige Anfrage. Der Server hat eine ungültige Antwort von einem vorgelagerten Server erhalten. |
| 503 | Dienst nicht verfügbar | Unvollständige Anfrage. Der Server ist vorübergehend überlastet oder ausgefallen. |
| 504 | Gateway-Zeitüberschreitung | Gateway-Zeitüberschreitung. |
| 505 | HTTP-Version wird nicht unterstützt | Der Server unterstützt die Version des HTTP-Protokolls nicht. |
Methoden zum Festlegen des HTTP-Statuscodes
Die folgenden Methoden können verwendet werden, um HTTP-Statuscodes in einem Servlet-Programm festzulegen. Diese Methoden sind über dasHttpServletResponse-Objekt verfügbar.
| Nein. | Methode & Beschreibung |
|---|---|
| 1 | public void setStatus ( int statusCode ) Diese Methode legt einen beliebigen Statuscode fest. Die Methode setStatus akzeptiert einen int (Statuscode) als Parameter. Wenn Ihre Antwort einen speziellen Statuscode und ein Dokument enthält, stellen Sie sicher, dass Sie setStatus aufrufen, bevorPrintWritertatsächlich Inhalte zurückgibt. |
| 2 | public void sendRedirect(String url) Diese Methode erzeugt eine 302-Antwort zusammen mit einemLocation-Header mit der URL des neuen Dokuments. |
| 3 | public void sendError(int code, String message) Diese Methode sendet einen Statuscode (normalerweise 404) zusammen mit einer kurzen Nachricht, die automatisch in einem HTML-Dokument formatiert und an den Client gesendet wird. |
Beispiel für HTTP-Statuscode
Das folgende Beispiel sendet den Fehlercode 407 an den Client-Browser, und der Browser zeigt die Meldung "Authentifizierung erforderlich!!!" an.
// 导入必需的 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);
}
}
Nun wird beim Aufruf des obigen Servlets das folgende Ergebnis angezeigt:
HTTP-Status 407 - Authentifizierung erforderlich!!!Typ Statusbericht Meldung Authentifizierung erforderlich!!! Beschreibung Der Client muss sich zuerst beim Proxy authentifizieren (Authentifizierung erforderlich!!!). Apache Tomcat/5.5.29 |