javax.faces.component
Класс UIViewRoot

java.lang.Object
  расширенный javax.faces.component. UIComponent
      расширенный javax.faces.component. UIComponentBase
          расширенный javax.faces.component.UIViewRoot
Все Реализованные Интерфейсы:
java.util. EventListener, PartialStateHolder, StateHolder, TransientStateHolder, UniqueIdVendor, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder

public class UIViewRoot
расширяет UIComponentBase
реализации UniqueIdVendor

UIViewRoot является UIComponent, который представляет корень дерева UIComponent. Этот компонент представляет разметку как ответ на запросы Аякса. Это также служит корнем компонентного дерева, и как место, чтобы зависнуть на представление PhaseListeners.

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

Предпримите следующие меры относительно PhaseListeners.


Полевая Сводка
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 List<UIViewParameter.Reference>.

 
Поля, наследованные от 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)
          

Добавьте параметр component, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.

 void addComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
          

Добавьте параметр component, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.

 void addPhaseListener(PhaseListener newPhaseListener)
          Добавьте параметр newPhaseListener к списку PhaseListeners на этом 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)
          

Если PartialViewContext.isAjaxRequest() возвраты true, выполните частичный рендеринг, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId) с PhaseId#RENDER_RESPONSE.

 void encodeEnd(FacesContext context)
          

Если getAfterPhaseListener() возвраты не -null, вызовите это, передавая a PhaseEvent для PhaseId#RENDER_RESPONSE фаза.

 MethodExpression getAfterPhaseListener()
          Возвратитесь MethodExpression это будет вызвано после того, как это представление представляется.
 MethodExpression getBeforePhaseListener()
          Возвратитесь MethodExpression это будет вызвано прежде, чем это представление представляется.
 java.util.List<UIComponent> getComponentResources(FacesContext context, java.lang.String target)
          

Возвратите неподдающееся изменению List из UIComponents для обеспеченного target agrument.

 java.lang.String getFamily()
          Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент.
 java.util.Locale getLocale()
          Возвратитесь Locale использоваться в локализации ответа, создаваемого для этого представления.
 java.util.List<PhaseListener> getPhaseListeners()
          

Возвратите неподдающийся изменению список PhaseListener экземпляры, присоединенные к этому UIViewRoot экземпляр.

 java.lang.String getRenderKitId()
          Возвратите представлять идентификатор набора RenderKit связанный с этим представлением.
 boolean getRendersChildren()
          

Вызвать UIComponentBase#getRendersChildren Если PartialViewContext.isAjaxRequest() возвраты true этот метод должен возвратиться true.

 java.lang.String getViewId()
          Возвратите идентификатор представления для этого представления.
 java.util.List<SystemEventListener> getViewListenersForEventClass(java.lang.Class<? extends SystemEvent> systemEvent)
          

Возвратитесь SystemEventListener экземпляры зарегистрировались на этом UIComponent экземпляр, которые интересуются событиями типа eventClass.

 java.util.Map<java.lang.String,java.lang.Object> getViewMap()
          

Эта реализация просто вызывает через к getViewMap(boolean), передача true как параметр, и возвраты результат.

 java.util.Map<java.lang.String,java.lang.Object> getViewMap(boolean create)
          

Возвраты a Map это действует как интерфейс к хранилищу данных, которое является "контекстом представления", или, если у этого экземпляра нет такого Map и create параметр true, создает один и возвращает это.

 boolean isInView()
          

Возвратиться trues.

 void processApplication(FacesContext context)
          Широковещательно передайте любые события, которые были поставлены в очередь для Вызвать фазы Приложения жизненного цикла обработки запросов и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным.
 void processDecodes(FacesContext context)
          
 void processRestoreState(FacesContext context, java.lang.Object state)
          

Реализация по умолчанию должна вызвать UIComponentBase#processRestoreState изнутри a try блок.

 void processUpdates(FacesContext context)
          
 void processValidators(FacesContext context)
          
 void queueEvent(FacesEvent event)
          Переопределите значение по умолчанию UIComponentBase#queueEvent поведение, чтобы накопить события с очередями для более поздней широковещательной передачи.
 void removeComponentResource(FacesContext context, UIComponent componentResource)
          

Удалите параметр component, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.

 void removeComponentResource(FacesContext context, UIComponent componentResource, java.lang.String target)
          

Удалите параметр component, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.

 void removePhaseListener(PhaseListener toRemove)
          Если параметр toRemove находится в списке PhaseListeners для этого экземпляра, это должно быть удалено.
 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)
          

Установите экземпляр слушателя, на который ссылается параметр listener в UIViewRoot как слушатель для событий типа systemEventClass.

 void unsubscribeFromViewEvent(java.lang.Class<? extends SystemEvent> systemEvent, SystemEventListener listener)
          

Удалите экземпляр слушателя, на который ссылается параметр listener от UIViewRoot как слушатель для событий типа systemEventClass.

 
Методы, наследованные от class javax.faces.component. UIComponentBase
addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processSaveState, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
 
Методы, наследованные от class javax.faces.component. UIComponent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setValueExpression, visitTree
 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

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

METADATA_FACET_NAME

public static final java.lang.String METADATA_FACET_NAME
См. Также:
Постоянные Значения полей

VIEW_PARAMETERS_KEY

public static final java.lang.String VIEW_PARAMETERS_KEY

Ключ в наборе значений метаданных представления BeanDescriptor, значение которого является a List<UIViewParameter.Reference>.

С тех пор:
2.0
См. Также:
Постоянные Значения полей

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

Стандартный компонент вводит для этого компонента.

См. Также:
Постоянные Значения полей

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

Стандартное компонентное семейство для этого компонента.

См. Также:
Постоянные Значения полей

UNIQUE_ID_PREFIX

public static final java.lang.String UNIQUE_ID_PREFIX

Префикс, который будет использоваться для идентификаторов, сгенерированных createUniqueId() метод.

См. Также:
Постоянные Значения полей
Деталь конструктора

UIViewRoot

public UIViewRoot()

Создайте новое UIViewRoot экземпляр со значениями свойств значения по умолчанию.

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

isInView

public boolean isInView()

Возвратиться trues.

Переопределения:
isInView в class UIComponent
С тех пор:
2.0

setInView

public void setInView(boolean isInView)

Переопределенный, чтобы предпринять меры.

Переопределения:
setInView в class UIComponent
Параметры:
isInView -
С тех пор:
2.0

getFamily

public java.lang.String getFamily()
Описание скопировало с class: UIComponent

Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. Этот идентификатор, в соединении со значением rendererType свойство, может использоваться, чтобы выбрать соответствующее Renderer для этого компонентного экземпляра.

Определенный:
getFamily в class UIComponent
См. Также:
UIComponent#getFamily()

getRenderKitId

public java.lang.String getRenderKitId()

Возвратите представлять идентификатор набора RenderKit связанный с этим представлением. Если явно не установлено, как в ViewHandler.createView(javax.faces.context.FacesContext, java.lang.String), возвращенное значение будет null.


setRenderKitId

public void setRenderKitId(java.lang.String renderKitId)

Установите представлять идентификатор набора RenderKit связанный с этим представлением. Этот метод можно вызвать в любое время между концом, Применяют фазу Значений Запроса жизненного цикла обработки запросов (то есть когда события широковещательно передаются), и начало Представлять фазы Ответа.

Параметры:
renderKitId - Новое RenderKit идентификатор, или null разъединять это представление с любым определенным RenderKit экземпляр

getViewId

public java.lang.String getViewId()

Возвратите идентификатор представления для этого представления.


setViewId

public void setViewId(java.lang.String viewId)

Установите идентификатор представления для этого представления.

Параметры:
viewId - Новый идентификатор представления

getBeforePhaseListener

public MethodExpression getBeforePhaseListener()

Возвратитесь MethodExpression это будет вызвано прежде, чем это представление представляется.

Возвраты:
MethodExpression это будет вызвано прежде, чем это представление представляется.
С тех пор:
1.2

setBeforePhaseListener

public void setBeforePhaseListener(MethodExpression newBeforePhase)

Позвольте произвольному методу быть вызванным для "beforePhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. Этот метод вызовут для всех фаз кроме PhaseId#RESTORE_VIEW. В отличие от истины PhaseListener, этот подход не учитывает только получение PhaseEvents для данной фазы.

Метод должен соответствовать подписи PhaseListener#beforePhase.

Параметры:
newBeforePhase - MethodExpression это будет вызвано прежде, чем это представление представляется.
С тех пор:
1.2

getAfterPhaseListener

public MethodExpression getAfterPhaseListener()

Возвратитесь MethodExpression это будет вызвано после того, как это представление представляется.

Возвраты:
MethodExpression это будет вызвано после того, как это представление представляется.
С тех пор:
1.2

setAfterPhaseListener

public void setAfterPhaseListener(MethodExpression newAfterPhase)

Позвольте произвольному методу быть вызванным для "afterPhase" события, поскольку UIViewRoot пробегает свой жизненный цикл. Этот метод вызовут для всех фаз включая PhaseId#RESTORE_VIEW. В отличие от истины PhaseListener, этот подход не учитывает только получение PhaseEvents для данной фазы.

