Все классы и интерфейсы Java Server Pages
         

Все классы и интерфейсы Java Server Pages


public getParent()

Получает родителя (ближайший содержащий обработчик тэга) данного обработчика тэга.

Метод getParent() может использоваться для навигации по структуре вложенного обработчика тэга на этапе прогона для кооперации нескольких акций; например, метод findAncestorWithClass() в TagSupport предоставляет удобный способ выполнения этого.

Текущая версия спецификации предоставляет только один формальный способ обозначения рассматриваемого типа обработчика тэга: класс реализации обработчика тэга, описанный в субэлементе tag-class элемента tag. Он расширяется в неформальной манере, давая автору библиотеки тэгов возможность указывать в субэлементе description рассматриваемый тип. Тип должен быть подтипом класса реализации обработчика тэга или void. Это дополнительное ограничение может быть обработано специализированным контейнером, который знает о об этой конкретной библиотеке тэгов, как в случае со стандартной библиотекой тэгов JSP.


public getParent()

Экземпляр Tag'а, ближайший содержащий данный экземпляр тэга.

См. также:



Все классы и интерфейсы Java Server Pages


public java.lang.String getPrefixString()

Префикс назначенный этой taglib.



Все классы и интерфейсы Java Server Pages


public getPreviousOut()

Получить окружающий out JspWriter.

Возвращает:содержащий JspWriter из bodyContent'а.



 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ |  |  | 

ДЕТАЛИ:   |  | 

Все классы и интерфейсы Java Server Pages


public abstract java.io.Reader getReader()

Возвращает значение данного BodyContent'а как Reader.

Возвращает:значение данного BodyContent'а как Reader.



Все классы и интерфейсы Java Server Pages


public java.lang.String getReliableURN()

"Надёжное" URN, указанное в TLD. Может использоваться утилитами авторизации в качестве глобального идентификатора (атрибут uri) при создании директивы include для данной библиотеки.



Все классы и интерфейсы Java Server Pages


public abstract int getRemaining()

Этот метод возвращает количество неиспользуемых байтов в буфере.

Возвращает:количество неиспользуемых байтов в буфере.



Все классы и интерфейсы Java Server Pages


public abstract javax.servlet.ServletRequest getRequest()

Текущее значение объекта request (ServletRequest).

Возвращает:ServletRequest для данного PageContext'а.



Все классы и интерфейсы Java Server Pages


public java.lang.String getRequiredVersion()

Строка, описывающая требуемую версию JSP-контейнера.



Все классы и интерфейсы Java Server Pages


public abstract javax.servlet.ServletResponse getResponse()

Текущее значение объекта response (ServletResponse).

Возвращает:ServletResponse для данного PageContext'а.



Все классы и интерфейсы Java Server Pages


public java.lang.Throwable getRootCause()

Возвращает исключение, вызвавшее данное JSP-исключение.

Возвращает: Throwable, вызвавшее данное JSP-исключение.

 

 ПРЕДЫДУЩИЙ КЛАСС   

ФРЭЙМЫ

   БЕЗ ФРЭЙМОВ

РЕЗЮМЕ:  ВНУТРЕННИЙ | ПОЛЕ |  | 

ДЕТАЛИ:  ПОЛЕ |  | 

Все классы и интерфейсы Java Server Pages


public int getScope()

Тело элемента  <scope>.

Возвращает:Область видимости, даваемая переменной.

 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ | ПОЛЕ |   | 

ДЕТАЛИ:  ПОЛЕ |  | 

public int getScope()

 

    СЛЕДУЮЩИЙ КЛАСС

   

РЕЗЮМЕ:  ВНУТРЕННИЙ |  |  | 

ДЕТАЛИ:   |  | 

Все классы и интерфейсы Java Server Pages


public abstract javax.servlet.ServletConfig getServletConfig()

Экземпляр ServletConfig'а.

Возвращает:ServletConfig для данного PageContext'а.



Все классы и интерфейсы Java Server Pages


public abstract javax.servlet.ServletContext getServletContext()

Экземпляр ServletContext'а.

Возвращает:ServletContext для данного PageContext'а.



Все классы и интерфейсы Java Server Pages


public abstract javax.servlet.http.HttpSession getSession()

Текущее значение объекта session (HttpSession).

Возвращает:HttpSession для данного PageContext'а или null.



Все классы и интерфейсы Java Server Pages


public java.lang.String getShortName()

Предпочтительное краткое имя (prefix), как указано в TLD. Может использоваться утилитами авторизации в качестве предпочтительного префикса при создании директивы include для данной библиотеки.



Все классы и интерфейсы Java Server Pages


public java.lang.String getSmallIcon()

Получает путь к маленькой иконке.

Возвращает:путь к маленькой иконке, отображаемой утилитами.



Все классы и интерфейсы Java Server Pages


public abstract java.lang.String getSpecificationVersion()

Возвращает номер версии спецификации JSP, которая поддерживается данной JSP-машиной.

Спецификация номера версии состоит из положительных десятичных целых чисел, разделённых точками ".", например, "2.0" или "1.2.3.4.5.6.7". Это позволяет использовать расширяемый номер для обозначения major, minor, micro и др. версий. Номер версии обязан начинаться с цифры.

Возвращает:версию спецификации, null возвращается, если версия не известна.

 

 ПРЕДЫДУЩИЙ КЛАСС   

ФРЭЙМЫ    БЕЗ ФРЭЙМОВ

РЕЗЮМЕ:  ВНУТРЕННИЙ | ПОЛЕ |  | 

ДЕТАЛИ:  ПОЛЯ |  | 

Все классы и интерфейсы Java Server Pages


public abstract java.lang.String getString()

Возвращает значение данного BodyContent'а как String.

Возвращает:значение данного BodyContent'а как String.



Все классы и интерфейсы Java Server Pages


public getTag(java.lang.String shortname)

Получает TagInfo для данного имени тэга, просматривая все тэги данной библиотеки тэгов.

Параметры:shortname - краткое имя (не prefix/префикс) тэга.

 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ |  |   | 

ДЕТАЛИ:   |  | 

Все классы и интерфейсы Java Server Pages


public java.lang.String getTagClassName()

Имя класса, предоставляющего обработчик для данного тэга.

Возвращает:имя класса обработчика тэга.



Все классы и интерфейсы Java Server Pages


public getTagExtraInfo()

Экземпляр (если имеется) для дополнительной информации тэга.

Возвращает:экземпляр TagExtraInfo, если имеется.



Все классы и интерфейсы Java Server Pages


public final getTagInfo()

Получает TagInfo для данного класса.

