Spec-Zone .ru
спецификации, руководства, описания, API


javax.servlet
Класс UnavailableException

java.lang.Object
  расширенный java.lang.Throwable
      расширенный java.lang.Exception
          расширенный javax.servlet.ServletException
              расширенный javax.servlet.UnavailableException
Все Реализованные Интерфейсы:
java.io. Сериализуемый

public class UnavailableException
расширяет ServletException

Определяет исключение, что сервлет или броски фильтра, чтобы указать, что это постоянно или временно недоступно.

Когда сервлет или фильтр постоянно недоступны, что-то является неправильным с этим, и это не может обработать запросы, пока некоторые меры не предпринимаются. Например, сервлет мог бы быть сконфигурирован неправильно, или состояние фильтра может быть повреждено. Компонент должен зарегистрировать и ошибку и корректирующее действие, которое необходимо.

Сервлет или фильтр временно недоступны, если это не может обработать запросы на мгновение из-за некоторой проблемы в масштабе всей системы. Например, трех-уровневый сервер не мог бы быть доступным, или может быть недостаточная память или память на диске, чтобы обработать запросы. Системный администратор, возможно, должен принять меры по ликвидации последствий.

Контейнеры сервлета могут безопасно обработать оба типа недоступных исключений таким же образом. Однако, обработка временной недоступности эффективно делает контейнер сервлета более устойчивым. Определенно, контейнер сервлета мог бы блокировать запросы к сервлету или фильтру сроком на время, предложенное исключением, вместо того, чтобы отклонить их до перезапусков контейнера сервлета.

Автор:
Различный
См. Также:
Сериализированная Форма

Сводка конструктора
UnavailableException(int seconds, Servlet servlet, java.lang.String msg)
          Осуждаемый. С API Сервлета Java 2.2, использовать UnavailableException(String, int) вместо этого.
UnavailableException(Servlet servlet, java.lang.String msg)
          Осуждаемый. С API Сервлета Java 2.2, использовать UnavailableException(String) вместо этого.
UnavailableException(java.lang.String msg)
          Создает новое исключение с дескриптивным сообщением, указывающим, что сервлет постоянно недоступен.
UnavailableException(java.lang.String msg, int seconds)
          Создает новое исключение с дескриптивным сообщением, указывающим, что сервлет временно недоступен и дающий оценку того, сколько времени это будет недоступно.
 
Сводка метода
 Сервлет getServlet()
          Осуждаемый. С API Сервлета Java 2.2, без замены. Возвращает сервлет, который сообщает о его недоступности.
 int getUnavailableSeconds()
          Возвращает число секунд, сервлет ожидает быть временно недоступным.
 boolean isPermanent()
          Возвраты a boolean указание, недоступен ли сервлет постоянно.
 
Методы, наследованные от class javax.servlet. ServletException
getRootCause
 
Методы, наследованные от class java.lang. Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Деталь конструктора

UnavailableException

public UnavailableException(Servlet servlet,
                            java.lang.String msg)
Осуждаемый. С API Сервлета Java 2.2, использовать UnavailableException(String) вместо этого.

Параметры:
servlet - Servlet экземпляр, который недоступен
msg - a String определение дескриптивного сообщения

UnavailableException

public UnavailableException(int seconds,
                            Servlet servlet,
                            java.lang.String msg)
Осуждаемый. С API Сервлета Java 2.2, использовать UnavailableException(String, int) вместо этого.

Параметры:
seconds - целое число, определяющее число секунд сервлет, ожидает быть недоступным; если нуль или отрицательный, указывает, что сервлет не может сделать оценку
servlet - Servlet это недоступно
msg - a String определение дескриптивного сообщения, которое может быть записано файлу журнала или выведено на экран для пользователя.

UnavailableException

public UnavailableException(java.lang.String msg)
Создает новое исключение с дескриптивным сообщением, указывающим, что сервлет постоянно недоступен.

Параметры:
msg - a String определение дескриптивного сообщения

UnavailableException

public UnavailableException(java.lang.String msg,
                            int seconds)
Создает новое исключение с дескриптивным сообщением, указывающим, что сервлет временно недоступен и дающий оценку того, сколько времени это будет недоступно.

В некоторых случаях сервлет не может сделать оценку. Например, сервлет мог бы знать, что сервер, в котором он нуждается, не работает, но не быть в состоянии сообщить, сколько времени он возьмет, чтобы быть восстановленным функциональности. Это может быть обозначено с отрицательной величиной или нулевым значением для seconds параметр.

Параметры:
msg - a String определение дескриптивного сообщения, которое может быть записано файлу журнала или выведено на экран для пользователя.
seconds - целое число, определяющее число секунд сервлет, ожидает быть недоступным; если нуль или отрицательный, указывает, что сервлет не может сделать оценку
Деталь метода

isPermanent

public boolean isPermanent()
Возвраты a boolean указание, недоступен ли сервлет постоянно. Если так, что-то является неправильным с сервлетом, и системный администратор должен принять некоторые меры по ликвидации последствий.

Возвраты:
true если сервлет постоянно недоступен; false если сервлет доступен или временно недоступен

getServlet

public Servlet getServlet()
Осуждаемый. С API Сервлета Java 2.2, без замены. Возвращает сервлет, который сообщает о его недоступности.

Возвраты:
Servlet объект, который бросает UnavailableException

getUnavailableSeconds

public int getUnavailableSeconds()
Возвращает число секунд, сервлет ожидает быть временно недоступным.

Если этот метод возвращает отрицательное число, сервлет постоянно недоступен или не может обеспечить оценку того, сколько времени это будет недоступно. Никакое усилие не прилагается, чтобы исправить в течение времени, законченного, так как об исключении сначала сообщили.

Возвраты:
целое число, определяющее число секунд, сервлет будет временно недоступен, или отрицательное число, если сервлет будет постоянно недоступен или не сможет сделать оценку


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter