Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.faces.component. UIComponent javax.faces.component. UIComponentBase javax.faces.component.UIViewRoot
public class UIViewRoot
UIViewRoot является UIComponent, который представляет корень дерева UIComponent. Этот компонент представляет разметку как ответ на запросы Аякса. Это также служит корнем компонентного дерева, и как место, чтобы зависнуть на представление PhaseListener
s.
Для каждого из следующих методов фазы жизненного цикла:
RenderResponse, через encodeBegin(javax.faces.context.FacesContext)
и encodeEnd(javax.faces.context.FacesContext)
Предпримите следующие меры относительно PhaseListener
s.
Инициализируйте флаг состояния к false
.
Если getBeforePhaseListener()
возвраты не -null
, вызовите слушателя, передающего в корректном соответствии PhaseId
для этой фазы.
По возврату от слушателя вызвать FacesContext#getResponseComplete
и FacesContext#getRenderResponse
. Если любой возврат true
установите флаг внутреннего состояния в true
.
Если или один или более слушателей были добавлены звонком addPhaseListener(javax.faces.event.PhaseListener)
, вызовите beforePhase
метод на каждом, чей PhaseListener#getPhaseId
соответствует ток phaseId, передавая в том же самом PhaseId
как в предыдущем шаге.
По возврату от каждого слушателя вызвать FacesContext#getResponseComplete
и FacesContext#getRenderResponse
. Если любой возврат true
установите флаг внутреннего состояния в true
.
Выполните любую обработку для этой фазы, если флаг внутреннего состояния не был установлен.
Если getAfterPhaseListener()
возвраты не -null
, вызовите слушателя, передающего в корректном соответствии PhaseId
для этой фазы.
Если или один или более слушателей были добавлены звонком addPhaseListener(javax.faces.event.PhaseListener)
, вызовите afterPhase
метод на каждом, чей PhaseListener#getPhaseId
соответствует ток phaseId, передавая в том же самом PhaseId
как в предыдущем шаге.
Полевая Сводка | |
---|---|
static java.lang.String |
COMPONENT_FAMILY
Стандартное компонентное семейство для этого компонента. |
static java.lang.String |
COMPONENT_TYPE
Стандартный компонент вводит для этого компонента. |
static java.lang.String |
METADATA_FACET_NAME
|
static java.lang.String |
UNIQUE_ID_PREFIX
Префикс, который будет использоваться для идентификаторов, сгенерированных createUniqueId() метод. |
static java.lang.String |
VIEW_PARAMETERS_KEY
Ключ в наборе значений метаданных представления BeanDescriptor, значение которого является a |
Поля, наследованные от class javax.faces.component. UIComponent |
---|
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY |
Сводка конструктора | |
---|---|
UIViewRoot()
Создайте новое UIViewRoot экземпляр со значениями свойств значения по умолчанию. |
Сводка метода | |
---|---|
void |
addComponentResource(FacesContext context, UIComponent componentResource)
Добавьте параметр |
void |
addComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
Добавьте параметр |
void |
addPhaseListener(PhaseListener newPhaseListener)
Добавьте параметр newPhaseListener к списку PhaseListener s на этом UIViewRoot . |
void |
broadcastEvents(FacesContext context, PhaseId phaseId)
Широковещательно передайте любые события, которые были поставлены в очередь. |
java.lang.String |
createUniqueId()
Генерируйте идентификатор для компонента. |
java.lang.String |
createUniqueId(FacesContext context, java.lang.String seed)
Генерируйте идентификатор для компонента. |
void |
encodeBegin(FacesContext context)
Переопределите значение по умолчанию UIComponentBase#encodeBegin поведение. |
void |
encodeChildren(FacesContext context)
Если |
void |
encodeEnd(FacesContext context)
Если |
MethodExpression |
getAfterPhaseListener()
Возвратитесь MethodExpression это будет вызвано после того, как это представление представляется. |
MethodExpression |
getBeforePhaseListener()
Возвратитесь MethodExpression это будет вызвано прежде, чем это представление представляется. |
java.util.List<UIComponent> |
getComponentResources(FacesContext context, java.lang.String target)
Возвратите неподдающееся изменению |
java.lang.String |
getFamily()
Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. |
java.util.Locale |
getLocale()
Возвратитесь Locale использоваться в локализации ответа, создаваемого для этого представления. |
java.util.List<PhaseListener> |
getPhaseListeners()
Возвратите неподдающийся изменению список |
java.lang.String |
getRenderKitId()
Возвратите представлять идентификатор набора RenderKit связанный с этим представлением. |
boolean |
getRendersChildren()
Вызвать |
java.lang.String |
getViewId()
Возвратите идентификатор представления для этого представления. |
java.util.List<SystemEventListener> |
getViewListenersForEventClass(java.lang.Class<? extends SystemEvent> systemEvent)
Возвратитесь |
java.util.Map<java.lang.String,java.lang.Object> |
getViewMap()
Эта реализация просто вызывает через к |
java.util.Map<java.lang.String,java.lang.Object> |
getViewMap(boolean create)
Возвраты a |
boolean |
isInView()
Возвратиться |
void |
processApplication(FacesContext context)
Широковещательно передайте любые события, которые были поставлены в очередь для Вызвать фазы Приложения жизненного цикла обработки запросов и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным. |
void |
processDecodes(FacesContext context)
|
void |
processRestoreState(FacesContext context, java.lang.Object state)
Реализация по умолчанию должна вызвать |
void |
processUpdates(FacesContext context)
|
void |
processValidators(FacesContext context)
|
void |
queueEvent(FacesEvent event)
Переопределите значение по умолчанию UIComponentBase#queueEvent поведение, чтобы накопить события с очередями для более поздней широковещательной передачи. |
void |
removeComponentResource(FacesContext context, UIComponent componentResource)
Удалите параметр |
void |
removeComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
Удалите параметр |
void |
removePhaseListener(PhaseListener toRemove)
Если параметр toRemove находится в списке PhaseListener s для этого экземпляра, это должно быть удалено. |
void |
restoreState(FacesContext context, java.lang.Object state)
Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния. |
java.lang.Object |
saveState(FacesContext context)
Получает состояние экземпляра как a Serializable Объект. |
void |
setAfterPhaseListener(MethodExpression newAfterPhase)
Позвольте произвольному методу быть вызванным для "afterPhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. |
void |
setBeforePhaseListener(MethodExpression newBeforePhase)
Позвольте произвольному методу быть вызванным для "beforePhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. |
void |
setInView(boolean isInView)
Переопределенный, чтобы предпринять меры. |
void |
setLocale(java.util.Locale locale)
Установите Locale использоваться в локализации ответа, создаваемого для этого представления. |
void |
setRenderKitId(java.lang.String renderKitId)
Установите представлять идентификатор набора RenderKit связанный с этим представлением. |
void |
setViewId(java.lang.String viewId)
Установите идентификатор представления для этого представления. |
void |
subscribeToViewEvent(java.lang.Class<? extends SystemEvent> systemEvent, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр |
void |
unsubscribeFromViewEvent(java.lang.Class<? extends SystemEvent> systemEvent, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Полевая Деталь |
---|
public static final java.lang.String METADATA_FACET_NAME
public static final java.lang.String VIEW_PARAMETERS_KEY
Ключ в наборе значений метаданных представления BeanDescriptor, значение которого является a List<
.UIViewParameter.Reference
>
public static final java.lang.String COMPONENT_TYPE
Стандартный компонент вводит для этого компонента.
public static final java.lang.String COMPONENT_FAMILY
Стандартное компонентное семейство для этого компонента.
public static final java.lang.String UNIQUE_ID_PREFIX
Префикс, который будет использоваться для идентификаторов, сгенерированных createUniqueId()
метод.
Деталь конструктора |
---|
public UIViewRoot()
Создайте новое UIViewRoot
экземпляр со значениями свойств значения по умолчанию.
Деталь метода |
---|
public boolean isInView()
Возвратиться trues
.
isInView
в class UIComponent
public void setInView(boolean isInView)
Переопределенный, чтобы предпринять меры.
setInView
в class UIComponent
isInView
- public java.lang.String getFamily()
UIComponent
Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. Этот идентификатор, в соединении со значением rendererType
свойство, может использоваться, чтобы выбрать соответствующее Renderer
для этого компонентного экземпляра.
getFamily
в class UIComponent
UIComponent#getFamily()
public java.lang.String getRenderKitId()
Возвратите представлять идентификатор набора RenderKit
связанный с этим представлением. Если явно не установлено, как в ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String)
, возвращенное значение будет null.
public void setRenderKitId(java.lang.String renderKitId)
Установите представлять идентификатор набора RenderKit
связанный с этим представлением. Этот метод можно вызвать в любое время между концом, Применяют фазу Значений Запроса жизненного цикла обработки запросов (то есть когда события широковещательно передаются), и начало Представлять фазы Ответа.
renderKitId
- Новое RenderKit
идентификатор, или null
разъединять это представление с любым определенным RenderKit
экземплярpublic java.lang.String getViewId()
Возвратите идентификатор представления для этого представления.
public void setViewId(java.lang.String viewId)
Установите идентификатор представления для этого представления.
viewId
- Новый идентификатор представленияpublic MethodExpression getBeforePhaseListener()
Возвратитесь MethodExpression
это будет вызвано прежде, чем это представление представляется.
MethodExpression
это будет вызвано прежде, чем это представление представляется.public void setBeforePhaseListener(MethodExpression newBeforePhase)
Позвольте произвольному методу быть вызванным для "beforePhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. Этот метод вызовут для всех фаз кроме PhaseId#RESTORE_VIEW
. В отличие от истины PhaseListener
, этот подход не учитывает только получение PhaseEvent
s для данной фазы.
Метод должен соответствовать подписи PhaseListener#beforePhase
.
newBeforePhase
- MethodExpression
это будет вызвано прежде, чем это представление представляется.public MethodExpression getAfterPhaseListener()
Возвратитесь MethodExpression
это будет вызвано после того, как это представление представляется.
MethodExpression
это будет вызвано после того, как это представление представляется.public void setAfterPhaseListener(MethodExpression newAfterPhase)
Позвольте произвольному методу быть вызванным для "afterPhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. Этот метод вызовут для всех фаз включая PhaseId#RESTORE_VIEW
. В отличие от истины PhaseListener
, этот подход не учитывает только получение PhaseEvent
s для данной фазы.
Метод должен соответствовать подписи PhaseListener#afterPhase
.
newAfterPhase
- MethodExpression
это будет вызвано после того, как это представление представляется.public void removePhaseListener(PhaseListener toRemove)
Если параметр toRemove
находится в списке PhaseListener
s для этого экземпляра, это должно быть удалено.
toRemove
- PhaseListener
удалить.public void addPhaseListener(PhaseListener newPhaseListener)
Добавьте параметр newPhaseListener
к списку PhaseListener
s на этом UIViewRoot
.
newPhaseListener
- PhaseListener
добавитьpublic java.util.List<PhaseListener> getPhaseListeners()
Возвратите неподдающийся изменению список PhaseListener
экземпляры, присоединенные к этому UIViewRoot
экземпляр.
public void addComponentResource(FacesContext context, UIComponent componentResource)
Добавьте параметр component
, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению. Экземпляр ресурса представляется ресурсом Renderer
, как описано в Стандартном HTML RenderKit. Реализация по умолчанию должна вызвать через к addComponentResource(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.String)
.
context
- FacesContext
для текущего запросаcomponentResource
- UIComponent
представление a Resource
экземплярpublic void addComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
Добавьте параметр component
, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению. Экземпляр ресурса представляется ресурсом Renderer
, как описано в Стандартном HTML RenderKit.
component
должен быть добавлен, используя следующий алгоритм:
Если target
параметр null
, ищите a target
атрибут на component
. Если есть нет target
атрибут, набор target
быть значением по умолчанию head
Вызвать getComponentResources(javax.faces.context.FacesContext, java.lang.String)
получить дочерний список для данной цели.
Если компонентный ID componentResource
соответствует ID ресурса, у которого есть allready, добавленный, удалите старый ресурс.
Добавьте component
ресурс к списку.
context
- FacesContext
для текущего запросаcomponentResource
- UIComponent
представление a Resource
экземплярtarget
- Имя то, фасета, для который UIComponent
будет добавленpublic java.util.List<UIComponent> getComponentResources(FacesContext context, java.lang.String target)
Возвратите неподдающееся изменению List
из UIComponent
s для обеспеченного target
agrument. Каждый component
в List
как предполагается, представляет экземпляр ресурса.
Реализация по умолчанию должна использовать алгоритм, эквивалентный следующий.
component
вызывая getFacet()
использование target
как параметр.context.getApplication().createComponent().
Параметр этому методу должен обратиться к компоненту, который расширяется UIPanel
и переопределения encodeAll()
метод, чтобы предпринять меры. Это необходимо, чтобы препятствовать тому, чтобы компонентные ресурсы были непреднамеренно представлены.id
из фасета, чтобы быть строкой, создаваемой, предварительно ожидая литеральная строка“javax_faces_location_
”(без кавычек) к значению target
параметрMap
использование target
как ключ
target
- Имя фасета, для которого будут возвращены компоненты. List
из UIComponent
дочерние элементы фасета с именем target
. Если никакие дочерние элементы не находятся для фасета, возвратиться Collections.emptyList()
. java.lang.NullPointerException
- если target
или context
null
public void removeComponentResource(FacesContext context, UIComponent componentResource)
Удалите параметр component
, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.
context
- FacesContext
для текущего запросаcomponentResource
- UIComponent
представление a Resource
экземплярpublic void removeComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
Удалите параметр component
, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению. Экземпляр ресурса представляется ресурсом Renderer
, как описано в Стандартном HTML RenderKit.
component
должен быть удален, используя следующий алгоритм:
target
параметр null
, ищите a target
атрибут на component
.target
атрибут, набор target
быть значением по умолчанию head
getComponentResources(javax.faces.context.FacesContext, java.lang.String)
получить дочерний список для данной цели.component
ресурс от дочернего списка.
context
- FacesContext
для текущего запросаcomponentResource
- UIComponent
представление a Resource
экземплярtarget
- Имя то, фасета, для который UIComponent
будет добавленpublic void queueEvent(FacesEvent event)
Переопределите значение по умолчанию UIComponentBase#queueEvent
поведение, чтобы накопить события с очередями для более поздней широковещательной передачи.
queueEvent
в class UIComponentBase
event
- FacesEvent
быть поставленным в очередь IllegalStateException
- если этот компонент не является потомком a UIViewRoot
java.lang.NullPointerException
- если event
null
public void broadcastEvents(FacesContext context, PhaseId phaseId)
Широковещательно передайте любые события, которые были поставлены в очередь. Сначала широковещательные события, которые были поставлены в очередь для PhaseId#ANY_PHASE
. Затем широковещательная передача ane события, которые были поставлены в очередь для текущей фазы. В обоих случаях, UIComponent#pushComponentToEL
должен быть вызван прежде, чем событие широковещательно передается, и UIComponent#popComponentFromEL
должен быть вызван после возврата из широковещательной передачи, даже в случае исключения.
context
- FacesContext
для текущего запросаphaseId
- PhaseId
из текущей фазыpublic void processRestoreState(FacesContext context, java.lang.Object state)
Реализация по умолчанию должна вызвать UIComponentBase#processRestoreState
изнутри a try
блок. try
у блока должен быть a finally
блок, который гарантирует что нет FacesEvent
s остаются в конечном счете очередью.
processRestoreState
в class UIComponentBase
context
- FacesContext
для этого requetsstate
- непрозрачный объект состояния, полученный из StateManager
public void processDecodes(FacesContext context)
Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId)
с PhaseId#APPLY_REQUEST_VALUES
если:
PartialViewContext.isPartialRequest()
возвраты true
и у нас нет запроса, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты false
)UIComponentBase#processDecodes
если одно из следующих условий встречается: PartialViewContext.isPartialRequest()
возвраты true
и у нас есть запрос, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты true
)PartialViewContext.isPartialRequest()
возвраты false
Переопределите значение по умолчанию UIComponentBase#processDecodes
поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse
или FacesContext#responseComplete
быть вызванным.
processDecodes
в class UIComponentBase
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public void encodeBegin(FacesContext context) throws java.io.IOException
Переопределите значение по умолчанию UIComponentBase#encodeBegin
поведение. Если getBeforePhaseListener()
возвраты не -null
, вызовите это, передавая a PhaseEvent
для PhaseId#RENDER_RESPONSE
фаза. Если внутренний список заполняется звонками addPhaseListener(javax.faces.event.PhaseListener)
непусто, у любых слушателей в том списке должен быть их PhaseListener#beforePhase
вызванный метод, передавая PhaseEvent
. Любые ошибки, которые происходят во время вызова любого из beforePhase слушатели, должны быть зарегистрированы и глотаться. После того, как слушатели вызываются обработка суперкласса вызова.
encodeBegin
в class UIComponentBase
context
- FacesContext
для ответа мы создаем java.io.IOException
- если ввод/ошибка на выходе происходит, представляяpublic void encodeChildren(FacesContext context) throws java.io.IOException
Если PartialViewContext.isAjaxRequest()
возвраты true
, выполните частичный рендеринг, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId)
с PhaseId#RENDER_RESPONSE
. Если PartialViewContext.isAjaxRequest()
возвраты false
, делегируйте к родителю UIComponentBase.encodeChildren(javax.faces.context.FacesContext)
метод.
encodeChildren
в class UIComponentBase
context
- FacesContext
для ответа мы создаем java.io.IOException
- если ввод/ошибка на выходе происходит, представляяpublic void encodeEnd(FacesContext context) throws java.io.IOException
Если getAfterPhaseListener()
возвраты не -null
, вызовите это, передавая a PhaseEvent
для PhaseId#RENDER_RESPONSE
фаза. Любые ошибки, которые происходят во время вызова afterPhase слушателя, должны быть зарегистрированы и глотаться. Если у текущего представления есть параметры представления, как обозначено непустым и не -UnsupportedOperationException
бросок возврата из ViewDeclarationLanguage.getViewMetadata(javax.faces.context.FacesContext, String)
, вызвать UIViewParameter#encodeAll
на каждом параметре. Вызывая getViewParameters()
причины UnsupportedOperationException
чтобы быть брошенным, исключение нужно тихо глотать.
encodeEnd
в class UIComponentBase
context
- FacesContext
для ответа мы создаем java.io.IOException
- если ввод/ошибка на выходе происходит, представляяpublic boolean getRendersChildren()
Вызвать UIComponentBase#getRendersChildren
Если PartialViewContext.isAjaxRequest()
возвраты true
этот метод должен возвратиться true
.
getRendersChildren
в class UIComponentBase
public void processValidators(FacesContext context)
Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId)
с PhaseId#PROCESS_VALIDATIONS
если:
PartialViewContext.isPartialRequest()
возвраты true
и у нас нет запроса, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты false
)UIComponentBase#processValidators
если одно из следующих условий встречается: PartialViewContext.isPartialRequest()
возвраты true
и у нас есть запрос, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты true
)PartialViewContext.isPartialRequest()
возвраты false
Переопределите значение по умолчанию UIComponentBase#processValidators
поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse
или FacesContext#responseComplete
быть вызванным.
processValidators
в class UIComponentBase
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public void processUpdates(FacesContext context)
Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId)
с PhaseId#UPDATE_MODEL_VALUES
если:
PartialViewContext.isPartialRequest()
возвраты true
и у нас нет запроса, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты false
)UIComponentBase#processUpdates
если одно из следующих условий встречается: PartialViewContext.isPartialRequest()
возвраты true
и у нас есть запрос, чтобы обработать все компоненты в представлении (PartialViewContext.isExecuteAll()
возвраты true
)PartialViewContext.isPartialRequest()
возвраты false
Переопределите значение по умолчанию UIComponentBase
поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse
или FacesContext#responseComplete
быть вызванным.
processUpdates
в class UIComponentBase
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public void processApplication(FacesContext context)
Широковещательно передайте любые события, которые были поставлены в очередь для Вызвать фазы Приложения жизненного цикла обработки запросов и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse
или FacesContext#responseComplete
быть вызванным.
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public java.lang.String createUniqueId()
Генерируйте идентификатор для компонента. Идентификатор будет снабжен префиксом UNIQUE_ID_PREFIX, и будет уникален в пределах этого UIViewRoot.
public java.lang.String createUniqueId(FacesContext context, java.lang.String seed)
Генерируйте идентификатор для компонента. Идентификатор будет снабжен префиксом UNIQUE_ID_PREFIX, и будет уникален в пределах этого UIViewRoot. Дополнительно, уникальное значение семени может быть предоставлено компонентными создателями, которые должны быть включены в сгенерированный уникальный идентификатор.
createUniqueId
в интерфейсе UniqueIdVendor
context
- FacesContextseed
- дополнительное значение семени - например, основанный на позиции компонента в VDL-шаблоне public java.util.Locale getLocale()
Возвратитесь Locale
использоваться в локализации ответа, создаваемого для этого представления.
Алгоритм:
Если у нас есть a locale
ivar, возвратите это. Если мы имеем выражение для "локали", получаем ее значение. Если значение null
, возвратите результат вызова ViewHandler.calculateLocale(javax.faces.context.FacesContext)
. Если значение является экземпляром java.util.Locale
возвратите это. Если значением является Строка, преобразуйте его в a java.util.Locale
и возвратите это. Если нет никакого выражения для "локали", возвратите результат вызова ViewHandler.calculateLocale(javax.faces.context.FacesContext)
.
Locale
полученный, выполняя вышеупомянутый алгоритм.public void setLocale(java.util.Locale locale)
Установите Locale
использоваться в локализации ответа, создаваемого для этого представления.
locale
- Новая Локаль локализацииpublic java.util.Map<java.lang.String,java.lang.Object> getViewMap()
Эта реализация просто вызывает через к getViewMap(boolean)
, передача true
как параметр, и возвраты результат.
public java.util.Map<java.lang.String,java.lang.Object> getViewMap(boolean create)
Возвраты a Map
это действует как интерфейс к хранилищу данных, которое является "контекстом представления", или, если у этого экземпляра нет такого Map
и create
параметр true
, создает один и возвращает это. Эта карта нужно инстанцировать лениво и кэшироваться для возврата из последующих звонков в этот метод на этом UIViewRoot
экземпляр. Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object)
должен быть вызван, передавая PostConstructViewMapEvent
.class
как первый параметр и это UIViewRoot
экземпляр как второй параметр.
Возвращенный Map
должен быть реализован, так, что вызывая clear()
на Map
причины Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object)
быть вызванным, передавая PreDestroyViewMapEvent
.class
как первый параметр и это UIViewRoot
экземпляр как второй параметр.
В зависимости от конфигурации приложения объекты, хранившие в карте представления, возможно, должны быть Serializable
. Вообще, это - хорошая идея гарантировать, что любые объекты, хранившие в карте представления, Serializable
.
См. FacesContext#setViewRoot
для спецификации когда clear()
метод нужно вызвать.
create
- true
создать новое Map
для этого экземпляра в случае необходимости; false
возвратиться null
если нет никакого тока Map
.public void subscribeToViewEvent(java.lang.Class<? extends SystemEvent> systemEvent, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр listener
в UIViewRoot
как слушатель для событий типа systemEventClass
.
Отметьте, что установленные слушатели не сохраняются как часть UIViewRoot
's состояние.
systemEvent
- Class
из того, события, для который listener
должен быть запущен.listener
- реализация SystemEventListener
чей SystemEventListener.processEvent(javax.faces.event.SystemEvent)
метод нужно вызвать когда события типа systemEventClass
запускаются. NullPointerException
- если systemEventClass
или listener
null
.public void unsubscribeFromViewEvent(java.lang.Class<? extends SystemEvent> systemEvent, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр listener
от UIViewRoot
как слушатель для событий типа systemEventClass
.
systemEvent
- Class
из того, события, для который listener
должен быть запущен.listener
- реализация SystemEventListener
чей SystemEventListener.processEvent(javax.faces.event.SystemEvent)
метод нужно вызвать когда события типа systemEventClass
запускаются. NullPointerException
- если systemEventClass
или listener
null
.public java.util.List<SystemEventListener> getViewListenersForEventClass(java.lang.Class<? extends SystemEvent> systemEvent)
Возвратитесь SystemEventListener
экземпляры зарегистрировались на этом UIComponent
экземпляр, которые интересуются событиями типа eventClass
.
systemEvent
- Class
из события, для которого должны быть возвращены слушатели. java.lang.NullPointerException
- если параметр systemEvent
null
.public java.lang.Object saveState(FacesContext context)
StateHolder
Получает состояние экземпляра как a Serializable
Объект.
Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые реализуют StateHolder (такой как a UIComponent
с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.saveState(javax.faces.context.FacesContext)
метод на всех тех экземплярах также. Этот метод не должен сохранить состояние дочерних элементов и фасетов. Это делается через StateManager
Этот метод не должен изменить состояние объекта реализации. Другими словами, после выполнения этого кода:
Object state = component.saveState(facesContext);
component
должно быть то же самое как прежде, чем выполнить это.
Возврат из этого метода должен быть Serializable
saveState
в интерфейсе StateHolder
saveState
в class UIComponentBase
public void restoreState(FacesContext context, java.lang.Object state)
StateHolder
Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.
Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые также реализуют StateHolder (такой как a UIComponent
с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object)
метод на всех тех экземплярах также.
Если state
параметр null
, не предпримите меры и возврат.
restoreState
в интерфейсе StateHolder
restoreState
в class UIComponentBase
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41