Метод должен соответствовать подписи PhaseListener#afterPhase.

Параметры:
newAfterPhase - MethodExpression это будет вызвано после того, как это представление представляется.
С тех пор:
1.2

removePhaseListener

public void removePhaseListener(PhaseListener toRemove)

Если параметр toRemove находится в списке PhaseListeners для этого экземпляра, это должно быть удалено.

Параметры:
toRemove - PhaseListener удалить.
С тех пор:
1.2

addPhaseListener

public void addPhaseListener(PhaseListener newPhaseListener)

Добавьте параметр newPhaseListener к списку PhaseListeners на этом UIViewRoot.

Параметры:
newPhaseListener - PhaseListener добавить
С тех пор:
1.2

getPhaseListeners

public java.util.List<PhaseListener> getPhaseListeners()

Возвратите неподдающийся изменению список PhaseListener экземпляры, присоединенные к этому UIViewRoot экземпляр.

С тех пор:
2.0

addComponentResource

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 экземпляр
С тех пор:
2.0

addComponentResource

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 будет добавлен
С тех пор:
2.0

getComponentResources

public java.util.List<UIComponent> getComponentResources(FacesContext context,
                                                         java.lang.String target)

Возвратите неподдающееся изменению List из UIComponents для обеспеченного target agrument. Каждый component в List как предполагается, представляет экземпляр ресурса.

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

  • Определите местоположение фасета для component вызывая getFacet() использование target как параметр.
  • Если фасет не находится, создайте фасет, вызывая context.getApplication().createComponent(). Параметр этому методу должен обратиться к компоненту, который расширяется UIPanel и переопределения encodeAll() метод, чтобы предпринять меры. Это необходимо, чтобы препятствовать тому, чтобы компонентные ресурсы были непреднамеренно представлены.
    • Установите id из фасета, чтобы быть строкой, создаваемой, предварительно ожидая литеральная строка“javax_faces_location_”(без кавычек) к значению target параметр
    • Добавьте фасет к фасетам Map использование target как ключ
  • возвратите дочерние элементы фасета

Параметры:
target - Имя фасета, для которого будут возвращены компоненты.
Возвраты:
A List из UIComponent дочерние элементы фасета с именем target. Если никакие дочерние элементы не находятся для фасета, возвратиться Collections.emptyList().
Броски:
java.lang.NullPointerException - если target или context null
С тех пор:
2.0

removeComponentResource

public void removeComponentResource(FacesContext context,
                                    UIComponent componentResource)

Удалите параметр component, который, как предполагается, представляет экземпляр ресурса как ресурс к этому представлению.

Параметры:
context - FacesContext для текущего запроса
componentResource - UIComponent представление a Resource экземпляр
С тех пор:
2.0

removeComponentResource

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 будет добавлен
С тех пор:
2.0

queueEvent

public void queueEvent(FacesEvent event)

Переопределите значение по умолчанию UIComponentBase#queueEvent поведение, чтобы накопить события с очередями для более поздней широковещательной передачи.

Переопределения:
queueEvent в class UIComponentBase
Параметры:
event - FacesEvent быть поставленным в очередь
Броски:
IllegalStateException - если этот компонент не является потомком a UIViewRoot
java.lang.NullPointerException - если event null

broadcastEvents

public void broadcastEvents(FacesContext context,
                            PhaseId phaseId)

Широковещательно передайте любые события, которые были поставлены в очередь. Сначала широковещательные события, которые были поставлены в очередь для PhaseId#ANY_PHASE. Затем широковещательная передача ane события, которые были поставлены в очередь для текущей фазы. В обоих случаях, UIComponent#pushComponentToEL должен быть вызван прежде, чем событие широковещательно передается, и UIComponent#popComponentFromEL должен быть вызван после возврата из широковещательной передачи, даже в случае исключения.

Параметры:
context - FacesContext для текущего запроса
phaseId - PhaseId из текущей фазы
С тех пор:
2.0

processRestoreState

public void processRestoreState(FacesContext context,
                                java.lang.Object state)

Реализация по умолчанию должна вызвать UIComponentBase#processRestoreState изнутри a try блок. try у блока должен быть a finally блок, который гарантирует что нет FacesEvents остаются в конечном счете очередью.    

Переопределения:
processRestoreState в class UIComponentBase
Параметры:
context - FacesContext для этого requets
state - непрозрачный объект состояния, полученный из StateManager

processDecodes

public void processDecodes(FacesContext context)

Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId) с PhaseId#APPLY_REQUEST_VALUES если:

