Class UnavailableException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.servlet.ServletException

javax.servlet.UnavailableException

All Implemented Interfaces:

Serializable

public class UnavailableException
extends ServletException

This is a special kind of exception telling the server that this particular servlet is currently not available. It has two kinds of unavailability:

Permanent unavailable

This servlet is now and forever in the future unavailable. If another class in spite of this fact asks this exception for how long it is unavailable it returns a negative number of seconds. (-1 as a matter of fact)

Temporary unavailable The servlet is currently unavailable, but will be available within a certain number of seconds. A class can ask the exception for that number of seconds.

Since:

Servlet API 1.0

Version:

Servlet API 2.2

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
UnavailableException(int seconds, Servlet servlet, String message)	Deprecated.
UnavailableException(String message)	Constructor for a permanent unavailable exception
UnavailableException(String message, int seconds)	Constructor for a temporary unavailable exception
UnavailableException(Servlet servlet, String message)	Deprecated.

Method Summary

Modifier and Type	Method	Description
Servlet	getServlet()	Deprecated.
int	getUnavailableSeconds()	Gets the number of seconds the servlet is unavailable
boolean	isPermanent()	Check 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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

UnavailableException

public UnavailableException(String message)

Constructor for a permanent unavailable exception

Since:

Servlet API 2.2

UnavailableException

public UnavailableException(String message,
 int seconds)

Constructor for a temporary unavailable exception

Since:

Servlet API 2.2

UnavailableException

public UnavailableException(Servlet servlet,
 String message)

Deprecated.

Constructor for a permanent unavailable exception

Since:

Servlet API 1.0

UnavailableException

public UnavailableException(int seconds,
 Servlet servlet,
 String message)

Deprecated.

Constructor for a temporary unavailable exception

Since:

Servlet API 1.0

Method Details

isPermanent

public boolean isPermanent()

Check whether the servlet is permanently unavailable

Returns:

whether the servlet is permanently unavailable

Since:

Servlet API 1.0

getServlet

public Servlet getServlet()

Deprecated.

Gets the servlet that is unavailable

Since:

Servlet API 1.0

getUnavailableSeconds

public int getUnavailableSeconds()

Gets the number of seconds the servlet is unavailable

Returns:

the number of seconds. Negative if permanently unavailable

Since:

Servlet API 1.0