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

javax.faces.component
Интерфейс StateHolder

Все Известные Подынтерфейсы:

PartialStateHolder, StateHelper

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

AjaxBehavior, BeanValidator, BehaviorBase, ClientBehaviorBase, DateTimeConverter, DoubleRangeValidator, EnumConverter, HtmlBody, HtmlColumn, HtmlCommandButton, HtmlCommandLink, HtmlDataTable, HtmlDoctype, HtmlForm, HtmlGraphicImage, HtmlHead, HtmlInputHidden, HtmlInputSecret, HtmlInputText, HtmlInputTextarea, HtmlMessage, HtmlMessages, HtmlOutcomeTargetButton, HtmlOutcomeTargetLink, HtmlOutputFormat, HtmlOutputLabel, HtmlOutputLink, HtmlOutputText, HtmlPanelGrid, HtmlPanelGroup, HtmlSelectBooleanCheckbox, HtmlSelectManyCheckbox, HtmlSelectManyListbox, HtmlSelectManyMenu, HtmlSelectOneListbox, HtmlSelectOneMenu, HtmlSelectOneRadio, LengthValidator, LongRangeValidator, MethodExpressionActionListener, MethodExpressionValidator, MethodExpressionValueChangeListener, NumberConverter, RegexValidator, UIColumn, UICommand, UIComponent, UIComponentBase, UIData, UIForm, UIGraphic, UIInput, UIMessage, UIMessages, UINamingContainer, UIOutcomeTarget, UIOutput, UIPanel, UIParameter, UISelectBoolean, UISelectItem, UISelectItems, UISelectMany, UISelectOne, UIViewParameter, UIViewRoot

public interface StateHolder

Этот интерфейс реализуется классами, которые должны сохранить их состояние между запросами.

Конструктор должен реализовать обоих saveState(javax.faces.context.FacesContext) и restoreState(javax.faces.context.FacesContext, java.lang.Object) методы в этом class, так как у этих двух методов есть сильно связанный контракт между собой. Другими словами, если есть ineritance иерархия, это не permissable, чтобы иметь saveState(javax.faces.context.FacesContext) и restoreState(javax.faces.context.FacesContext, java.lang.Object) методы находятся на разных уровнях иерархии.

У конструктора не должно быть общественности никакой-args конструктор.

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

boolean	isTransient() Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.
void	restoreState(FacesContext context, java.lang.Object state) Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.
java.lang.Object	saveState(FacesContext context) Получает состояние экземпляра как a Serializable Объект.
void	setTransient(boolean newTransientValue) Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.

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

saveState

java.lang.Object saveState(FacesContext context)

Получает состояние экземпляра как a Serializable Объект.

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать saveState(javax.faces.context.FacesContext) метод на всех тех экземплярах также. Этот метод не должен сохранить состояние дочерних элементов и фасетов. Это делается через StateManager

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

 Object state = component.saveState(facesContext);
 

component должно быть то же самое как прежде, чем выполнить это.

Возврат из этого метода должен быть Serializable

Броски:

java.lang.NullPointerException - если context нуль

restoreState

void restoreState(FacesContext context,
                  java.lang.Object state)

Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые также реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать restoreState(javax.faces.context.FacesContext, java.lang.Object) метод на всех тех экземплярах также.

Если state параметр null, не предпримите меры и возврат.

Броски:

java.lang.NullPointerException - если context нуль.

isTransient

boolean isTransient()

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

setTransient

void setTransient(boolean newTransientValue)

Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.

Параметры:

newTransientValue - булева передача true если этот Объект не будет участвовать в сохранении состояния или восстановлении, иначе передайте false.