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.
400Ungü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  
500Interner 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
1public 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.
2public void sendRedirect(String url)
Diese Methode erzeugt eine 302-Antwort zusammen mit einemLocation-Header mit der URL des neuen Dokuments.
3public 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

Andere Erweiterungen