Тэги, которые управляют содержимым своего тела

До этого момента те два тэга, которые мы рассматривали, игнорировали содержимое своего тела или, что более точно, они были определены, как не имеющие никакого содержимого в теле. Тэги такого рода очень просты и часто ограничены в своей пригодности, хотя, как вы можете видеть, создание bean'а, доступного автору страницы, может быть достаточно полезным. Тэги, которые манипулируют содержимым своего тела, обычно намного более полезны, хотя немного более трудны в программировании.

Давайте взглянем на тэг, который реально интересуется содержимым своего тела.

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

Это была темная и штормовая ночь...

Это может быть выполнено в HTML достаточно примитивным образом, с помощью использования текста заголовка и таблиц, которые служат для наших целей, но прежде, чем писать таблицу каждый раз, когда вы хотите разбить символы, почему бы не создать тэг, которые делает это за вас? В идеале он должен делать что-то типа такого:

<tijtags:dropcapitaltag color = "black">

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

</tijtags:dropcapitaltag>

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

Чтобы создать этот тэг, нам необходимо выполнить следующие важные задачи:

Написать класс, который реализует интерфейс Tag.

Дать классу метод setColor(), который позволит контейнеру устанавливать атрибут цвета.

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

Создать файл дескриптора библиотеки тэга для тэга.

Давайте взглянем на код этого тэга:

package cx2.tags;

import javax.servlet.jsp.tagext.BodyTagSupport;

import javax.servlet.jsp.tagext.TryCatchFinally;

import javax.servlet.jsp.JspException;

import java.util.StringTokenizer;

public class DropCapitalTag extends BodyTagSupport implements TryCatchFinally {

String color = "black";

 

public void setColor(String color) {

this.color = color;

}

 

public int doAfterBody() throws JspException {

int period;

StringBuffer result = new StringBuffer();

String body = bodyContent.getString().trim();

result.append("<table><tr><td><h1><font color=\""+color+"\">");

result.append(Character.toUpperCase(body.charAt(0)));

result.append("</font></h1></td><td>");

period = body.indexOf('.');

result.append (body.substring(1, period+1));

result.append ("</td></tr></table>");

result.append (body.substring(period +1, body.length()));

try {

if (result.length() > 0) {

bodyContent.clearBody();

bodyContent.println(result.toString());

}

bodyContent.writeOut(bodyContent.getEnclosingWriter());

} catch(Exception e) {

e.printStackTrace();

}

return SKIP_BODY;

}

public void doCatch(Throwable t) {

System.out.println(

"An error occurred with the message" +

t.getMessage());

}

public void doFinally() {}

public void release() {

color = "black";

}

}

Первое, что вы заметите, это то, что в отличие от предыдущего тэга, этот тэг не реализует интерфейс Tag. Это происходит потому, что когда вам необходимо управлять содержимым тела, более полезно расширять класс BodyTagSupport, который берет на себя заботу о сохранении объекта pageContext и предоставлении реализации по умолчанию для методов doStartTag() и doEndTag(). Этот класс реализует интерфейс Tag, так что вам не нужно делать это.

Метод doAfterBody() этого тэга является тем методом, где все происходит. Вы увидите, что этот класс ссылается на обработчик, называемый bodyContent. Это ссылка на объект BodyContent, который находится в пакете javax.servlet.jsp.tagext. Он предоставляется контейнером через метод setBodyContent() и является ничем иным, что мы свободно получаем во время наследования класса BodyTagSupport. Этот контейнер будет всегда предоставлять этот объект до того, как он вызовет метод doInitBody(), так что вы всегда гарантированы в том, что у вас есть действительный объект BodyContent в ваших методах doInitBody(), doAfterBody(), doStartTag и doEndTag().

Объект BodyContent является инкапсуляцией содержимого тела этого конкретного тэга, он содержит весь текст из JSP страницы, который находится между начальным и конечным тэгом. Это очень сильно похоже на выходной поток, но с некоторой дополнительной функциональностью. Этот объект дает вам доступ к JSP тексту. Вот что делает тэг отделения заглавной буквы и вот что вам необходимо сделать, если вы хотите манипулировать содержимым тела. Вы можете получить тело целиком в виде строки, посредством вызова getString(), или в виде потока, используя метод getReader(), если это более подходит вашим нуждам.

В этом примере использован простейший алгоритм для удаления любого свободного пространства, которое поступает из JSP источника, изменение первой буквы на прописную и добавления некоторого количества HTML тэгов, чтобы отформатировать и предать эффект отделенной большой буквы.

После того, как были добавлены HTML тэги (с помощью объекта StringBuffer для добавления строк), появляется длинная строка, которой необходимо заменить старый текст. Чтобы сделать это, сначала вызывается метод clearBody() из BodyContent. Если вы не сделаете этого, содержимое тела появится в браузере дважды. Далее, мы используем метод println(), чтобы добавить новую строку в BodyContent, и, наконец, вызывается метод writeOut(). Этот метод сообщает объекту BodyContent о перенаправлении его вывода в браузер, но вы заметите, что этот метод принимает JspWriter в качестве параметра, а в этом случае writer получается из вызова getEnclosingWriter(). Вам нужно сделать это, поскольку объект содержимого тела включает только тело вашего определенного тэга и вам необходимо получить доступ к выходному потоку, который направляет вывод клиентскому браузеру.

Если вы рассмотрите более подробно, вы увидите, что метод release() не делает ничего. Этот метод будет вызван контейнером для высвобождения своего состояния, так что его лучше использовать для высвобождения ресурсов, которые вы можете использовать в тэге. Имейте в виду, что может быть несколько вызовов doStartTag() и doEndTag() и между каждым из них вызывается release, так что это не тот метод, который нужно использовать для выполнения операций, выполняющихся каждый раз, при завершении обработки тэга. Если вы хотите сделать это, вам лучше всего использовать doFinally(), описанный в следующем параграфе.

Вы можете заметить, что этот класс реализует интерфейс TryCatchFinally, находящийся в пакете javax.servlet.jsp.tagext. Когда контейнер видит, что ваш тэг реализует этот интерфейс, он знает, что нужно поместить блок try/catch вокруг обработчика тэга и, в случае возникновения исключения, передать обработку вам. Это значит, что вы получаете максимальный контроль над кодом обработки исключений и, если захотите, вы можете предотвратить отображение текста возникшего исключения в окне браузера.

Методы интерфейса TryCatchFinally - это doCatch() и doFinally() и они соответствуют ключевым словам catch и finally в Java. Метод doCatch() вызывается, если возникает исключение, исключение передается в него в качестве параметра, а doFinally() вызывается всегда, независимо от того, что случилось в других методах обработчика тэга. В этом примере, если возникнет исключение, на консоли сервера, а не в клиентском браузере, просто возникнет сообщение. Это немного ленивый подход к дизайну, использующийся для демонстрации интерфейса. Алгоритм, использованный здесь, не очень устойчивый, так что легко может возникнуть исключение. В приведенном выше методе doFinally() устанавливается черный цвет, так как это всегда значение по умолчанию.

Используйтесь этот интерфейс с осторожностью. Его основное назначение состоит в том, чтобы дать вам больший контроль, когда обрабатываете ресурсы такие, как потоки и т.п. Помните, что исключения относятся к восстановлению и может быть более подходящим обработать исключения в ваших методах doAfterBody() или doInitBody() и произвести некоторый имеющий смысл вывод для отображения в клиентском браузере, например страницы с ошибкой, которая попросит пользователя ввести повторно некоторые детали. Вы можете захотет просто перенаправить браузеру общую страницу сообщения об ошибке, если это больше подходит.

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

..

<tag>

<name>dropcapitaltag</name>