Возвращает:TagInfo, которого расширяет данный экземпляр.

 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ | ПОЛЕ |  | 

ДЕТАЛИ:  ПОЛЕ |  | 

Все классы и интерфейсы Java Server Pages


public getTagLibrary()

Экземпляр TabLibraryInfo, к которому мы (?) принадлежим.

Возвращает:экземпляр библиотеки тэгов, к которому мы принадлежим.



Все классы и интерфейсы Java Server Pages


public java.lang.String getTagName()

Имя Tag'а.

Возвращает:имя (краткое) тэга.



Все классы и интерфейсы Java Server Pages


public [] getTags()

Массив, описывающий тэги, определённые данной библиотекой тэгов.



Все классы и интерфейсы Java Server Pages


public [] getTagVariableInfos()

Получает TagVariableInfo-объекты, ассоциированные с данным TagInfo.

Возвращает:TagVariableInfo-объекты, ассоциированные с данным TagInfo.



Все классы и интерфейсы Java Server Pages


public java.lang.String getTypeName()

Тип (как String) данного атрибута.

Возвращает:тип атрибута.



Все классы и интерфейсы Java Server Pages


public java.lang.String getURI()

Значение атрибута uri.



Все классы и интерфейсы Java Server Pages


public java.lang.Object getValue(java.lang.Stringk)

Получает значение, ассоциированное с ключом.

Параметры:k - строка-ключ.



Все классы и интерфейсы Java Server Pages


public java.util.Enumeration getValues()

Перечисляет значения, хранимые данным обработчиком тэга.

 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ |  |   | 

ДЕТАЛИ:   |  | 

Все классы и интерфейсы Java Server Pages


public [] getVariableInfo(data)

Получает информацию о переменных скриптинга, определённых тэгом, ассоциированным с данным экземпляром TagExtraInfo. Атрибуты времени запроса обозначены как таковые в параметре TagData.

Параметры:data - TagData-экземпляр.

Возвращает:Массив VariableInfo-данных.


public [] getVariableInfo(data)

Информация об объектах скриптинга, созданных данным тэгом на этапе прогона.

Это удобный метод ассоциированного TagExtraInfo-класса.

По умолчанию null, если тэг не имеет атрибута "id", иначе -  {"id", Object}

Параметры:data - TagData, описывающий данную акцию .

Возвращает:Массив VariableInfo-элементов.



HandlePageException


public abstract void handlePageException(java.lang.Exceptione) throws javax.servlet.ServletException, java.io.IOException

Этот метод предназначен для процессинга/обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP странице ошибок или, если ничего не было специфицировано, для выполнения какой-либо специфицированной реализацией акции.

Класс реализации JSP обычно должен будет зачистить локальный статус до вызова этого метода и сразу после этого возвратить управление. Недопустимой является генерация вывода клиенту или модификация статуса ServletResponse'а после вызова этого метода.

Этот метод сохранён для обеспечения обратной совместимости. Вновь генерируемый код должен использовать PageContext.handlePageException(Throwable).

Параметры:e - обрабатываемое исключение.

Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionNullPointerException - если exception - null.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.

См. также:


public abstract void handlePageException(java.lang.Throwable t) throws javax.servlet.ServletException, java.io.IOException

Этот метод идентичен методу handlePageException(Exception), за исключением того, что он принимает Throwable. Это предпочтительный метод для использования, так как он позволяет создавать соответствующую реализацию семантики errorpage.

Этот метод предназначен для процессинга/обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP странице ошибок или, если ничего не было специфицировано, для выполнения какой-либо специфицированной реализацией акции.

Класс реализации JSP обычно должен будет зачистить локальный статус до вызова этого метода и сразу после этого возвратить управление. Недопустимой является генерация вывода клиенту или модификация статуса ServletResponse'а после вызова этого метод.

Параметры:t - обрабатываемый throwable.

Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionNullPointerException - если exception - null.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.

См. также:



ID


public static final java.lang.String ID

"id" привязывается как ID. Нет никакого реального преимущества при использовании его как-нибудь ещё, так как IDREFs не обрабатываются иначе.

Конструктор. Детали.



Иерархия Интерфейсов


interface javax.servlet.Servlet

interface javax.servlet.jsp.

interface javax.servlet.jsp.

 

 НАЗАД   

   

Иерархия Интерфесов


interface javax.servlet.jsp.tagext.

interface javax.servlet.jsp.tagext.

interface javax.servlet.jsp.tagext.

interface javax.servlet.jsp.tagext.

 

    ВПЕРЁД

   

Иерархия Классов


class java.lang.Object

class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext. (implements java.lang.Cloneable) class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext. (implements javax.servlet.jsp.tagext., java.io.Serializable)

class javax.servlet.jsp.tagext. (implements javax.servlet.jsp.tagext.)

class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class javax.servlet.jsp.tagext.class java.io.Writer

class javax.servlet.jsp.

class javax.servlet.jsp.tagext.


class java.lang.Object

class javax.servlet.jsp.class javax.servlet.jsp.class javax.servlet.jsp.class java.lang.Throwable (implements java.io.Serializable)

class java.lang.Exception

class javax.servlet.jsp.

class javax.servlet.jsp.

class java.io.Writer

class javax.servlet.jsp.



Include


public abstract void include(java.lang.String relativeUrlPath) throws javax.servlet.ServletException, java.io.IOException

Вызывает обработку специфицированного ресурса как части текущих ServletRequest и ServletResponse, обрабатываемых вызывающим Thread. Вывод обрабатываемых запросом целевых ресурсов записывается непосредственно в поток вывода ServletResponse'а.

Текущий "out" JspWriter'а для данной JSP очищается, в качестве побочного эффекта этого вызова, до обработки include.

Если relativeUrlPath начинается с "/", специфицированный URL вычисляется относительно DOCROOT ServletContext'а

для данной JSP.

Если путь не начинается с "/", специфицированный URL вычисляется относительно URL запроса, который был отображён в вызывающую JSP.

Верным является только вызов этого метода из Thread, выполняющегося внутри метода _jspService(...) в JSP.

Параметры:relativeUrlPath - специфицирует относительный путь URL к включаемому целевому ресурсу.

Вызывает:javax.servlet.ServletExceptionjava.io.IOExceptionjava.lang.IllegalArgumentException - если URL целевого ресурса неразрешим.java.lang.SecurityException - если целевой ресурс не может быть достигнут взывающим.



Info


protected java.lang.String info

Конструктор. Детали.



Initialize


