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

javax.servlet.jsp.tagext
Класс JspFragment

java.lang.Object
  javax.servlet.jsp.tagext.JspFragment

public abstract class JspFragment
расширяет java.lang. Объект

Инкапсулирует часть кода JSP в объекте, который может быть вызван так много раз как необходимый. Фрагменты JSP определяются, используя синтаксис JSP в качестве тела тега для вызова к обработчику SimpleTag, или как тело <jsp:attribute> стандартного действия, определяющего значение атрибута, который объявляется как фрагмент, или иметь тип JspFragment в TLD.

Определение фрагмента JSP должно только содержать шаблонный текст и элементы действия JSP. Другими словами это не должно содержать scriptlets или scriptlet выражения. Во время преобразования контейнер генерирует реализацию краткого обзора JspFragment class, способный к выполнению определенного фрагмента.

Обработчик тега может вызвать нуль фрагмента или больше раз, или передать его другим тегам перед возвратом. Чтобы передать значения к/от фрагменту JSP, обработчики тега хранят/получают значения в JspContext, связанном с фрагментом.

Отметьте, что разработчики библиотеки тега и авторы страницы не должны генерировать реализации JspFragment вручную.

Примечание реализации: не необходимо генерировать отдельный class для каждого фрагмента. Одна возможная реализация должна генерировать единственного помощника class для каждой страницы, которая реализует JspFragment. На конструкцию различитель можно передать, чтобы выбрать, какой фрагмент, который выполнит экземпляр.

С тех пор:

JSP 2.0

Сводка конструктора

JspFragment()

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

abstract JspContext	getJspContext() Возвращает JspContext, который связывается с этим JspFragment.
abstract void	invoke(java.io.Writer out) Выполняет фрагмент и направляет весь вывод к данному Писателю, или JspWriter, возвращенный getOut () метод JspContext, связанного с фрагментом, если нуль.

Методы, наследованные от class java.lang. Объект

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

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

JspFragment

public JspFragment()

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

вызвать

public abstract void invoke(java.io.Writer out)
                     throws JspException,
                            java.io.IOException

Выполняет фрагмент и направляет весь вывод к данному Писателю, или JspWriter, возвращенный getOut () метод JspContext, связанного с фрагментом, если нуль.

Параметры:

out - Писатель, чтобы вывести фрагмент к, или нуль, если вывод должен быть отправлен JspContext.getOut ().

Броски:

JspException - Брошенный, если ошибка произошла, вызывая этот фрагмент.

SkipPageException - Брошенный, если страница, которая (любой прямо или косвенно) вызвала обработчик тега, который вызвал этот фрагмент, должна прекратить оценку. Контейнер должен выдать это исключение если Классический Обработчик Тега возвращенный Тег. SKIP_PAGE или если Простой Обработчик Тега бросил SkipPageException.

java.io.IOException - Если была ошибка, пишущий в поток.

getJspContext

public abstract JspContext getJspContext()

Возвращает JspContext, который связывается с этим JspFragment.

Возвраты:

JspContext используется этим фрагментом во время вызова.