- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- javax.servlet.ServletException
-
- javax.servlet.UnavailableException
-
- All Implemented Interfaces:
- Serializable
public class UnavailableException extends ServletException
Defines an exception that a servlet or filter throws to indicate that it is permanently or temporarily unavailable.When a servlet or filter is permanently unavailable, something is wrong with it, and it cannot handle requests until some action is taken. For example, a servlet might be configured incorrectly, or a filter's state may be corrupted. The component should log both the error and the corrective action that is needed.
A servlet or filter is temporarily unavailable if it cannot handle requests momentarily due to some system-wide problem. For example, a third-tier server might not be accessible, or there may be insufficient memory or disk storage to handle requests. A system administrator may need to take corrective action.
Servlet containers can safely treat both types of unavailable exceptions in the same way. However, treating temporary unavailability effectively makes the servlet container more robust. Specifically, the servlet container might block requests to the servlet or filter for a period of time suggested by the exception, rather than rejecting them until the servlet container restarts.
- Author:
- Various
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor and Description UnavailableException(int seconds, Servlet servlet, String msg)Deprecated.As of Java Servlet API 2.2, useUnavailableException(String, int)instead.UnavailableException(Servlet servlet, String msg)Deprecated.As of Java Servlet API 2.2, useUnavailableException(String)instead.UnavailableException(String msg)Constructs a new exception with a descriptive message indicating that the servlet is permanently unavailable.UnavailableException(String msg, int seconds)Constructs a new exception with a descriptive message indicating that the servlet is temporarily unavailable and giving an estimate of how long it will be unavailable.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method and Description ServletgetServlet()Deprecated.As of Java Servlet API 2.2, with no replacement. Returns the servlet that is reporting its unavailability.intgetUnavailableSeconds()Returns the number of seconds the servlet expects to be temporarily unavailable.booleanisPermanent()Returns abooleanindicating whether the servlet is permanently unavailable.-
Methods inherited from class javax.servlet.ServletException
getRootCause
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
UnavailableException
public UnavailableException(Servlet servlet, String msg)
Deprecated. As of Java Servlet API 2.2, useUnavailableException(String)instead.- Parameters:
servlet- theServletinstance that is unavailablemsg- aStringspecifying the descriptive message
-
UnavailableException
public UnavailableException(int seconds, Servlet servlet, String msg)Deprecated. As of Java Servlet API 2.2, useUnavailableException(String, int)instead.- Parameters:
seconds- an integer specifying the number of seconds the servlet expects to be unavailable; if zero or negative, indicates that the servlet can't make an estimateservlet- theServletthat is unavailablemsg- aStringspecifying the descriptive message, which can be written to a log file or displayed for the user.
-
UnavailableException
public UnavailableException(String msg)
Constructs a new exception with a descriptive message indicating that the servlet is permanently unavailable.- Parameters:
msg- aStringspecifying the descriptive message
-
UnavailableException
public UnavailableException(String msg, int seconds)
Constructs a new exception with a descriptive message indicating that the servlet is temporarily unavailable and giving an estimate of how long it will be unavailable.In some cases, the servlet cannot make an estimate. For example, the servlet might know that a server it needs is not running, but not be able to report how long it will take to be restored to functionality. This can be indicated with a negative or zero value for the
secondsargument.- Parameters:
msg- aStringspecifying the descriptive message, which can be written to a log file or displayed for the user.seconds- an integer specifying the number of seconds the servlet expects to be unavailable; if zero or negative, indicates that the servlet can't make an estimate
-
-
Method Detail
-
isPermanent
public boolean isPermanent()
Returns abooleanindicating whether the servlet is permanently unavailable. If so, something is wrong with the servlet, and the system administrator must take some corrective action.- Returns:
trueif the servlet is permanently unavailable;falseif the servlet is available or temporarily unavailable
-
getServlet
public Servlet getServlet()
Deprecated. As of Java Servlet API 2.2, with no replacement. Returns the servlet that is reporting its unavailability.- Returns:
- the
Servletobject that is throwing theUnavailableException
-
getUnavailableSeconds
public int getUnavailableSeconds()
Returns the number of seconds the servlet expects to be temporarily unavailable.If this method returns a negative number, the servlet is permanently unavailable or cannot provide an estimate of how long it will be unavailable. No effort is made to correct for the time elapsed since the exception was first reported.
- Returns:
- an integer specifying the number of seconds the servlet will be temporarily unavailable, or a negative number if the servlet is permanently unavailable or cannot make an estimate
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 18/08/2025
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-javaee-rf-javax/servlet/unavailableexception.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor dieser Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.