public abstract void initialize(javax.servlet.Servletservlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush) throws java.io.IOException, java.lang.IllegalStateException, java.lang.IllegalArgumentException

Метод initialize вызывается для инициализации неинициализированного PageContext'а так, что он (РС) может быть использован классом Реализации JSP для обслуживания входящего запроса и ответа внутри метода _jspService().

Этот метод обычно вызывается из JspFactory.getPageContext(), чтобы инициализировать статус.

Этот метод нужен для создания начального JspWriter'а и ассоциирования имени "out'а" в области видимости page с этим вновь созданным объектом.

Этот метод не должен использоваться авторами страниц или библиотек тэгов.

Параметры:servlet - Servlet, ассоциированный с данным PageContext'омrequest - текущий запрос в данном Servlet'еresponse - текущий ответ для данного Servlet'аerrorPageURL - значение атрибута errorpage из директивы page или nullneedsSession - значение атрибута session из директивы pagebufferSize - значение атрибута buffer из директивы pageautoFlush - значение атрибута autoflush из директивы pageВызывает:java.io.IOException - во время создания JspWriterjava.lang.IllegalStateException - если out некорректно инициализирован



IsAutoFlush


public boolean isAutoFlush()

Этот метод указывает, очищается ли JspWriter автоматически (autoFlush).

Возвращает:очищается ли JspWriter автоматически, или вызывает исключение IOExceptions при выполнении условий переполнения буфера.

 

    

   

РЕЗЮМЕ:  ВНУТРЕННИЙ |  |  | 

ДЕТАЛИ:   |  | 

IsRequired


public boolean isRequired()

Необходим ли/required атрибут.

Возвращает:необходим ли атрибут.



IsValid


public boolean isValid( data)

Проверка атрибутов на этапе трансляции. Атрибуты времени запроса обозначены как таковые в параметре TagData.

Параметры:data - TagData-экземпляр.

Возвращает:верен ли данный экземпляр тэга.


public boolean isValid( data)

Проверка атрибутов на этапе трансляции. Это удобный метод ассоциированного TagExtraInfo-класса.

Параметры:data - экземпляр TagData времени трансляции.Возвращает:верны ли данные.



Javax.servlet.jsp Интерфейс HttpJspPage


public abstract interface HttpJspPageextends

Интерфейс HttpJspPage описывает взаимодействие, которое Класс Реализации JSP-Страницы обязан выполнять при использовании протокола HTTP.

Поведение идентично JspPage, за исключением подписи метода _jspService, который теперь выражается в системе типов Java и включён в интерфейс явно.

См. также:

Метод. Резюме.
void (javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)

          Метод _jspService() соответствует телу JSP-страницы.

 

Методы, унаследованные от интерфейса javax.servlet.jsp.
,

 

Методы, унаследованные от интерфейса javax.servlet.Servlet
destroy, getServletConfig, getServletInfo, init, service

Метод. Детали.



Javax.servlet.jsp Интерфейс JspPage


Все Известный Субинтерфейсы:

public abstract interface JspPageextends javax.servlet.Servlet

Интерфейс JspPage описывает общее взаимодействие, которое класс Реализации JSP-Страницы обязан выполнять; страницы, использующие протокол HTTP, описаны интерфейсом HttpJspPage.

Методы Два плюс Один/Two plus One

Этот интерфейс определяет протокол с 3 методами; только два из них: jspInit() и jspDestroy() являются частью данного интерфейса, так как подпись/signature третьего метода: _jspService() зависит от специфики используемого протокола и не может быть выражена общим способом в Java.

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

Методы jspInit() и jspDestroy() могут определяться автором JSP, но метод _jspService() определяется автоматически JSP-процессором на базе содержимого JSP-страницы.

_jspService()

Метод _jspService() соответствует телу/body JSP-страницы. Этот метод определяется автоматически JSP-контейнером и никогда не должен определяться автором JSP.

Если суперкласс специфицируется с использованием атрибута extends, этот суперкласс может избрать выполнение некоторых акций в методе service() до или после вызова метода _jspService().

См. использование атрибута extends в главе JSP_Машина спецификации JSP.

Специфика подписи/signature зависит от протокола, поддерживаемого JSP-страницей.

public void _jspService(ServletRequestSubtype request, ServletResponseSubtype response) throws ServletException, IOException;

Метод. Резюме.
void ()

          Метод jspDestroy() вызывается при уничтожении JSP-страницы.
 void ()

         Метод jspInit() вызывается при инициализации JSP-страницы.

 

Методы, унаследованные от интерфейса javax.servlet.Servlet
destroy, getServletConfig, getServletInfo, init, service

Метод. Детали.



Javax.servlet.jsp Класс JspEngineInfo


java.lang.Object | +--javax.servlet.jsp.JspEngineInfo

public abstract class JspEngineInfoextends java.lang.Object

JspEngineInfo это абстрактный класс, предоставляющий информацию о текущей JSP-машине.

Конструктор. Резюме.
()

Метод.Резюме.
abstract  java.lang.String ()

          Возвращает номер версии спецификации JSP, которая поддерживается данной JSP-машиной.

 

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструктор. Детали.



Javax.servlet.jsp Класс JspException


java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +--javax.servlet.jsp.JspException

Прямые Известные Подклассы:

public class JspExceptionextends java.lang.Exception

Общее исключение, известное JSP-машине; неотловленное JspExceptions приводит к вызову механизма errorpage.

См. также:

Конструктор. Резюме.
()

Конструирует JspException.
(java.lang.String msg)

          Конструирует новое JSP-исключение со специфицированным сообщением.
(java.lang.String message, java.lang.Throwable rootCause)

          Конструирует новое JSP-исключение, когда JSP нужно вызывать исключение, и включает сообщение об "основной причине" исключения, которая конфликтует с нормальным ходом процесса, включая сообщение описания.
(java.lang.Throwable rootCause)

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

Метод. Резюме.
 java.lang.Throwable ()

          Возвращает исключение, вызвавшее это JSP-исключение.

 

Методы, унаследованные от класса java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString

 

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Конструктор. Детали.



Javax.servlet.jsp Класс JspFactory


java.lang.Object | +--javax.servlet.jsp.JspFactory

public abstract class JspFactoryextends java.lang.Object

JspFactory это абстрактный класс, определяющий несколько "фабричных"/factory методов, доступных JSP-странице на этапе прогона, для создания экземпляров различных интерфейсов и классов, используемых для поддержки реализации JSP.

Соответствующая требованиям реализация JSP-Машины будет в процессе своей инициализации инстанциировать зависящий от реализации подкласс этого класса и сделает его глобально доступным для использования классами реализации JSP посредством регистрации экземпляра, созданного данным классом с помощью static-метода setDefaultFactory().

Классы PageContext и JspEngineInfo являются единственными зависящими от реализации классами, которые могут создаваться только в фактории.

Объекты JspFactory не должны использоваться авторами JSP-страниц.

Конструктор. Резюме.
()

Метод. Резюме.
static  ()

           
abstract   ()

           вызывается для получения специфической для данной реализации информации о текущей JSP-машине.
abstract   (javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int buffer, boolean autoflush)

           получает экземпляр зависящего от реализации абстрактного класса javax.servlet.jsp.PageContext для вызова Servlet и текущего обслуживания запроса и ответа.
abstract  void ( pc)

           вызывается для освобождения ранее размещённого объекта PageContext.
static void ( deflt)

           установить факторию по умолчанию для данной реализации.

 

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструктор. Детали.



Javax.servlet.jsp Класс JspTagException


java.lang.Object | +--java.lang.Throwable | +--java.lang.Exception | +-- | +--javax.servlet.jsp.JspTagException

public class JspTagExceptionextends

Исключение, используемое Обработчиком Тэга для указания на непреодолимую ошибку. Эта ошибка отлавливается на верхнем уровне JSP-страницы и выводит страницу об ошибках.

См. также:

Конструктор. Резюме.
()

Нет сообщения.
(java.lang.String msg)

          Конструктор с сообщением..

Методы, унаследованные от класса javax.servlet.jsp.

 

Методы, унаследованные от класса java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString

 

Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Конструктор. Детали.



Javax.servlet.jsp Класс JspWriter


java.lang.Object | +--java.io.Writer | +--javax.servlet.jsp.JspWriter

Прямые Известные Подклассы:

public abstract class JspWriterextends java.io.Writer

Акции и шаблонные данные на JSP-странице записываются с использованием JspWriter-объекта, на который ссылаются через неявную переменную out, инициализируемую автоматически, через использование методов в PageContext-объекте.

Этот абстрактный класс эмулирует некоторую функциональность классов java.io.BufferedWriter и java.io.PrintWriter, однако отличие в том, что он взывает java.io.IOException из методов print, в то время как PrintWriter этого не делает.

Буферизация

Начальный/initial JspWriter-объект ассоциируется с PrintWriter-объектом ServletResponse'а способом, зависящим от того, буферизуется страница или нет. Если страница буферизуется, вывод, записываемый в этот JspWriter-объект, будет записываться непосредственно через PrintWriter, который, если необходимо, будет создаваться путём вызова метода getWriter() в объекте response. Но если страница буферизуется, PrintWriter-объект не будет создаваться, пока буфер не очистится и операции типа setContentType() являются законными. Поскольку такая гибкость значительно упрощает программирование, буферизация в JSP-страницах выполняется по умолчанию.

Буферизация затрагивает вопрос: что делать, если буфер заполнен?

Есть два подхода к решению этой проблемы:

Переполнение буфера не является фатальной ошибкой; если буфер заполнен, вывод просто очищается.

Переполнение буфера является фатальной ошибкой; если буфер заполнен, вызывается исключение.

Оба подхода являются верными, и, соответственно, оба поддерживаются JSP-технологией. Поведение страницы контролируется атрибутом autoFlush, который по умолчанию - true. В общем, JSP-страницы, которым необходима гарантия корректности и полноты данных, высылаемых клиенту, могут установить атрибут autoFlush в false, что обычно делается в случае, если клиентом является само приложение. С другой стороны, JSP-страницы, отсылающие данные клиенту, могут даже после частичного конструирования установить атрибут autoFlush в true; что делается тогда, когда данные сразу выводятся через браузер. Каждое приложение действует в соответствии со своими потребностями.


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

Неявная переменная "out" класса реализации JSP имеет этот тип. Если директива page избирает autoflush="true", тогда все операции I/O (ввода-вывода) этого класса автоматически очищают содержимое буфера, если условие overflow/переполнение могло бы возникнуть при выполнении текущей операции без очистки. Если autoflush="false", тогда все операции I/O (ввода-вывода) этого класса будут вызывать исключение IOException, если при выполнении текущей операции приводит к условию overflow/переполнения буфера.

См. также:Writer, java.io.BufferedWriter, PrintWriter

Поле. Резюме.
protected boolean

           
protected  int

           
static int

          константа, указывающая, что Writer буферизуется и использует размер буфера по умолчанию для данной реализации.
static int

          константа, указывающая, что Writer не буферизует вывод.
static int

          константа, указывающая, что Writer буферизуется и размер буфера не ограничен; это используется в BodyContent.
 
Поля, унаследованные от класса java.io.Writer
lock
Конструктор. Резюме.
protected (int bufferSize, boolean autoFlush)

          protected-конструктор.
Метод. Резюме.
abstract  void ()

          Очищает содержимое буфера.
abstract  void ()

          Очищает текущее содержимое буфера.
abstract  void ()

          Закрывает поток, предварительно очистив его. Этот метод не должен вызываться явно для начального/initial JspWriter'а, так как код, генерируемый JSP-контейнером, будет автоматически включать вызов close().
abstract  void ()

          Очищает поток.
 int ()

          Этот метод возвращает размер буфера, используемого JspWriter'ом.
abstract  int ()

          Этот метод возвращает количество неиспользуемых байтов буфера.
 boolean ()

          Этот метод указывает, очищается ли JspWriter автоматически.
abstract  void ()

          Записывает символы новой строки.
abstract  void (boolean b)

          Печатает булево значение.
abstract  void (char c)

          Печатает символ.
abstract  void (char[] s)

          Печатает массив символов.
abstract  void (double d)

          Печатает число с плавающей точкой двойной точности.
abstract  void (float f)

          Печатает число с плавающей точкой.
abstract  void (int i)

          Печатает целое число.
abstract  void (long l)

          Печатает длинное целое число.
abstract  void (java.lang.Object obj)

          Печатает объект.
abstract  void (java.lang.String s)

          Печатает строку.
abstract  void ()

          Заканчивает текущую строку печатью символов новой строки.
abstract  void (boolean x)

          Печатает булево значение и затем оканчивает строку.
abstract  void (char x)

          Печатает символ и затем оканчивает строку.
abstract  void (char[] x)

          Печатает массив символов и затем оканчивает строку.
abstract  void (double x)

          Печатает число с плавающей точкой двойной точности и затем оканчивает строку.
abstract  void (float x)

          Печатает число с плавающей точкой и затем оканчивает строку.
abstract  void (int x)

          Печатает целое число и затем оканчивает строку.
abstract  void (long x)

          Печатает длинное целое число и затем оканчивает строку.
abstract  void (java.lang.Object x)

          Печатает Object и затем оканчивает строку.
abstract  void (java.lang.String x)

          Печатает String и затем оканчивает строку.
<


 
Методы, унаследованные от класса java.io.Writer
write, write, write, write, write
 
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Поле. Детали.

Javax.servlet.jsp Класс PageContext


java.lang.Object | +--javax.servlet.jsp.PageContext

public abstract class PageContextextends java.lang.Object

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

Неявные объекты добавляются к pageContext автоматически.

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

Примеры использования PageContext, JspFactory и других классов в объекте Реализации JSP-Страницы можно найти повсюду.

PageContext имеет особенности, упрощающие работу авторов страниц/компонентов и реализаторов страниц, в том числе:

единый API для обслуживания пространств имён различных областей видимости;

несколько удобных API для доступа к различным public-объектам;механизм получения JspWriter'а для вывода;механизм обслуживания использования сессии страницей;механизм экспонирования ("показа") атрибутов директивы page среде скриптинга;механизмы направления или включения текущего запроса в другие компоненты приложения;механизм обработки процессов исключений errorpage;

Методы, Предназначенные для Кода, Генерируемого Контейнером

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

Методами, поддерживающими жизненный цикл, являются initialize() и release().

Методы делающие возможным обслуживание вложенных потоков JspWriter'а для реализации Расширений Тэгов: pushBody() и popBody()

Методы, Предназначенные для Авторов JSP

Некоторые методы предоставляют универсальный доступ к различным объектам, представляющим области видимости. Реализация обязана использовать фундаментальные механизмы Servlet, соответствующие данной области видимости, так что информация может быть передана вперёд и назад между Servlet'ами и JSP-страницами. Методы: setAttribute(), getAttribute(), findAttribute(), removeAttribute(), getAttributesScope() и getAttributeNamesInScope() .


Следующие методы предоставляют удобный доступ к неявным объектам:

getOut(), getException(), getPage()

getRequest(), getResponse(), getSession(), getServletConfig() и getServletContext().

Следующие методы предоставляют поддержку для направления, включения и обработки ошибок: forward(), include() и handlePageException().

Поле. Резюме.
staticjava.lang.String

          Имя, используемое для хранения ServletContext в таблице имён PageContext.
static int

          Область видимости - приложение: именованные ссылки работают в ServletContext'е, пока он не будет вызван.
static java.lang.String

          Имя, используемое для хранения ServletConfig в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения неотловленного исключения в списке атрибутов ServletRequest'а и в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения текущего JspWriter'а в таблице имён PageContext.
static java.lang.String

          Имя, используемое для хранения Servlet в таблицах имён этого PageContext.
static int

          Область видимости - страница: (это значение по умолчанию) именованные ссылки работают в этом PageContext'е до возвращения из текущего вызова метода Servlet.service().
static java.lang.String

          Имя, используемое для хранения этого PageContext'а в его собственной таблице имён.
static java.lang.String

          Имя, используемое для хранения  ServletRequest'а в таблице имён PageContext.
static int

          Область видимости - запрос: именованные ссылки работают из ServletRequest'а, ассоциированного с Servlet'ом, пока выполнение текущего запроса не будет завершено.
static java.lang.String

          Имя, используемое для хранения  ServletResponse в таблице имён PageContext'а.
static java.lang.String

          Имя, используемое для хранения  HttpSession в таблице имён PageContext'а.
static int

          Область видимости - сессия (верно, только если данная страница участвует в сессии): именованные ссылки работают из HttpSession (если имеется), ассоциированного с Servlet'ом, пока HttpSession не будет закрыта.
<


Конструктор. Резюме.
()

           
Метод. Резюме.
abstract  java.lang.Object (java.lang.String name)

          Ищет именованный атрибут в области(-ях) видимости page, request, session (если запущена) и application, в указанном порядке, и возвращает ассоциированное значение или null.
abstract  void (java.lang.String relativeUrlPath)

           Этот метод используется для перенаправления текущего ServletRequest'а и ServletResponse'а другому активному компоненту приложения.
abstract  java.lang.Object (java.lang.String name)

          Возвращает объект, ассоциированный с именем в области видимости page, или null, если объект не найден.
abstract  java.lang.Object (java.lang.String name, int scope)

          Возвращает объект, ассоциированный с именем в специфицированной области видимости, или null, если объект не найден.
abstract  java.util.Enumeration (int scope)

          Перечисляет все атрибуты в данной области видимости.
abstract  int (java.lang.String name)

          Получит область видимости, в которой определён данный атрибут.
abstract  java.lang.Exception ()

          Текущее значение объекта исключения (Exception).
abstract   ()

          Текущее значение объекта out (JspWriter).
abstract  java.lang.Object ()

          Текущее значение объекта page (Servlet).
abstract  javax.servlet.ServletRequest ()

          Текущее значение объекта request (ServletRequest).
abstract  javax.servlet.ServletResponse ()

          Текущее значение объекта response (ServletResponse).
abstract  javax.servlet.ServletConfig ()

          ServletConfig-экземпляр.
abstract  javax.servlet.ServletContext ()

          ServletContext-экземпляр.
abstract  javax.servlet.http.HttpSession ()

          Текущее значение объекта session (HttpSession).
abstract  void (java.lang.Exception e)

           Этот метод предназначен для обработки необработанного исключения уровня "page" путём перенаправления исключения специфицированной для данной JSP-страницы странице ошибок, либо, если ничего не было специфицировано, выполняя некоторое зависящее от реализации действие.
abstract  void (java.lang.Throwable t)

           Этот метод идентичен handlePageException(Exception), за исключением того, что он принимает Throwable.
abstract  void (java.lang.String relativeUrlPath)

           Вызывает обработку специфицированных ресурсов как части текущих ServletRequest и ServletResponse, обрабатываемых вызывающим Thread/потоком.
abstract  void (javax.servlet.Servlet servlet, javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, java.lang.String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)

           Метод initialize вызывается для инициализации неинициализированного PageContext'а так, что он (РС) может использоваться классом Реализации JSP для обслуживания входящих запросов и ответов внутри метода _jspService().
  ()

          Возвращает "out" предыдущего JspWriter'а, сохраняемый парным pushBody() и обновляет значение атрибута "out" в пространстве имён атрибутов из области видимости page PageConxtext'а.
  ()

          Возвращает BodyContent-объект, сохраняет текущий "out" JspWriter и обновляет значение атрибута "out" в пространстве имён атрибутов из области видимости page PageConxtext'а.