<tagclass>cx2.tags.DropCapitalTag</tagclass>

<bodycontent>JSP</bodycontent>

<info> Transforms text to have a drop capital.

</info>

<attribute>

<name>color</name>

<required>false</required>

</attribute>

</tag>

..

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

Вот и все, что вам нужно сделать для манипуляции телом тэга!

Итеративные тэги

Одна из наиболее мощных особенностей произвольных тэгов в JSP - это то, что они могут итерировать, как цикл for или while в Java и, таким образом, производить динамический вывод.

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

Предположим, что вы хотите сгенерировать список простых чисел (чисел, делящихся только на себя и на 1) и отобразить его в HTML в виде ненумерованного списка. Что вам действительно желательно - это тэг, который может генерировать все простые числа в пределах указанного диапазона, предоставит вам доступ к каждому значению и поместит его в желаемый вам формат. Так как вы не знаете, сколько чисел будет в заданном диапазоне, а их может быть несколько, вы не захотите набирать HTML тэги для списка <li> и </li> для каждого из них. Допустим, что ваш тэг называется primtag, и вы хотите, чтобы ваш JSP файл выглядел примерно так:

<ul>

<tijtags:primetag start = "1" end= "25">

<li><%=value%></li>

</tijtags:primetag>

</ul>

Обратите внимание, что есть начальный и конечный HTML тэги <ul>, окружающий весь блок. **(HTML лекция выходит далеко за пределы темы этой главы, но коротко скажу, что они определяют ненумерованный список и внутри тела того тэга все данные между парой <li> и </li> будут отображаться, как помеченный элемент списка.)

Следующее, что вы заметите, это ссылка на хорошо известное пространство имен tijtags, указанное в новом произвольном тэге primetag с двумя атрибутами start и end.

В этом тэге, в отличие от двух предыдущих тэгов, есть не только завершающий тэг, указанный отдельно, </tijtags…, но также некое содержимое тела между начальным и конечным тегами. Вот что делает этот тэг особенно интересным. Тэги <li> являются простым HTML, как сказано выше, но между этим, заключенная в скриплетные скобки JSP, есть ссылка на переменную value.

Есть два очень мощных свойства этого произвольного тэга. Во-первых, он делает доступной переменную value для использования в скриплете или в простом JSP выражении, таком как <%=value%>. Во-вторых, все, что находится в теле нашего произвольного тэга, неоднократно обрабатывается и добавляется в выходной поток, чтобы быть представленным браузеру. Это значит, что не только приведенный выше тэг будет зациклен до тех пор, пока не найдет все примитивные числа внутри указанного диапазона, но также будут отображаться тэги <li> и </li> наряду со значением переменной value для каждого числа! Другими словами, приведенный выше JSP код - это все, что вам необходимо для отображения значений простых чисел в чистом списке. И вам даже не нужно знать, сколько чисел должно получиться.

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

Чтобы реализовать этот тэг вам необходимо выполнить следующие задачи:

Создать (или найти) класс с подходящей логикой для генерации простых чисел.

Написать класс тэга, который реализует подходящий интерфейс тэга.

Написать методы установки для параметров start и end.

Запрограммировать механизм цикла для обработки содержимого тела и для каждой итерации сделать доступной для JSP страницы переменную со значением текущего простого числа.

Создать для тэга TLD или файл дескриптора библиотеки тэга.

Вы можете найти класс PrimeUtilities на CD (??) или в приложении (??). Этот пример использует метод sievePrimes(), который находит простые числа. Есть много ресурсов в Интернете для нахождения такого алгоритма, если вы интересуетесь подобного рода вещами.

Давайте взглянем на реальный класс тэга.

package cx2.tags;

import java.util.ArrayList;

import java.util.Iterator;

import javax.servlet.jsp.tagext.BodyTagSupport;

import javax.servlet.jsp.JspException;

