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

javax.servlet.jsp.tagext
Интерфейс TryCatchFinally

Все Известные Классы с реализацией:

LoopTagSupport

public interface TryCatchFinally

Вспомогательный интерфейс Тега, IterationTag или BodyTag тегирует обработчик, который хочет дополнительные рычаги для того, чтобы управлять ресурсами.

Этот интерфейс обеспечивает два новых метода: doCatch (Throwable) и doFinally (). Формирующий прототип вызов следующие:

 h = get a Tag();  // get a tag handler, perhaps from pool

 h.setPageContext(pc);  // initialize as desired
 h.setParent(null);
 h.setFoo("foo");
 
 // tag invocation protocol; see Tag.java
 try {
   doStartTag()...
   ....
   doEndTag()...
 } catch (Throwable t) {
   // react to exceptional condition
   h.doCatch(t);
 } finally {
   // restore data invariants and release per-invocation resources
   h.doFinally();
 }
 
 ... other invocations perhaps with some new setters
 ...
 h.release();  // release long-term resources
 

Сводка метода

void	doCatch(java.lang.Throwable t) Вызванный, если Throwable происходит, оценивая ТЕЛО в теге или в каком-либо из следующих методов: Tag.doStartTag (), Tag.doEndTag (), IterationTag.doAfterBody () и BodyTag.doInitBody ().
void	doFinally() Вызванный во всех случаях после doEndTag () для любого Тега реализации class, IterationTag или BodyTag.

Деталь метода

doCatch

void doCatch(java.lang.Throwable t)
             throws java.lang.Throwable

Вызванный, если Throwable происходит, оценивая ТЕЛО в теге или в каком-либо из следующих методов: Tag.doStartTag (), Tag.doEndTag (), IterationTag.doAfterBody () и BodyTag.doInitBody ().

Этот метод не вызывается, если Throwable происходит во время одного из методов метода set.

Этот метод может выдать исключение (то же самое или новый), который будет распространен далее цепочка вложенного множества. Если исключение будет выдано, то doFinally () будет вызван.

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

Параметры:

t - throwable навигация исключения через этот тег.

Броски:

java.lang.Throwable - если исключение должно быть повторно брошено далее цепочка вложенного множества.

doFinally

void doFinally()

Вызванный во всех случаях после doEndTag () для любого Тега реализации class, IterationTag или BodyTag. Этот метод вызывается, даже если исключение произошло в ТЕЛЕ тега, или в каком-либо из следующих методов: Tag.doStartTag (), Tag.doEndTag (), IterationTag.doAfterBody () и BodyTag.doInitBody ().

Этот метод не вызывается, если Throwable происходит во время одного из методов метода set.

Этот метод не должен выдать Исключение.

Этот метод предназначается, чтобы поддержать целостность данных на вызов и действия управления ресурсами.