abstract  void ()

           Этот метод будет "восстанавливать/reset" начальное состояние PageContext'а, освобождая все ссылки и подготавливая PageContext для возможного использования в последующих вызовах initialize().
abstract  void (java.lang.String name)

          Удаляет ссылку на объект, ассоциированный с данным именем, просматривая во всех областях видимости в (установленном) порядке просмотра.
abstract  void (java.lang.String name, int scope)

          Удаляет ссылку на объект, ассоциированный со специфицированным именем в данной области видимости.
abstract  void (java.lang.String name, java.lang.Object attribute)

          Регистрирует имя/name и объект/object, специфицированные семантикой области видимости scope.
abstract  void (java.lang.String name, java.lang.Object o, int scope)

          Регистрирует имя/name и объект/object, специфицированные семантикой соответствующей области видимости.
 
Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Поле. Детали.

Javax.servlet.jsp.tagext Интерфейс BodyTag


Все Известные Реализующие Классы:

public abstract interface BodyTagextends

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

Обработчик тэга отвечает за манипуляции с содержимым тела. Например, обработчик тэга может взять содержимое тела, конвертировать его в String с помощью метода bodyContent.getString и затем использовать его (содержимое). Ил обработчик тэга может взять содержимое тела и записать его в содержащий JspWriter, используя метод bodyContent.writeOut.

Обработчик тэга, реализующий BodyTag, рассматривается как обработчик, реализующий IterationTag, за исключением того, что метод doStartTag может возвратить SKIP_BODY, EVAL_BODY_INCLUDE или EVAL_BODY_BUFFERED.

Если возвращено EVAL_BODY_INCLUDE, вычисление происходит, как в IterationTag.

Если возвращено EVAL_BODY_BUFFERED, будет создан BodyContent-объект (кодом, сгенерированным JSP-компилятором) для захвата вычисления тела. Код, сгенерированный JSP-компилятором, получает BodyContent-объект с помощью вызова метода pushBody текущего pageContext'а, который дополнительно сохраняет предыдущее значение out. Компилятор страницы возвращает этот объект через вызов метода popBody класса PageContext; этот вызов также восстанавливает значение out.

Этот интерфейс предоставляет одно новое свойство с setter-методом один новый метод акции.

Свойства

Имеется новое свойство, bodyContent, для получения BodyContent-объекта, в котором объект реализации JSP-страницы будет размещать результат вычисления (и повторного вычисления, если нужно) тела. Setter-метод (setBodyContent) будет вызываться только в том случае, если doStartTag() возвращает EVAL_BODY_BUFFERED.

Методы

В дополнение к setter-методу для свойства bodyContent имеется новый метод акции: doInitBody(), который вызывается сразу после setBodyContent() и перед вычислением тела. Этот метод будет вызываться только в том случае, если doStartTag() возвращает EVAL_BODY_BUFFERED.


Жизненный цикл

Детали жизненного цикла показаны на диаграмме переноса. Исключения, вызываемые при вычислении doStartTag(), setBodyContent(), doInitBody(), BODY, doAfterBody(), прерывают выполнение и помещаются на верх стэка, если только обработчик тэга не реализует интерфейс TryCatchFinally; см. детали об этом интерфейсе.



Пустая и Непустая Акция

Если TagLibraryDescriptor-файл указывает, что акция обязана всегда иметь пустую акцию, через вхождение <body-content> - "empty", то метод doStartTag() обязан возвратить SKIP_BODY.

В ином случае, метод doStartTag() может возвратить SKIP_BODY, EVAL_BODY_INCLUDE или EVAL_BODY_BUFFERED.

Если возвращено SKIP_BODY, тело не вычисляется и вызывается doEndTag().

Если возвращено EVAL_BODY_INCLUDE, setBodyContent() не вызывается, doInitBody() не вызывается, тело вычисляется и "передаётся/passed through" текущему out, doAfterBody() вызывается, а затем, после 0 или более итераций, вызывается doEndTag().

Если возвращено EVAL_BODY_BUFFERED, вызывается setBodyContent(), вызывается doInitBody(), тело вычисляется, вызывается doAfterBody(), а затем, после 0 или более итераций, вызывается doEndTag().

Поле. Резюме.
staticint

          Запрашивается создание нового буфера, BodyContent, в котором вычисляется тело этого тэга.
static int

          Не рекомендуется. Как и в Java JSP API 1.2, использовать BodyTag.EVAL_BODY_BUFFERED или IterationTag.EVAL_BODY_AGAIN.
 
Поля, унаследованные из класса javax.servlet.jsp.tagext.
 
Поля, унаследованные из класса javax.servlet.jsp.tagext.
, , ,
Метод. Резюме.
 void ()

          Подготавливает вычисление тела.
 void ( b)

          Устанавливает свойство bodyContent.
 
Методы, унаследованные из интерфейса javax.servlet.jsp.tagext.
 
Методы, унаследованные из интерфейса javax.servlet.jsp.tagext.
, , , , ,
Поле. Детали.

Javax.servlet.jsp.tagext Интерфейс IterationTag


Все Известные Субинтерейсы:

Все Известные Реализующие Классы:

public abstract interface IterationTagextends

Интерфейс IterationTag расширяет Tag, определяя один дополнительный метод, управляющий повторяющимися вычислениями тела.

Обработчик тэга, реализующий IterationTag, рассматривается как обработчик, реализующий Tag, с учётом методов doStartTag() и doEndTag(). IterationTag предоставляет новый метод: doAfterBody().

Метод doAfterBody() вызывается после каждого обсчёта тела для управления повторными вычислениями тела. Если doAfterBody() возвращает IterationTag.EVAL_BODY_AGAIN, то тело будет вычисляться ещё раз.

Если doAfterBody() возвращает Tag.SKIP_BODY, тело будет пропущено, и вместо этого будет вычислен doEndTag().

Свойства

Нет новых свойств, дополняющих свойства Tag'а.

Методы

Есть один новый метод: doAfterBody().

Жизненный цикл

Детали жизненного цикла показаны на диаграмме. Исключения, вызываемые в процессе вычисления doStartTag(), BODY и doAfterBody() прерывают выполнение и помещаются на верх стэка, если только обработчик тэга не реализует интерфейс TryCatchFinally; см. детали об этом интерфейсе.

Пустая и Непустая Акция

Если TagLibraryDescriptor-файл указывает, что акция всегда обязана иметь пустую акцию, через вхождение <body-content> - "empty", то метод doStartTag() обязан возвратить SKIP_BODY.