Выполните полную обработку, вызывая UIComponentBase#processDecodes если одно из следующих условий встречается:

Переопределите значение по умолчанию UIComponentBase#processDecodes поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным.

Переопределения:
processDecodes в class UIComponentBase
Параметры:
context - FacesContext для запроса мы обрабатываем
Броски:
java.lang.NullPointerException - если context null

encodeBegin

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 - если ввод/ошибка на выходе происходит, представляя

encodeChildren

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 - если ввод/ошибка на выходе происходит, представляя
С тех пор:
2.0

encodeEnd

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 - если ввод/ошибка на выходе происходит, представляя

getRendersChildren

public boolean getRendersChildren()

Вызвать UIComponentBase#getRendersChildren Если PartialViewContext.isAjaxRequest() возвраты true этот метод должен возвратиться true.

Переопределения:
getRendersChildren в class UIComponentBase
С тех пор:
2.0

processValidators

public void processValidators(FacesContext context)

Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId) с PhaseId#PROCESS_VALIDATIONS если:

Выполните полную обработку, вызывая UIComponentBase#processValidators если одно из следующих условий встречается:

Переопределите значение по умолчанию UIComponentBase#processValidators поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным.

Переопределения:
processValidators в class UIComponentBase
Параметры:
context - FacesContext для запроса мы обрабатываем
Броски:
java.lang.NullPointerException - если context null

processUpdates

public void processUpdates(FacesContext context)

Выполните частичную обработку, вызывая PartialViewContext.processPartial(javax.faces.event.PhaseId) с PhaseId#UPDATE_MODEL_VALUES если:

Выполните полную обработку, вызывая UIComponentBase#processUpdates если одно из следующих условий встречается:

Переопределите значение по умолчанию UIComponentBase поведение, чтобы широковещательно передать любые события с очередями после обработки значения по умолчанию или частичной обработки было завершено и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным.

Переопределения:
processUpdates в class UIComponentBase
Параметры:
context - FacesContext для запроса мы обрабатываем
Броски:
java.lang.NullPointerException - если context null

processApplication

public void processApplication(FacesContext context)

Широковещательно передайте любые события, которые были поставлены в очередь для Вызвать фазы Приложения жизненного цикла обработки запросов и убрать любые события для более поздних фаз если обработка событий для этой вызванной фазы FacesContext#renderResponse или FacesContext#responseComplete быть вызванным.

Параметры:
context - FacesContext для запроса мы обрабатываем
Броски:
java.lang.NullPointerException - если context null

createUniqueId

public java.lang.String createUniqueId()

Генерируйте идентификатор для компонента. Идентификатор будет снабжен префиксом UNIQUE_ID_PREFIX, и будет уникален в пределах этого UIViewRoot.


createUniqueId

public java.lang.String createUniqueId(FacesContext context,
                                       java.lang.String seed)

Генерируйте идентификатор для компонента. Идентификатор будет снабжен префиксом UNIQUE_ID_PREFIX, и будет уникален в пределах этого UIViewRoot. Дополнительно, уникальное значение семени может быть предоставлено компонентными создателями, которые должны быть включены в сгенерированный уникальный идентификатор.

Определенный:
createUniqueId в интерфейсе UniqueIdVendor
Параметры:
context - FacesContext
seed - дополнительное значение семени - например, основанный на позиции компонента в VDL-шаблоне
Возвраты:
уникальный идентификатор в этом компонентном контейнере

getLocale

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 полученный, выполняя вышеупомянутый алгоритм.

setLocale

public void setLocale(java.util.Locale locale)

Установите Locale использоваться в локализации ответа, создаваемого для этого представления.

Параметры:
locale - Новая Локаль локализации

getViewMap

public java.util.Map<java.lang.String,java.lang.Object> getViewMap()

Эта реализация просто вызывает через к getViewMap(boolean), передача true как параметр, и возвраты результат.

С тех пор:
2.0

getViewMap

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.
С тех пор:
2.0

subscribeToViewEvent

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.
С тех пор:
2.0

unsubscribeFromViewEvent

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.
С тех пор:
2.0

getViewListenersForEventClass

public java.util.List<SystemEventListener> getViewListenersForEventClass(java.lang.Class<? extends SystemEvent> systemEvent)

Возвратитесь SystemEventListener экземпляры зарегистрировались на этом UIComponent экземпляр, которые интересуются событиями типа eventClass.

Параметры:
systemEvent - Class из события, для которого должны быть возвращены слушатели.
Броски:
java.lang.NullPointerException - если параметр systemEvent null.
С тех пор:
2.0

saveState

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

restoreState

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


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter