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

javax.faces.render
Класс ResponseStateManager

java.lang.Object
  javax.faces.render.ResponseStateManager

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

ResponseStateManager является помощником class к StateManager это знает определенную технологию рендеринга, используемую, чтобы генерировать ответ. Это - одноэлементный краткий обзор class, продаваемый RenderKit. Этот class знает механику о сохранении состояния, ли это быть в скрытых полях, сеансе, или некоторой комбинации двух.

Полевая Сводка

static java.lang.String	RENDER_KIT_ID_PARAM Имя параметра запроса, используемого реализацией по умолчанию ViewHandler.calculateRenderKitId(javax.faces.context.FacesContext) получить ID RenderKit.
static java.lang.String	VIEW_STATE_PARAM Реализации должны использовать это значение в качестве имени и идентификатора клиентского параметра, в котором можно сохранить состояние между запросами.

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

ResponseStateManager()

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

java.lang.Object	getComponentStateToRestore(FacesContext context) Осуждаемый. Этот метод был заменен getState(javax.faces.context.FacesContext, java.lang.String). Возвраты реализации по умолчанию null.
java.lang.Object	getState(FacesContext context, java.lang.String viewId) Реализация должна осмотреть текущий запрос и возвратить Объект, представляющий древовидную структуру и компонентное состояние, которое передают в к предыдущему вызову writeState(javax.faces.context.FacesContext,java.lang.Object).
java.lang.Object	getTreeStructureToRestore(FacesContext context, java.lang.String viewId) Осуждаемый. Этот метод был заменен getState(javax.faces.context.FacesContext, java.lang.String). Возвраты реализации по умолчанию null.
java.lang.String	getViewState(FacesContext context, java.lang.Object state) Возвратите указанное состояние как a String без любой разметки, связанной с рендерингом, технология поддерживается этим ResponseStateManager.
boolean	isPostback(FacesContext context) Возвратите true, если текущий запрос является постспиной.
void	writeState(FacesContext context, java.lang.Object state)
void	writeState(FacesContext context, StateManager.SerializedView state) Осуждаемый. Этот метод был заменен writeState(javax.faces.context.FacesContext,java.lang.Object). Реализация по умолчанию создает два элемента Object массив с первым элементом, являющимся возвратом из вызова StateManager.SerializedView.getStructure(), и второе, являющееся возвратом из StateManager.SerializedView.getState(). Это тогда передает это Object массив к writeState(javax.faces.context.FacesContext, java.lang.Object).

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

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

Полевая Деталь

RENDER_KIT_ID_PARAM

public static final java.lang.String RENDER_KIT_ID_PARAM

Имя параметра запроса, используемого реализацией по умолчанию ViewHandler.calculateRenderKitId(javax.faces.context.FacesContext) получить ID RenderKit.

См. Также:

Постоянные Значения полей

VIEW_STATE_PARAM

public static final java.lang.String VIEW_STATE_PARAM

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

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

С тех пор:

1.2

См. Также:

Постоянные Значения полей

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

ResponseStateManager

public ResponseStateManager()

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

состояние записи

public void writeState(FacesContext context,
                       java.lang.Object state)
                throws java.io.IOException

Броски:

java.io.IOException

состояние записи

public void writeState(FacesContext context,
                       StateManager.SerializedView state)
                throws java.io.IOException

Осуждаемый. Этот метод был заменен writeState(javax.faces.context.FacesContext,java.lang.Object). Реализация по умолчанию создает два элемента Object массив с первым элементом, являющимся возвратом из вызова StateManager.SerializedView.getStructure(), и второе, являющееся возвратом из StateManager.SerializedView.getState(). Это тогда передает это Object массив к writeState(javax.faces.context.FacesContext, java.lang.Object).

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

Если StateManager.SerializedView должен быть выписан к скрытым полям, реализация должна заботиться, чтобы сделать все необходимые символьные замены, чтобы сделать Строки подходящими для включения как парамать запроса HTTP.

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

Параметры:

context - FacesContext экземпляр для текущего запроса

state - Сериализированная информация о состоянии ранее сохраняется

Броски:

java.io.IOException

getState

public java.lang.Object getState(FacesContext context,
                                 java.lang.String viewId)

Реализация должна осмотреть текущий запрос и возвратить Объект, представляющий древовидную структуру и компонентное состояние, которое передают в к предыдущему вызову writeState(javax.faces.context.FacesContext,java.lang.Object).

Для назад compatability с существующим ResponseStateManager реализации, реализация по умолчанию этого вызовы метода getTreeStructureToRestore(javax.faces.context.FacesContext, java.lang.String) и getComponentStateToRestore(javax.faces.context.FacesContext) и создает и возвращает два элемента Object массив с нулем элемента, содержащим structure свойство и элемент один содержащий state свойство SerializedView.

Параметры:

context - FacesContext экземпляр для текущего запроса

viewId - Идентификатор представления представления, которое будет восстановлено

Возвраты:

древовидная структура и компонент утверждают Объект, который передают в к writeState. Если это - начальный запрос, этот метод возвраты null.

С тех пор:

1.2

getTreeStructureToRestore

public java.lang.Object getTreeStructureToRestore(FacesContext context,
                                                  java.lang.String viewId)

Осуждаемый. Этот метод был заменен getState(javax.faces.context.FacesContext, java.lang.String). Возвраты реализации по умолчанию null.

Реализация должна осмотреть текущий запрос и возвратить Объект древовидной структуры, который передают этому на предыдущем вызове writeState().

Параметры:

context - FacesContext экземпляр для текущего запроса

viewId - Идентификатор представления представления, которое будет восстановлено

getComponentStateToRestore

public java.lang.Object getComponentStateToRestore(FacesContext context)

Осуждаемый. Этот метод был заменен getState(javax.faces.context.FacesContext, java.lang.String). Возвраты реализации по умолчанию null.

Реализация должна осмотреть текущий запрос и возвратить компонентный Объект состояния, который передают этому на предыдущем вызове writeState().

Параметры:

context - FacesContext экземпляр для текущего запроса

isPostback

public boolean isPostback(FacesContext context)

Возвратите true, если текущий запрос является постспиной. Этот метод усиливается от Фазы Представления Восстановления, чтобы определить если ViewHandler.restoreView(javax.faces.context.FacesContext, java.lang.String) или ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String) должен быть вызван. Реализация по умолчанию должна возвратиться true если это ResponseStateManager экземпляр выписал состояние по предыдущему запросу, к которому этот запрос является постспиной, false иначе.

Реализация, если этот метод для Стандартного HTML RenderKit должен консультироваться ExternalContext's requestParameterMap и возвратитесь true если и только если есть ключ, равный значению символьной константы VIEW_STATE_PARAM.

Для назад compatability с реализациями ResponseStateManager до JSF 1.2, реализация по умолчанию - то, при условии, что консультируется ExternalContext's requestParameterMap и возвратитесь true если его размер больше чем 0.

С тех пор:

1.2

getViewState

public java.lang.String getViewState(FacesContext context,
                                     java.lang.Object state)

Возвратите указанное состояние как a String без любой разметки, связанной с рендерингом, технология поддерживается этим ResponseStateManager.

Параметры:

context - FacesContext для текущего запроса

state - состояние, от которого Строковая версия будет сгенерирована от

Возвраты:

состояние отображения для этого запроса без любых специфических особенностей разметки

С тех пор:

2.0