Иначе, метод doStartTag() может возвратить SKIP_BODY или EVAL_BODY_INCLUDE.

Если возвращено SKIP_BODY, тело не вычисляется и вызывается doEndTag().

Если возвращено EVAL_BODY_INCLUDE, тело вычисляется и "передаётся" текущему out, затем вызывается doAfterBody() и, после 0 или более итераций, вызывается doEndTag().

Поле. Резюме.
staticint

          Запрос на вычисление тела.

 

Поля, унаследованные из класса javax.servlet.jsp.tagext.
, , ,

Метод. Резюме.
 int ()

          Производит (повторное) вычисление тела.

 

Методы, унаследованные из интерфейса javax.servlet.jsp.tagext.
, , , , ,

Поле. Детали.



Javax.servlet.jsp.tagext Интерфейс Tag


Все Известные Субинтерфейсы:,

public abstract interface Tag

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

Свойства

Интерфейс Tag специфицирует setter- и getter-методы для основных свойств pageContext и parent.

Объект реализации JSP-страницы вызывает setPageContext и setParent, в указанной последовательности, до вызова doStartTag() или doEndTag().

Методы

Выполняются два главных действия: doStartTag и doEndTag. После того как соответствующие свойства инициализированы, методы doStartTag и doEndTag могут быть вызваны в обработчике тэга. Принимается, что между этими вызовами обработчик тэга поддерживает статус, который обязан быть сохранён.

После вызова doEndTag обработчик тэга доступен для последующих вызовов (и предполагается, что он сохраняет свои свойства).

Жизненный цикл

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

[1] Этот перенос предназначен для освобождения длительно хранящихся данных. Нет никаких гарантий сохранения каких-либо свойств. [2] Этот перенос происходит, если, и только если, тэг заканчивается нормально, без вызова исключения. [3] Заметьте, что, поскольку нет никаких гарантий сохранения статуса свойств, обработчик тэга, имевший установленными некоторые необязательные/optional свойства, может быть использован повторно только в том случае, если эти свойства устанавливаются в новые (известные) значения. Это означает, что такие обработчики тэгов могут использоваться повторно только с тем же "AttSet" (набором атрибутов, которые уже установлены). Просмотрите интерфейс TryCatchFinally на предмет выяснения некоторых деталей относительно обработки исключений и обслуживания ресурсов.

После того как выполнены все вызовы обработчика тэга, в нём вызывается метод release.

После того как метод release вызван, принимается, что все свойства, включая parent и pageContext, восстановлены в неспецифицированные значения. Компилятор страницы гарантирует, что release() будет вызван в обработчике Tag'а до освобождения обработчика в GC.


Пустая и Непустая Акция

Если TagLibraryDescriptor- файл указывает, что акция должна всегда иметь пустую акцию, посредством вхождения <body-content> - "empty", тогда метод doStartTag() обязан возвращать SKIP_BODY.

Иначе, метод doStartTag() может возвратить SKIP_BODY или EVAL_BODY_INCLUDE.

Если возвращено SKIP_BODY, тело, если имеется, не обсчитывается.

Если возвращено EVAL_BODY_INCLUDE, тело обсчитывается и "передаётся" текущему out.

Поле. Резюме.
staticint

          Вычисляет тело в существующем потоке out.
static int

          Продолжить обсчёт страницы.
static int

          Пропустить вычисление тела.
static int

          Пропустить остаток страницы.
Метод. Резюме.
 int ()

          Обработать конечный тэг данного экземпляра.
 int ()

          Обработать начальный тэг данного экземпляра.
  ()

          Получить родителя (ближайший содержащий обработчик тэга) данного обработчика тэга.
 void ()

          Вызывается в обработчике Tag'а для освобождения состояния.
 void ( pc)

          Устанавливает текущий контекст страницы.
 void ( t)

          Устанавливает родителя (ближайший содержащий обработчик тэга) данного обработчика тэга.
Поле. Детали.

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


public abstract interface TryCatchFinally

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

Этот интерфейс предоставляет два новых метода: doCatch(Throwable) и doFinally().

Прототип вызова таков:

h = get a Tag(); // получить обработчик тэга, возможно, из пула

h.setPageContext(pc); // инициализировать, как нужно h.setParent(null); h.setFoo("foo");

// протокол вызова тэга; см. Tag.java try { doStartTag()... .... doEndTag()... } catch (Throwable t) { // реакция на исключительное условие h.doCatch(t); } finally { // восстановление инвариантов данных и освобождение вызванных ресурсов h.doFinally(); }

... другие вызовы, возможно, с новыми setter'ами ... h.release(); // освобождение ресурсов длительного пользования

Метод. Резюме.
 void (java.lang.Throwable t)

          Вызывается. если возникает Throwable в процессе обсчёта BODY внутри тэга или в любом из следующих методов: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() и BodyTag.doInitBody().
 void ()

          Всегда вызывается после doEndTag() для любого класса, реализующего Tag, IterationTag или BodyTag.

Метод. Детали.



Javax.servlet.jsp.tagext Класс BodyContent


java.lang.Object | +--java.io.Writer | +-- | +--javax.servlet.jsp.tagext.BodyContent

public abstract class BodyContentextends

Инкапсуляция обсчёта тела акции так, что она (акция) становится доступной для обработчика тэга. BodyContent является подклассом JspWriter'а.

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

BodyContent имеет методы для конвертации своего содержимого в String, чтобы читать его содержимое, и для зачистки содержимого.

Размер буфера BodyContent-объекта не ограничен. BodyContent-объект не может находиться в режиме autoFlush. невозможно вызвать flush в BodyContent-объекте, так как отсутствует фоновый/backing поток.

Экземпляры BodyContent'а создаются путём вызова методов pushBody и popBody класса PageContext. BodyContent содержится внутри другого JspWriter (может быть, другого BodyContent-объекта), следующего в структуре их ассоциированных акций.

BodyContent становится доступным BodyTag'у через вызов setBodyContent(). Обработчик тэга может использовать этот объект/object до момента после вызова doEndTag().

Поля, унаследованные из класса javax.servlet.jsp.
, , , ,

Поля, унаследованные из класса java.io.Writer
lock

Конструктор. Резюме.
protected ( e)

          Protected-конструктор.

Метод. Резюме.
 void ()

          Зачищает тело/body без вызова исключений.
 void ()

          Переопределил flush(), поэтому это недопустимо.
  ()

          Получает содержащий JspWriter.
abstract  java.io.Reader ()

          Возвращает значение данного BodyContent'а как Reader.