import javax.servlet.jsp.PageContext;

import com.bruceeckel.PrimeUtilities;

 

public class PrimeNumTag extends BodyTagSupport {

private int start = 0;

private int end = 0;

ArrayList primeList;

Iterator primeIterator;

public void setStart(int start) {

this.start = start;

}

public void setEnd(int end) {

this.end = end;

}

public int doStartTag() throws JspException {

 

try {

primeList = PrimeUtilities.sievePrimes(start, end);

primeIterator = primeList.iterator();

} catch (Exception e) {

e.printStackTrace();

return SKIP_BODY;

}

return EVAL_BODY_BUFFERED;

}

public void doInitBody() throws JspException {

try {

if (primeIterator.hasNext()) {

pageContext.setAttribute("value",

primeIterator.next());

}

} catch (Exception e) {

e.printStackTrace();

}

}

public int doAfterBody() {

try {

if (primeIterator.hasNext()) {

pageContext.setAttribute("value",

primeIterator.next());

return EVAL_BODY_BUFFERED;

} else {

bodyContent.writeOut(bodyContent.getEnclosingWriter());

return SKIP_BODY;

}

} catch (Exception e) {

e.printStackTrace();

return SKIP_BODY;

}

}

public void release() {

primeList = null;

start = 0;

}

Первое, что вы должны заметить, это то, что класс тэга больше не реализует интерфейс Tag напрямую. Это происходит потому, что тэг имеет немного больше функциональности и поэтому более полезно наследовать класс BodyTagSupport. Этот класс реализует интерфейс Tag и предоставляет некоторую дополнительную функциональность. Варианты классов и интерфейсов Tag будут обсуждаться более детально позднее.

Этот класс, опять таки, использует объект PageContext, предоставляемый контейнером посредством метода setPageContext(). Так как этот класс тэга наследуется от BodyTagSupport, больше нет необходимости хранить объект pageContext самостоятельно. Об этом заботится родительский класс. Это хороший пример повторного использования кода посредством наследования.

Метод doStartTag() становиться первым методом, о котором вам необходимо позаботиться. В приведенной выше реализации используется класс PrimeUtilities, использующийся для получения и хранения объекта типа Iterator, который содержит простые числа. Обратите внимание, что если не возникнет исключения, этот метод возвращает значение EVAL_BODY_BUFFERED, в отличие от двух предыдущих примеров, в которых возвращалось значение SKIP_BODY во всех случаях. Как вы можете предположить, это ключевое значение для реализации тэга, который обрабатывает содержимое своего тела.

Далее вы заметите, что реализован метод doInitBody(). Этот метод вызывается JSP контейнером прежде, чем тело вашего тэга будет обработано, и это тот метод, в котором вы будете выполнять код любой инициализации, требующейся для обработки содержимого тела. В предыдущем примере в этом не было необходимости, так как действительно нечего было делать. Однако в приведенном выше примере этот метод опрашивает итератор простых чисел, чтобы убедиться, что в списке есть доступные простые числа, и если они есть, используется метод setAttribute() для добавления значения первого имеющегося простого числа из списка в контекст страницы. Как вы можете видеть, значение ассоциируется с именем value.

Мы употребляли аналогичную форму setAttribute() ранее, но в этот раз вы заметите, что метод имеет только два параметра, поскольку этот класс использует область видимости по умолчанию PAGE_SCOPE. Действия, делающие этот объект доступным для использования в JSP странице, заключены в части ответственности специального класса, называемого TagExtraInfo - класс, который будет рассмотрен немного позднее. Конструкция цикла теперь инициализирована и, если не произошло никаких исключений, в этом месте тэг будет читать текст тела.

Метод doAfterBody() не отличается от метода doInitBody(). Он проверяет, чтобы убедиться, что больше нет простых чисел в итераторе, а если они есть, метод добавляет значение имеющегося простого числа в контекст страницы. Если больше нет имеющихся простых чисел, метод пишет содержимое тела тэга в выходной поток, который перенаправляется в браузер.

Если вы посмотрите внимательнее, вы увидите, что все это не достаточно очевидно. Объект, на который ссылается bodyContent, фактически является экземпляром класса BodyContent, который находится в пакете javax.servlet.jsp.tagext. Он инкапсулирует содержимое тела этого конкретного тэга, а это немного похоже на выходной поток, но с некоторой дополнительной функциональностью. Если бы объект PrimeNumTag не наследовался бы от класса BodyTagSupport, то необходимо было бы реализовать метод setBodyContent() и сохранять объект bodyContent "вручную", аналогично тому, как это мы делали с объектом pageContext в предыдущих примерах.

Поскольку объект содержимого тела включает только тело вашего конкретного тэга, вам будет необходимо вызывать метод getEnclosingWriter(), чтобы получить верный выходной поток.

Что является реальной причиной возникновения цикла - это возвращаемое значение. Если метод doAfterBody() возвращает константу EVAL_BODY_BUFFERED, то контейнер будет обрабатывать тело тэга и вызовет метод снова. Если метод возвращает SKIP_BODY, то цикл прекращается и вам предоставляется возможность послать содержимое тела в прилагающийся поток writer'а, ваши значения будут отображены на экране браузера.

Теперь осталось только создать запись о тэге в TLD файле.

<tag>

<name>primetag</name>

<tagclass>cx2.tags.PrimeNumTag</tagclass>

<bodycontent>JSP</bodycontent>

<info> Generates Prime Number sequences </info>

<attribute>

<name>start</name>

<required>false</required>

</attribute>

<attribute>

<name>end</name>

<required>true</required>

</attribute>

<variable>

<name-given>value</name-given>

<variable-class>Integer</variable-class>

<declare>true</declare>

<scope>AT_BEGIN</scope>

</variable>

</tag>

Если вы посмотрите на атрибуты тэга, вы увидите, что атрибут start не является обязательным, а атрибут end - является. Это происходит просто из-за выбранного дизайна класса. Здесь имеется в виду, что если start не указывается, используется значение по умолчанию 0, но так как (по всей видимости) существует бесконечное количество простых чисел, то хорошо бы ограничить конечное число. Вы должны помнить, что если автор JSP страницы не согласен с этим ограничением при написании JSP страницы и не обратит внимания на значение end, контейнер выбросит исключение в окно web браузера.

После тэга атрибута есть новый тэг, с которым вы еще не знакомы, это тэг <variable> со своими вложенными тэгами <name-given>, <variable-class> и <declare>. Они, как вы можете ожидать, сообщают JSP контейнеру о переменной, которая добавляется в контекст страницы вашим тэгом. Так как эта переменная является объектом, а не JavaBean'ом, нет автоматического механизма, чтобы сообщить контейнеру тип переменной, так что вам необходимо сделать это с помощью такого тэга. Значения этих тэгов перечисляется в конце этой главы, но давайте взглянем на некоторые из них сейчас.

Тэг <name-given> сообщает контейнеру, какое имя дается используемой переменной. Вы можете использовать другой тэг, <name-from-attribute> в этом месте, который позволит вам указать имя атрибута, значение времени трансляции которого будет содержать имя вашей переменной. Таким образом, вы можете сделать имя в зависимости от некоторых других значений времени трансляции.

Тэг <variable-class> сообщает контейнеру переменную какого типа необходимо создать, класс, с указанным именем, должен содержаться в classpath во время трансляции, а именно в то время, когда JSP страница компилируется в первый раз на сервере. Чаще всего вы будете использовать стандартные типы, находящиеся в java.lang.

Тэг <declare> сообщает контейнеру нужно или нет декларировать эту переменную. Это предназначено для дальнейших реализаций JSP. Пока же вы всегда будете желать, чтобы переменная декларировалась, что является значением по умолчанию.

Значение <scope> сообщает контейнеру в каком месте вашего скрипта переменная должны быть доступна автору JSP страницы. Возможные значения: NESTED - что делает переменную доступной только между начальным и конечным тегами на JSP странице; AT_BEGIN - что делает переменную доступной между начальным тэгом и концом страницы; или AT_END - что делает переменную доступной после конечного тэга до конца страницы.

Во время написания наблюдались некоторые проблемы в текущей реализации Tomcat (4.0.4) при чтении тэга <attribute>. По этой причине вы можете использовать более продвинутую и мощную технику класса TagExtraInfo. Это влечет за собой замену тэга <variable> на тэг, называемый <teiclass> или тэг класса дополнительной информации. Более детально это описано ниже в этой главе.

Тэги внутри Тэгов

Тэги также могут помещаться внутри других тэгов, что дает нам мощную структурную функциональность, а также возможность создавать вывод при условии, когда дочерние тэги вычисляются только при определенных условиях, устанавливаемых в их родительских тэгах. JSTL, Java Standard Tag Libraries, в полной мере использует это, но давайте взглянем на то, как мы можем создать подобный тэг самостоятельно.

Теперь, когда вы чувствуете себя немного более комфортно с исключениями в тэгах с помощью API JSP, нам необходимо только рассмотреть ключевые моменты следующего тэга. Предположим, что вы используете тэг генерации простых чисел, и вы хотите проверить каждое простое число, чтобы убедиться, что это простое число типа "Ферма" и показать его в браузере. Числа Ферма - это такие числа, которые могут быть представлены, как "2 в степени 2 в степени n плюс 1", где n - целое число. Если ваши глаза тускнеют от математических описаний, не беспокойтесь. Достаточно сказать, что некоторые простые числа являются простыми числами Ферма, а другие нет. Фактически, только числа 3, 5, 17, 257, 65537 являются известными простыми числами Ферма.

Так как тэг проверки простых чисел Ферма предназначен, чтобы выполнять проверку каждого числа, сгенерированного тэгом простых чисел, очевидно, что нет смысла, чтобы тэг fermatprimetag существовал вне тэга primenumtag. Это значит, что он должен быть определен, как дочерний тэг, что помешает пользователям библиотеки тэгов, содержащей этот тэг, совершить ошибку и означает, что вы можете сделать определенные допущения. Это можно проиллюстрировать в следующем коде. Вот класс тэга:

public class FermatPrimeTag extends BodyTagSupport {

public int doStartTag() throws JspException {

PrimeNumTag parentTag =(PrimeNumTag)findAncestorWithClass(this,

PrimeNumTag.class);

if (parentTag == null) {

throw new JspException("Tag should be nested in

\"primenumtag\" Tag");

}

return EVAL_BODY_TAG;

}

 

public int doAfterBody() throws JspException {

 

Integer prime =(Integer)pageContext.getAttribute("value");

String s = bodyContent.getString();

try

{

if (PrimeUtilities.isFermatPrime(prime.intValue())) {

bodyContent.clearBody();

bodyContent.println(s + " (is a Fermat Prime Number) ");

}

bodyContent.writeOut(bodyContent.getEnclosingWriter());

} catch(IOException ioe) {

throw new JspException(ioe.getMessage());

}

return SKIP_BODY;

}

}

Обратите внимание на метод findAncestorWithClass(). Он рекурсивно проходит всю иерархию тэгов в поисках родителей до тех пор, пока не найдет того, кто соответствует классу, который вы ищите. Этот метод работает посредством рекурсивного вызова метода getParent(). Это еще одна часть управления тэгом, которую мы наследуем от класса BodyTagSupport. Если вы не будете наследовать от этого класса, вам необходимо реализовать методы setParent() и getParent() самостоятельно. Формирователь вызывается контейнером и передает вам ссылку на родительский тэг. Вы должны были бы сохранять эту ссылку для обработки запроса метода getParent().

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

Если метод findAncestorWithClass() не найдет родительский тэг подходящего типа, будет выброшено исключение, которое появится в окне клиентского браузера. Это скажет пользователю JSP библиотеки, что он использует тэг неправильно.

Другая важная вещь, которую необходимо заметить, это то, что этот тэг вызывает метод getAttribute() для объекта pageContext, чтобы получить значение атрибута с именем value. Это тот атрибут, который добавляется в контекст страницы родительским тэгом primenumtag. Мы получаем доступ к нему по той причине, что наш дочерний тэг fermatprimetag и наш родительский тэг primenumtag находятся на одной странице и поэтому разделяют один и тот же объект pageContext. Помните, что вы все еще должны очищать содержимое тела и получать вложенный writer. Реально здесь вы заменяете существующее простое число на строку, отображающую простое число и сообщение, гласящее ".. is a Fermat Prime Number.".

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

Классы Тэгов

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

Приведенная ниже таблица описывает некоторые полезные интерфейсы в API обработчика тэга:

Интерфейс	Описание	Когда использовать
Tag	Основной обработчик Тэга, от которого должны наследоваться все другие классы и интерфейсы	Используйте это, если хотите реализовать специфическое поведение для каждого метода, или если ваш обработчик тэга должен наследоваться от другого класса. В последнем случае, этот класс наследуется не напрямую, а через один из классов, которые его реализуют, например TagSupport..
IterationTag	Определяет механизм цикла для тэга путем добавления метода doAfterBody() к интерфейсу Tag.	Используйте это, если не хотите использовать интерфейс Tag, но вам требуется, чтобы ваш тэг был итеративный. В противном случае используйте его через один из классов-реализаций, например BodyTagSupport.
BodyTag	Определяет механизм для обработки содержимого тела тэга путем добавления методов setBodyContent() и doInitBody() к интерфейсу Tag.	Используйте это, если вы хотите использовать интерфейс Tag, но вашему тэгу необходимо обрабатывать каким-либо образом содержимое своего тела. В противном случае используйте его через класс BodyTagSupport.
TryCatchFinally	Позволяет реализатору создать код обработки исключения, который перехватывает любое исключение, выбрасываемое в обработчике.	Используйте это, если вам необходимо специфическое поведение (особенно при использовании finally) или если вам нужно, чтобы исключения не отображались в окне клиентского web браузера.

Эта таблица описывает некоторые полезные классы в API обработчика тэгов:

Класс	Описание	Когда использовать
TagSupport	Простой класс, который реализует интерфейсы Tag и IterationTag и предоставляет полезное поведение по умолчанию для создания основных или итеративных тэгов.	Используйте это, если хотите реализовать минимальный тэг или итеративный тэг, не делая много работы и вам не нужен класс обработчика для реализации других интерфейсов.
BodyTagSupport	Простой класс, который расширяет класс TagSupport и определяет поведение для обработки содержимого тела, реализуя интерфейс BodyTag.	Используйте это, если хотите реализовать тэг или итеративный тэг, который управляет содержимым своего тела, и вам не нужен обработчик тэга, реализующий никакой другой интерфейс.

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

Эта таблица описывает два класса-компаньона наиболее часто используемых обработчиками тэга.

Класс	Описание	Когда использовать
BodyContent	Класс, который инкапсулирует содержимое тела тэга и позволяет управлять им.	Вам будет необходимо использовать этот класс, когда вы будете манипулировать содержимым тела вашего тэга.
PageContext	Класс, который позволяет хранить и получать доступ к атрибутам JSP страницы. Экземпляр этого класса, к которому вы получаете доступ в обработчике тэга, является тем же самым, который доступен через JSP страницу.	Используйте этот класс для создания атрибутов и bean'ов, доступных в JSP странице.

Некоторые Дополнительные Особенности Tag'а