StateHolder (EE Java 6)




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.


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41


Spec-Zone.ru - all specs in one place



free hit counter