abstract  java.lang.String ()

          Возвращает значение BodyContent'а как String.
abstract  void (java.io.Writer out)

          Записывает содержимое данного BodyContent'а в Writer.
<
 
Методы, унаследованные из класса javax.servlet.jsp.
, , , , , , , , , , , , , , , , , , , , , , , , ,
 
Методы, унаследованные из класса java.io.Writer
write, write, write, write, write
 
Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструктор. Детали.

Javax.servlet.jsp.tagext Класс BodyTagSupport


java.lang.Object | +-- | +--javax.servlet.jsp.tagext.BodyTagSupport

public class BodyTagSupportextends implements

Базовый класс для определения обработчиков тэгов, реализующих BodyTag.

Класс BodyTagSupport реализует интерфейс BodyTag и добавляет несколько удобных методов, включая getter-методы для свойства bodyContent и методы для получения предыдущего out JspWriter.

Многие обработчики тэгов расширяют BodyTagSupport и лишь переопределяют несколько методы.

См. также:

Поле. Резюме.
protected

           

 

Поля, унаследованные из класса javax.servlet.jsp.tagext.
,

Конструктор. Резюме.
()

          Конструктор по умолчанию, все подклассы должны только определить public-конструктор с той же подписью и вызвать конструктор суперкласса.

Метод. Резюме.
 int ()

          После обсчёта тела: повторно не вычислять и продолжать обсчёт страницы.
 int ()

          Процессинг по умолчанию конечного тэга, возвращающего EVAL_PAGE.
 void ()

          Подготавливает к вычислению тела сразу перед первым вычислением тела: нет акции.
 int ()

          Процессинг по умолчанию начального тэга, возвращающего EVAL_BODY_BUFFERED.
  ()

          Получить текущий bodyContent.
  ()

          Получить окружающий (содержащий) out JspWriter.
 void ()

          Освободить статус.
 void ( b)

          Подготавливает к вычислению тела: берёт bodyContent.
<
 
Методы, унаследованные из класса javax.servlet.jsp.tagext.
, , , , , , , , ,
 
Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Поле. Детали.

Javax.servlet.jsp.tagext Класс PageData


java.lang.Object | +--javax.servlet.jsp.tagext.PageData

public abstract class PageDataextends java.lang.Object

Информация времени трансляции о JSP-странице. Эта информация соответствует XML-просмотру JSP-страницы.

Объекты этого типа генерируются JSP-транслятором, например, когда передаются экземпляру TagLibraryValidator'а.

Конструктор. Резюме.
()

Метод. Резюме.
abstract  java.io.InputStream ()

          Возвращает поток ввода в XML-просмотре JSP-страницы.

 

Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструктор. Детали.



Javax.servlet.jsp.tagext Класс TagAttributeInfo


java.lang.Object | +--javax.servlet.jsp.tagext.TagAttributeInfo

public class TagAttributeInfoextends java.lang.Object

Информация об атрибутах Tag'а, доступных на этапе трансляции. Этот класс инстанциируется из Tag Library Descriptor-файла (TLD).

Сюда включается только информация, необходимая для генерации кода. Другая информация, наподобие SCHEMA для проверки, находится в других местах.

Поле. Резюме.
staticjava.lang.String

          "id" привязывается как ID.

Конструктор. Резюме.
(java.lang.String name, boolean required, java.lang.String type, boolean reqTime)

          Конструктор для TagAttributeInfo.

Метод. Резюме.
 boolean ()

          Может ли данный атрибут содержать значение времени запроса.
static  ([] a)

          Удобный static-метод, проходящий по массиву TagAttributeInfo-объектов в поисках "id".
 java.lang.String ()

          Имя данного атрибута.
 java.lang.String ()

          Тип (как String) данного атрибута.
 boolean ()

          необходим ли данный атрибут.
 java.lang.String ()

           

 

Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Поле. Детали.



Javax.servlet.jsp.tagext Класс TagData


java.lang.Object | +--javax.servlet.jsp.tagext.TagData

public class TagDataextends java.lang.Objectimplements java.lang.Cloneable

Информация (только времени трансляции) пары attribute/value для экземпляра тэга.

TagData используется только в качестве аргумента методов isValid и getVariableInfo в of TagExtraInfo, которые вызываются на этапе трансляции.

Поле. Резюме.
staticjava.lang.Object

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

Конструктор. Резюме.
(java.util.Hashtable attrs)

          Конструктор для TagData.
(java.lang.Object[][] atts)

          Конструктор для  TagData.

Метод. Резюме
 java.lang.Object (java.lang.String attName)

          Значение атрибута.
 java.util.Enumeration ()

          Перечисляет атрибуты.
 java.lang.String (java.lang.String attName)

          Получает значение для данного атрибута.
 java.lang.String ()

          Значение атрибута id, если доступно.
 void (java.lang.String attName, java.lang.Object value)

          Устанавливает значение атрибута.

 

Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Поле. Детали.



Javax.servlet.jsp.tagext Класс TagExtraInfo


java.lang.Object | +--javax.servlet.jsp.tagext.TagExtraInfo

public abstract class TagExtraInfoextends java.lang.Object

Необязательный класс/Optional, предоставляемый автором библиотеки тэгов для описания дополнительной информации времени трансляции, не указанной в TLD. Класс TagExtraInfo упоминается в Tag Library Descriptor-файле (TLD).

Этот класс может использоваться:

для указания на то, что тэг определяет переменные скриптинга; для выполнения проверки атрибутов тэга на этапе трансляции.

JSP-транчлятор отвечает за то, чтобы начальное значение, возвращаемое вызовами getTagInfo(), соответствовало TagInfo-объекту для транслируемого тэга. Если выполняется явный вызов setTagInfo(), передаваемый объект будет возвращён последующими вызовами getTagInfo().

Единственный способ повлиять на значение, возвращаемое методом getTagInfo(), - через вызовы setTagInfo(), и, таким образом, TagExtraInfo.setTagInfo() вызывается JSP-транслятором TagInfo-объектом, который соответствует транслируемому тэгу. Вызов должен происходить до любого вызова метода isValid() и до любого вызова getVariableInfo().

Конструктор. Резюме.
()

Метод. Резюме.
  ()

          Получает TagInfo для данного класса.
 [] ( data)

          Получает информацию о переменных скриптинга, определённых тэгом, ассоциированным с данным экземпляром TagExtraInfo.
 boolean ( data)

          Проверка атрибутов на этапе трансляции.
 void ( tagInfo)

          Устанавливает TagInfo для данного класса.

 

Методы, унаследованные из класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Конструктор. Детали.