UIComponent (EE Java 6)

Spec-Zone .ru

спецификации, руководства, описания, API

Краткий обзор

Пакет

Класс

Дерево

Устаревшие

Индексировать

Справка

ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС

ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ

СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД

ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД

javax.faces.component
Класс UIComponent

java.lang.Object
  javax.faces.component.UIComponent

Все Реализованные Интерфейсы:: java.util. EventListener, PartialStateHolder, StateHolder, TransientStateHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder

Прямые Известные Подклассы:: UIComponentBase

public abstract class UIComponent
расширяет java.lang. Объект
реализации PartialStateHolder, TransientStateHolder, SystemEventListenerHolder, ComponentSystemEventListener
расширяет java.lang. Объект
реализации PartialStateHolder, TransientStateHolder, SystemEventListenerHolder, ComponentSystemEventListener

UIComponent является основной class для всех компонентов пользовательского интерфейса в Поверхностях JavaServer. Набор UIComponent экземпляры, связанные с определенным запросом и ответом, организуются в компонентное дерево под a UIViewRoot это представляет весь контент запроса или ответа.

Для удобства компонентных разработчиков, UIComponentBase обеспечивает поведение значения по умолчанию, которое определяется для a UIComponent, и основной class для всего бетона UIComponent "основные" реализации. Компонентные писатели поощряются разделить на подклассы UIComponentBase, вместо того, чтобы непосредственно реализовать этот абстрактный class, уменьшить воздействие любого будущего изменяется на сигнатуры методов.

Если ListenerFor аннотация присоединена к определению class a Component, тот class должен также реализовать ComponentSystemEventListener.

Полевая Сводка
`static java.lang.String`	`ATTRS_WITH_DECLARED_DEFAULT_VALUES` Эта константа позволяет тому быстро обнаружить имена объявленных составных компонентных атрибутов, которым дал значения по умолчанию составной компонентный автор.
`static java.lang.String`	`BEANINFO_KEY` Значение этой константы используется в качестве ключа в компонентной карте атрибута, значении, для которого a `java.beans.BeanInfo` реализация, описывающая составной компонент.
`protected java.util.Map<java.lang.String,ValueExpression>`	`привязка` Осуждаемый.
`static java.lang.String`	`COMPOSITE_COMPONENT_TYPE_KEY` Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для a `ValueExpression` это оценивает к `component-type` из составного компонентного корня `UIComponent` для этого составного компонента, если Вы были объявлены составным компонентным автором.
`static java.lang.String`	`COMPOSITE_FACET_NAME` Значение этой константы используется в качестве ключа `Map` возвращенный как описано в `FACETS_KEY` для `PropertyDescriptor` описание составного компонентного фасета.
`static java.lang.String`	`CURRENT_COMPONENT` Ключ тот, к который `UIComponent` в настоящий момент быть обработанным будет связано с в пределах `FacesContext` карта атрибутов.
`static java.lang.String`	`CURRENT_COMPOSITE_COMPONENT` Ключ тот, к который составной объект `UIComponent` в настоящий момент быть обработанным будет связано с в пределах `FacesContext` карта атрибутов.
`static java.lang.String`	`FACETS_KEY` Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для `Map<PropertyDescriptor>` это содержит метаинформацию для объявленных фасетов для этого составного компонента.
`static java.lang.String`	`HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME` `ServletContext` параметр init, с которым консультируются `UIComponent` сказать действительно ли `CURRENT_COMPONENT` и `CURRENT_COMPOSITE_COMPONENT` ключи атрибута нужно соблюдать как определено.
`static java.lang.String`	`VIEW_LOCATION_KEY` Значение этой константы используется в качестве ключа в компонентных атрибутах `Map` для `Location` в представлении, при котором находится этот компонентный экземпляр.

Сводка конструктора
`UIComponent()`

Сводка метода
`protected abstract void`	`addFacesListener(FacesListener listener)` Добавьте указанное `FacesListener` к группе слушателей, зарегистрированных, чтобы получить уведомления о событии от этого `UIComponent`.
`abstract void`	`broadcast(FacesEvent event)` Широковещательно передайте указанное `FacesEvent` всем зарегистрированным слушателям события, которые выразили интерес к событиям этого типа.
`void`	`clearInitialState()` Реализация `PartialStateHolder#clearInitialState`, этот метод вызывает время выполнения, чтобы сказать экземпляру прекращать отслеживать изменения состояния.
`abstract void`	`decode(FacesContext context)` Декодируйте любое новое состояние этого `UIComponent` от запроса, содержавшегося в указанном `FacesContext`, и сохраните это состояние как необходимый.
`void`	`encodeAll(FacesContext context)` Если этот компонент возвращается `true` от `isRendered()`, предпримите следующие меры.
`abstract void`	`encodeBegin(FacesContext context)` Если наш `rendered` свойство `true`, представьте начало текущего состояния этого `UIComponent` к ответу, содержавшемуся в указанном `FacesContext`.
`abstract void`	`encodeChildren(FacesContext context)` Если наш `rendered` свойство `true`, представьте дочерний элемент `UIComponent`s этого `UIComponent`.
`abstract void`	`encodeEnd(FacesContext context)` Если наш `rendered` свойство `true`, представьте окончание текущего состояния этого `UIComponent`.
`abstract UIComponent`	`findComponent(java.lang.String expr)` Ищите и возвратитесь `UIComponent` с `id` это соответствует указанное выражение поиска (если любой) согласно алгоритму, описанному ниже.
`abstract java.util.Map<java.lang.String,java.lang.Object>`	`getAttributes()` Возвратите изменчивое `Map` представляя атрибуты (и свойства, см. ниже), связал wth это `UIComponent`, включенный названием атрибута (который должен быть Строкой).
`abstract int`	`getChildCount()` Возвратите число дочернего элемента `UIComponent`s, которые связываются с этим `UIComponent`.
`abstract java.util.List<UIComponent>`	`getChildren()` Возвратите изменчивое `List` представление дочернего элемента `UIComponent`s связанный с этим компонентом.
`java.lang.String`	`getClientId()` Включите ЭЛЬ к доступу `clientId` из компонента.
`abstract java.lang.String`	`getClientId(FacesContext context)` Возвратите клиентский идентификатор для этого компонента, генерируя один в случае необходимости.
`static UIComponent`	`getCompositeComponentParent(UIComponent component)` Находит самого близкого составного компонентного родителя указанного компонента.
`java.lang.String`	`getContainerClientId(FacesContext context)` Позвольте компонентам ту реализацию `NamingContainer` выборочно отключить предварительное ожидание их clientId к clientIds их потомка, повреждая логику предна ожидании в seperately вызываемый метод.
`static UIComponent`	`getCurrentComponent(FacesContext context)` Возвратитесь `UIComponent` экземпляр, который в настоящий момент обрабатывает.
`static UIComponent`	`getCurrentCompositeComponent(FacesContext context)` Возвратите самый близкий компонент предка относительно компонента, возвращенного из `getCurrentComponent(javax.faces.context.FacesContext)`, это - составной компонент, или `null` если никакой такой компонент не существует.
`protected abstract FacesContext`	`getFacesContext()` Метод удобства, чтобы возвратиться `FacesContext` экземпляр для текущего запроса.
`protected abstract FacesListener[]`	`getFacesListeners(java.lang.Class clazz)` Возвратите массив зарегистрированных `FacesListener`s, которые являются экземплярами указанного class.
`abstract UIComponent`	`getFacet(java.lang.String name)` Метод удобства, чтобы возвратить именованный фасет, если это существует, или `null` иначе.
`int`	`getFacetCount()` Возвратите число фасета `UIComponent`s, которые связываются с этим `UIComponent`.
`abstract java.util.Map<java.lang.String,UIComponent>`	`getFacets()` Возвратите изменчивое `Map` представление фасета `UIComponent`s связанный с этим `UIComponent`, включенный фасетным именем (который должен быть Строкой).
`abstract java.util.Iterator<UIComponent>`	`getFacetsAndChildren()` Возвратитесь `Iterator` по фасету, сопровождаемому дочерним элементом `UIComponent`s этого `UIComponent`.
`abstract java.lang.String`	`getFamily()` Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент.
`abstract java.lang.String`	`getId()` Возвратите компонентный идентификатор этого `UIComponent`.
`java.util.List<SystemEventListener>`	`getListenersForEventClass(java.lang.Class<? extends SystemEvent> eventClass)` Эта реализация броски `UnsupportedOperationException` и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class.
`UIComponent`	`getNamingContainer()` Запускаясь с "этого", возвратите самый близкий компонент в родословной, которая является a `NamingContainer` или `null` если ни один не может быть найден.
`abstract UIComponent`	`getParent()` Возвратите родителя `UIComponent` из этого `UIComponent`, если любой.
`protected abstract Renderer`	`getRenderer(FacesContext context)` Метод удобства, чтобы возвратиться `Renderer` экземпляр, связанный с этим компонентом, если любой; иначе, возвратиться `null`.
`abstract java.lang.String`	`getRendererType()` Возвратитесь `Renderer` введите для этого `UIComponent` (если любой).
`abstract boolean`	`getRendersChildren()` Возвратите флаг, указывающий, ответственен ли этот компонент за рендеринг его дочерних компонентов.
`java.util.Map<java.lang.String,java.lang.String>`	`getResourceBundleMap()` Возвратите a `Map<String,String>` из `ResourceBundle` для этого компонента.
`protected StateHelper`	`getStateHelper()` Возвратитесь `StateHelper` экземпляр, используемый, чтобы помочь этой компонентной реализации `PartialStateHolder`.
`protected StateHelper`	`getStateHelper(boolean create)` Как `getStateHelper()`, но только создайте экземпляр помощника состояния если параметр `creat` `true`.
`TransientStateHelper`	`getTransientStateHelper()` Возвратитесь `TransientStateHelper` экземпляр для этого `UIComponent` экземпляр.
`TransientStateHelper`	`getTransientStateHelper(boolean create)` Возвратитесь `TransientStateHelper` экземпляр для этого `UIComponent` экземпляр.
`abstract ValueBinding`	`getValueBinding(java.lang.String name)` Осуждаемый. Это было заменено `getValueExpression(java.lang.String)`.
`ValueExpression`	`getValueExpression(java.lang.String name)` Возвратитесь `ValueExpression` используемый, чтобы вычислить значение для указанного атрибута или имени свойства, если любой.
`boolean`	`initialStateMarked()` Реализация `PartialStateHolder#initialStateMarked`, этот метод вызывает время выполнения, чтобы протестировать если `PartialStateHolder#markInitialState` метод вызвали.
`boolean`	`invokeOnComponent(FacesContext context, java.lang.String clientId, ContextCallback callback)` Запускаясь в этом компоненте в иерархии Представления, ищите компонент с a `clientId` равный параметру `clientId` и, если найдено, вызовите `ContextCallback#invokeContextCallback` метод на параметре `callback`, передача тока `FacesContext` и найденный компонент как параметры.
`static boolean`	`isCompositeComponent(UIComponent component)` Возвратиться `true` если `component` составной компонент, иначе `false`.
`boolean`	`isInView()` Возвратиться `true` если этот компонент в пределах иерархии представления иначе `false`
`abstract boolean`	`isRendered()` Возвратиться `true` если этот компонент (и его дочерние элементы) должен быть представлен во время Представлять фазы Ответа жизненного цикла обработки запросов.
`protected boolean`	`isVisitable(VisitContext context)` Возвратиться `true` если этот компонент нужно посетить, `false` иначе.
`void`	`markInitialState()` Реализация `PartialStateHolder#markInitialState`, этот метод вызывает время выполнения, чтобы указать, что экземпляр должен начать отслеживать изменения к своему состоянию.
`void`	`popComponentFromEL(FacesContext context)` Вытолкайте ток `UIComponent` от `FacesContext` атрибуты отображаются так, чтобы предыдущее `UIComponent`, если таковые вообще имеются, становится текущим компонентом.
`abstract void`	`processDecodes(FacesContext context)` Выполните компонентное дерево обработка необходимого Применять фазой Значений Запроса жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.
`void`	`processEvent(ComponentSystemEvent event)` Реализация по умолчанию выполняет следующее действие.
`abstract void`	`processRestoreState(FacesContext context, java.lang.Object state)` Выполните компонентное дерево обработка необходимого фазой Представления Восстановления жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.
`abstract java.lang.Object`	`processSaveState(FacesContext context)` Выполните компонентное дерево обработка необходимого частью сохранения состояния Представлять фазы Ответа жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.
`abstract void`	`processUpdates(FacesContext context)` Выполните компонентное дерево обработка необходимого фазой Значений Модели Обновления жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.
`abstract void`	`processValidators(FacesContext context)` Выполните компонентное дерево обработка необходимого фазой Проверок допустимости Процесса жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.
`void`	`pushComponentToEL(FacesContext context, UIComponent component)` Продвиньте ток `UIComponent` `this` к `FacesContext` припишите карту, используя ключ `CURRENT_COMPONENT` сохранение предыдущего `UIComponent` связанный с `CURRENT_COMPONENT` для последующего звонка `popComponentFromEL(javax.faces.context.FacesContext)`.
`abstract void`	`queueEvent(FacesEvent event)` Поставьте событие в очередь для широковещательной передачи в конце текущей фазы жизненного цикла обработки запросов.
`protected abstract void`	`removeFacesListener(FacesListener listener)` Удалите указанное `FacesListener` от группы слушателей, зарегистрированных, чтобы получить уведомления о событии от этого `UIComponent`.
`void`	`restoreTransientState(FacesContext context, java.lang.Object state)` Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод восстановит любое состояние, на котором экономят предшествующий звонок `saveTransientState(javax.faces.context.FacesContext)`.
`java.lang.Object`	`saveTransientState(FacesContext context)` Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод сохранит любое состояние, которое, как известно, является переходным процессом в природе.
`abstract void`	`setId(java.lang.String id)` Установите компонентный идентификатор этого `UIComponent` (если любой).
`void`	`setInView(boolean isInView)` Обновляет состояние относительно того, является ли этот компонент в настоящий момент в пределах иерархии представления.
`abstract void`	`setParent(UIComponent parent)` Установите родителя `UIComponent` из этого `UIComponent`.
`abstract void`	`setRendered(boolean rendered)` Установите `rendered` свойство этого `UIComponent`.
`abstract void`	`setRendererType(java.lang.String rendererType)` Установите `Renderer` введите для этого `UIComponent`, или `null` для компонентов, которые представляют себя.
`abstract void`	`setValueBinding(java.lang.String name, ValueBinding binding)` Осуждаемый. Это было заменено `setValueExpression(java.lang.String, javax.el.ValueExpression)`.
`void`	`setValueExpression(java.lang.String name, ValueExpression binding)` Установите `ValueExpression` используемый, чтобы вычислить значение для указанного атрибута или имени свойства, если любой.
`void`	`subscribeToEvent(java.lang.Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)` Эта реализация броски `UnsupportedOperationException` и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class.
`void`	`unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)` Эта реализация броски `UnsupportedOperationException` и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class.
`boolean`	`visitTree(VisitContext context, VisitCallback callback)` Выполните древовидное посещение, запускающееся в этом узле в дереве.

Методы, наследованные от class java.lang. Объект
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Методы, наследованные от интерфейса javax.faces.component. StateHolder
`isTransient, restoreState, saveState, setTransient`

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

HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME

public static final java.lang.String HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME

ServletContext параметр init, с которым консультируются UIComponent сказать действительно ли CURRENT_COMPONENT и CURRENT_COMPOSITE_COMPONENT ключи атрибута нужно соблюдать как определено.

Если эти параметры не определяются, или устанавливаются ко лжи, контракт, определенный CURRENT_COMPONENT и CURRENT_COMPOSITE_COMPONENT метод не соблюдают. Если эти параметры устанавливаются к истине, контракт соблюдают.

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

CURRENT_COMPONENT

public static final java.lang.String CURRENT_COMPONENT

Ключ тот, к который UIComponent в настоящий момент быть обработанным будет связано с в пределах FacesContext карта атрибутов.

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

CURRENT_COMPOSITE_COMPONENT

public static final java.lang.String CURRENT_COMPOSITE_COMPONENT

Ключ тот, к который составной объект UIComponent в настоящий момент быть обработанным будет связано с в пределах FacesContext карта атрибутов.

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

BEANINFO_KEY

public static final java.lang.String BEANINFO_KEY

Значение этой константы используется в качестве ключа в компонентной карте атрибута, значении, для которого a java.beans.BeanInfo реализация, описывающая составной компонент. Это BeanInfo известен как составной компонент BeanInfo.

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

FACETS_KEY

public static final java.lang.String FACETS_KEY

Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для Map<PropertyDescriptor> это содержит метаинформацию для объявленных фасетов для этого составного компонента. Эта карта должна содержать запись под ключом COMPOSITE_FACET_NAME, даже если никакие фасеты не были явно объявлены. См. COMPOSITE_FACET_NAME.

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

VIEW_LOCATION_KEY

public static final java.lang.String VIEW_LOCATION_KEY

Значение этой константы используется в качестве ключа в компонентных атрибутах Map для Location в представлении, при котором находится этот компонентный экземпляр.

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

COMPOSITE_COMPONENT_TYPE_KEY

public static final java.lang.String COMPOSITE_COMPONENT_TYPE_KEY

Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для a ValueExpression это оценивает к component-type из составного компонентного корня UIComponent для этого составного компонента, если Вы были объявлены составным компонентным автором.

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

COMPOSITE_FACET_NAME

public static final java.lang.String COMPOSITE_FACET_NAME

Значение этой константы используется в качестве ключа Map возвращенный как описано в FACETS_KEY для PropertyDescriptor описание составного компонентного фасета. Значение этой константы также используется в качестве ключа Map возвращенный из getFacets(). В этом случае это обращается к фактическому фасету, который является UIPanel это - родитель всех компонентов в <composite:implementation> раздел составного компонента файл VDL.

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

ATTRS_WITH_DECLARED_DEFAULT_VALUES

public static final java.lang.String ATTRS_WITH_DECLARED_DEFAULT_VALUES

Эта константа позволяет тому быстро обнаружить имена объявленных составных компонентных атрибутов, которым дал значения по умолчанию составной компонентный автор. Информация представляется как a Collection<String> возвращенный из getValue() метод на составном компоненте BeanDescriptor, когда эту константу передают как параметр.

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

привязка

@Deprecated
protected java.util.Map<java.lang.String,ValueExpression> bindings

Осуждаемый.

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

UIComponent

public UIComponent()

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

getAttributes

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

Возвратите изменчивое Map представляя атрибуты (и свойства, см. ниже), связал wth это UIComponent, включенный названием атрибута (который должен быть Строкой). Возвращенная реализация должна поддерживать все стандартные и дополнительные Map методы, плюс поддержка следующие дополнительные требования:

Map реализация должна реализовать java.io.Serializable интерфейс.
Любая попытка добавить a null ключ или значение должны бросить a NullPointerException.
Любая попытка добавить ключ, который не является Строкой, должна бросить a ClassCastException.
Если название атрибута, определенное как ключ, соответствует свойство этого UIComponent's реализация class, у следующих методов будет специальное поведение:
- containsKey - Возвратиться false.
- get() - Если свойство читаемо, вызовите метод метода get и возвратите возвращенное значение (обертывающий примитивные значения в их соответствующие классы обертки); иначе бросок IllegalArgumentException.
- put() - Если свойство является writeable, вызовите метод метода set, чтобы установить соответствующее значение (разворачивающий примитивные значения в их соответствующих классах обертки). Если свойство не является writeable, или попытка предпринимается, чтобы установить свойство типа примитива к null, бросок IllegalArgumentException.
- remove - Бросок IllegalArgumentException.

getValueBinding

public abstract ValueBinding getValueBinding(java.lang.String name)

Осуждаемый. Это было заменено getValueExpression(java.lang.String).

Вызовите через к getValueExpression(java.lang.String) и исследуйте результат. Если результатом является экземпляр обертки class, переданный под мандат в setValueBinding(java.lang.String, javax.faces.el.ValueBinding), извлеките ValueBinding экземпляр и возврат это. Иначе, оберните результат в реализацию ValueBinding, и возвратите это.

Параметры:: name - Имя атрибута или свойства, для которого можно получить a ValueBinding
Броски:: java.lang.NullPointerException - если name null

setValueBinding

public abstract void setValueBinding(java.lang.String name,
                                     ValueBinding binding)

Осуждаемый. Это было заменено setValueExpression(java.lang.String, javax.el.ValueExpression).

Оберните параметр binding в реализации ValueExpression и вызовите через к setValueExpression(java.lang.String, javax.el.ValueExpression).

Параметры:: name - Имя атрибута или свойства, для которого можно установить a ValueBinding; binding - ValueBinding установить, или null удалить любого в настоящий момент набор ValueBinding
Броски:: IllegalArgumentException - если name один из id или parent; java.lang.NullPointerException - если name null

getValueExpression

public ValueExpression getValueExpression(java.lang.String name)

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

Этот метод должен быть переопределен и реализован для компонентов, которые выполняют JSF 1.2 и позже.

Параметры:: name - Имя атрибута или свойства, для которого можно получить a ValueExpression
Броски:: java.lang.NullPointerException - если name null
С тех пор:: 1.2

setValueExpression

public void setValueExpression(java.lang.String name,
                               ValueExpression binding)

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

Реализация должна вызвать ValueExpression#isLiteralText на параметре expression. Если isLiteralText() возвраты true, вызвать ValueExpression#getValue по выражению параметра и передаче результат как value параметр в звонке this.getAttributes().put(name, value) где name параметр name. Если исключение выдается в результате вызова ValueExpression#getValue, оберните это в a FacesException и повторно бросьте это. Если isLiteralText() возвраты false, просто сохраните неоцененный expression параметр в наборе ValueExpressions под ключом, данным параметром name.

Этот метод должен быть переопределен и реализован для компонентов, которые выполняют JSF 1.2 и позже.

Параметры:: name - Имя атрибута или свойства, для которого можно установить a ValueExpression; binding - ValueExpression установить, или null удалить любого в настоящий момент набор ValueExpression
Броски:: IllegalArgumentException - если name один из id или parent; java.lang.NullPointerException - если name null
С тех пор:: 1.2

markInitialState

public void markInitialState()

Реализация PartialStateHolder#markInitialState, этот метод вызывает время выполнения, чтобы указать, что экземпляр должен начать отслеживать изменения к своему состоянию.

Определенный:: markInitialState в интерфейсе PartialStateHolder

С тех пор:: 2.0

initialStateMarked

public boolean initialStateMarked()

Реализация PartialStateHolder#initialStateMarked, этот метод вызывает время выполнения, чтобы протестировать если PartialStateHolder#markInitialState метод вызвали.

Определенный:: initialStateMarked в интерфейсе PartialStateHolder

С тех пор:: 2.0

clearInitialState

public void clearInitialState()

Реализация PartialStateHolder#clearInitialState, этот метод вызывает время выполнения, чтобы сказать экземпляру прекращать отслеживать изменения состояния.

Определенный:: clearInitialState в интерфейсе PartialStateHolder

С тех пор:: 2.0

getStateHelper

protected StateHelper getStateHelper()

Возвратитесь StateHelper экземпляр, используемый, чтобы помочь этой компонентной реализации PartialStateHolder.

С тех пор:: 2.0

getStateHelper

protected StateHelper getStateHelper(boolean create)

Как getStateHelper(), но только создайте экземпляр помощника состояния если параметр creat true.

Параметры:: create - если true, новое StateHelper экземпляр будет создаваться, если он уже не будет существовать. Если false, и там является не существующим StateHelper экземпляр, каждый не будет создаваться и null будет возвращен.
С тех пор:: 2.0

getTransientStateHelper

public final TransientStateHelper getTransientStateHelper()

Возвратитесь TransientStateHelper экземпляр для этого UIComponent экземпляр. Реализация по умолчанию просто вызывает через к getTransientStateHelper(boolean) передача true как параметр.

С тех пор:: 2.1

getTransientStateHelper

public TransientStateHelper getTransientStateHelper(boolean create)

Возвратитесь TransientStateHelper экземпляр для этого UIComponent экземпляр.

Параметры:: create - если true создайте, в случае необходимости, любые внутренние структуры данных. Если false, не создавайте экземпляры. В этом случае для этого метода возможно возвратиться null.
С тех пор:: 2.1

restoreTransientState

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

Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод восстановит любое состояние, на котором экономят предшествующий звонок saveTransientState(javax.faces.context.FacesContext).

Определенный:: restoreTransientState в интерфейсе TransientStateHolder

state - объект, содержащий переходные значения
С тех пор:: 2.1

saveTransientState

public java.lang.Object saveTransientState(FacesContext context)

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

Определенный:: saveTransientState в интерфейсе TransientStateHolder

Возвраты:: объект, содержащий переходные значения
С тех пор:: 2.1

isInView

public boolean isInView()

Возвратиться true если этот компонент в пределах иерархии представления иначе false

С тех пор:: 2.0

setInView

public void setInView(boolean isInView)

Обновляет состояние относительно того, является ли этот компонент в настоящий момент в пределах иерархии представления. Этот метод никогда не должны вызывать разработчики; a UIComponent's внутренняя реализация вызовет это, поскольку компоненты добавляются к или удаляются от дочернего элемента родителя List или фасет Map.

Параметры:: isInView - флаг, указывающий, является ли этот компонент в пределах представления hierachy
С тех пор:: 2.0

getClientId

public java.lang.String getClientId()

Включите ЭЛЬ к доступу clientId из компонента. Это особенно полезно в комбинации с component и cc неявные объекты. Реализация по умолчанию - то, при условии, что просто вызывает FacesContext#getCurrentInstance и затем вызовы через к getClientId(FacesContext).

С тех пор:: 2.0

getClientId

public abstract java.lang.String getClientId(FacesContext context)

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

Возврат из этого метода не должен быть тем же самым значением всюду по времени жизни экземпляра, если id свойство компонента изменяется, или компонент помещается в a NamingContainer чей клиентский ID изменяется (например, UIData). Однако, даже в этих случаях, последовательные звонки в этот метод должны всегда возвращать то же самое значение. Реализация должна следовать за этими шагами в определении clientId:

Найдите самого близкого предка к этому компоненту в иерархии представления, которая реализует NamingContainer. Вызвать getContainerClientId() на этом и сохраняют результат как parentId локальная переменная. Вызвать getId() на этом компоненте и сохраняют результат как myId локальная переменная. Если myId null, вызвать context.getViewRoot().createUniqueId() и присвойте результат myId. Если parentId не -null, позволить myId равный parentId + UINamingContainer#getSeparatorChar + myId. Вызвать Renderer#convertClientId, передача myId, и возвратите результат.

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

getContainerClientId

public java.lang.String getContainerClientId(FacesContext context)

Позвольте компонентам ту реализацию NamingContainer выборочно отключить предварительное ожидание их clientId к clientIds их потомка, повреждая логику предна ожидании в seperately вызываемый метод. См. getClientId() для использования.

По умолчанию этот метод вызовет через к getClientId() и возвратите результат.

Броски:: java.lang.NullPointerException - если context null
С тех пор:: 1.2

getFamily

public abstract java.lang.String getFamily()

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

getId

public abstract java.lang.String getId()

Возвратите компонентный идентификатор этого UIComponent.

setId

public abstract void setId(java.lang.String id)

Установите компонентный идентификатор этого UIComponent (если любой). Компонентные идентификаторы должны повиноваться следующим ограничениям синтаксиса:

Не должна быть Строка нулевая длиной.
Первый символ должен быть буквой или подчеркиванием (' _ ').
Последующие символы должны быть буквой, цифрой, подчеркивание (' _ '), или тире ('-').

Компонентные идентификаторы должны также повиноваться, следующие семантические ограничения (отметьте, что это ограничение НЕ осуществляется setId() реализация):

Указанный идентификатор должен быть уникальным среди всех компонентов (включая фасеты), которые являются потомками самого близкого предка UIComponent это - a NamingContainer, или в рамках всего компонентного дерева, если нет такого предка, который является a NamingContainer.

Параметры:: id - Новый компонентный идентификатор, или null указать что это UIComponent не имеет компонентного идентификатора
Броски:: IllegalArgumentException - если id не синтаксически допустимо

getParent

public abstract UIComponent getParent()

Возвратите родителя UIComponent из этого UIComponent, если любой. Компонент должен позволить дочерним компонентам быть добавленными к и удаленными из списка дочерних элементов этого компонента, даже при том, что дочерний компонент возвращает нуль из getParent( ).

setParent

public abstract void setParent(UIComponent parent)

Установите родителя UIComponent из этого UIComponent. Если parent.isInView() возвраты true, вызов этого метода сначала вызовет a PreRemoveFromViewEvent быть опубликованным, для этого узла, и затем дочерних элементов этого узла. Затем, как только перепорождение произошло, a PostAddToViewEvent будет опубликован также, сначала для этого узла, и затем для дочерних элементов узла, но только если любое из следующих условий является истиной.

FacesContext.getCurrentPhaseId() возвраты PhaseId.RESTORE_VIEW и частичное сохранение состояния включается.
FacesContext.isPostback() возвраты false и FacesContext.getCurrentPhaseId() возвраты что-то другое чем PhaseId.RESTORE_VIEW

Этот метод никогда не должны вызывать разработчики; a UIComponent's внутренняя реализация вызовет это, поскольку компоненты добавляются к или удаляются от дочернего элемента родителя List или фасет Map.

Параметры:: parent - Новый родитель, или null для корневого узла компонентного дерева

isRendered

public abstract boolean isRendered()

Возвратиться true если этот компонент (и его дочерние элементы) должен быть представлен во время Представлять фазы Ответа жизненного цикла обработки запросов.

setRendered

public abstract void setRendered(boolean rendered)

Установите rendered свойство этого UIComponent.

Параметры:: rendered - Если true представьте этот компонент; иначе, не представляйте этот компонент

getRendererType

public abstract java.lang.String getRendererType()

Возвратитесь Renderer введите для этого UIComponent (если любой).

setRendererType

public abstract void setRendererType(java.lang.String rendererType)

Установите Renderer введите для этого UIComponent, или null для компонентов, которые представляют себя.

Параметры:: rendererType - Логический идентификатор типа Renderer использовать, или null для компонентов, которые представляют себя

getRendersChildren

public abstract boolean getRendersChildren()

Возвратите флаг, указывающий, ответственен ли этот компонент за рендеринг его дочерних компонентов. Реализация по умолчанию в UIComponentBase#getRendersChildren попытки найти средство рендеринга для этого компонента. Если это делает, это вызывает Renderer#getRendersChildren и возвращает результат. Если это не делает, это возвращает false. С версии 1.2 Спецификации Поверхностей JavaServer компонентные авторы поощряются возвратиться true от этого метода и полагаются UIComponentBase#encodeChildren.

getResourceBundleMap

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

Возвратите a Map<String,String> из ResourceBundle для этого компонента. У компонента может быть a ResourceBundle связанный с этим. Этот пакет может содержать локализованные свойства, касающиеся экземпляров этого компонента. Реализация по умолчанию сначала ищет a ResourceBundle с базовым именем, равным полностью определенному имени class тока UIComponent this и Locale равный Locale из тока UIViewRoot. Если никакой такой пакет не находится, и компонент является составным компонентом, позвольте resourceName быть resourceName Resource для этого составного компонента, заменяя расширение файла ".properties". Позвольте libraryName быть libraryName Resource для этого составного компонента. Вызвать ResourceHandler.createResource(java.lang.String,java.lang.String), передача полученного resourceName и libraryName. Отметьте, что это автоматически учтет локализацию ResourceBundle из-за средства локализации, реализованного в createResource, который определяется в разделе JSF.2.6.1.3 документа прозы спецификации. Если результант Resource существует и может быть найден, InputStream поскольку ресурс используется, чтобы создать a ResourceBundle. Если любой из двух предыдущих шагов для того, чтобы получить ResourceBundle поскольку этот компонент успешен, ResourceBundle обертывается в a Map<String,String> и возвратился. Иначе Collections.EMPTY_MAP возвращается.

С тех пор:: 2.0

getChildren

public abstract java.util.List<UIComponent> getChildren()

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

List реализация должна реализовать java.io.Serializable интерфейс.
Любая попытка добавить a null должен бросить NullPointerException
Любая попытка добавить объект, который не реализует UIComponent должен бросить ClassCastException.
Всякий раз, когда новый дочерний компонент добавляется, parent свойство дочернего элемента должно быть установлено в этот компонентный экземпляр. Если parent свойство дочернего элемента уже было ненулем, дочерний элемент должен сначала быть удален из его предыдущего родителя (где это, возможно, был или дочерний элемент или фасет).
Всякий раз, когда существующий дочерний компонент удаляется, parent свойство дочернего элемента должно быть установлено в null.
После того, как дочерний компонент был добавлен к представлению, Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object) должен быть вызван, передавая PostAddToViewEvent.class как первый параметр и недавно добавленный компонент как второй параметр, если кто-либо следующие случаи является истиной.
- FacesContext.getCurrentPhaseId() возвраты PhaseId.RESTORE_VIEW и частичное сохранение состояния включается.
- FacesContext.isPostback() возвраты false и FacesContext.getCurrentPhaseId() возвраты что-то другое чем PhaseId.RESTORE_VIEW

getChildCount

public abstract int getChildCount()

Возвратите число дочернего элемента UIComponents, которые связываются с этим UIComponent. Если нет никаких дочерних элементов, этот метод должен возвратиться 0. Метод не должен вызвать создание дочернего компонентного списка.

findComponent

public abstract UIComponent findComponent(java.lang.String expr)

Ищите и возвратитесь UIComponent с id это соответствует указанное выражение поиска (если любой) согласно алгоритму, описанному ниже.

Для метода, чтобы найти компонент, данный простое clientId, см. invokeOnComponent(javax.faces.context.FacesContext, java.lang.String, javax.faces.component.ContextCallback).

Компонентные идентификаторы обязаны быть уникальными в рамках самого близкого предка NamingContainer это включает этот компонент (который мог бы быть этим компонентом непосредственно). Если есть нет NamingContainer компоненты в родословной этого компонента, корневой компонент в дереве обрабатывается, как будто это был a NamingContainer, реализует ли его class фактически NamingContainer интерфейс.

Выражение поиска состоит из любого идентификатор (который является соответствующим точно против id свойство a UIComponent, или серия таких идентификаторов, соединенных UINamingContainer#getSeparatorChar символьное значение. Алгоритм поиска должен работать следующим образом, хотя альтернатива alogrithms может использоваться, пока конечный результат является тем же самым:

Идентифицируйте UIComponent это будет основой для того, чтобы искать, останавливаясь, как только одно из следующих условий встречается:
- Если выражение поиска начнется с символа разделителя (названный "абсолютным" выражением поиска), то основа будет корнем UIComponent из компонентного дерева. Ведущий символ разделителя будет неизолированным, и остаток от выражения поиска будет обработан как "относительное" выражение поиска как описано ниже.
- Иначе, если это UIComponent a NamingContainer это будет служить основанием.
- Иначе, ищите родителей этого компонента. Если a NamingContainer встречается, это будет основа.
- Иначе (если нет NamingContainer встречается), корень UIComponent будет основа.
Выражение поиска (возможно измененный в предыдущем шаге) является теперь "относительным" выражением поиска, которое будет использоваться, чтобы определить местоположение компонента (если любой), который имеет id это соответствует, в рамках основного компонента. Соответствие выполняется следующим образом:
- Если выражение поиска является простым идентификатором, это значение по сравнению с id свойство, и затем рекурсивно через фасеты и дочерние элементы основы UIComponent (за исключением того, что, если потомок NamingContainer находится, его собственные фасеты и дочерние элементы не ищутся).
- Если выражение поиска включает больше чем один идентификатор, разделенный символом разделителя, первый идентификатор используется, чтобы определить местоположение a NamingContainer по правилам в предыдущем пункте маркированного списка. Затем, findComponent() метод этого NamingContainer будет вызван, передавая остаток от выражения поиска.

Параметры:: expr - Выражение поиска, идентифицирующее UIComponent быть возвращенным
Возвраты:: найденный UIComponent, или null если компонент не был найден.
Броски:: IllegalArgumentException - если промежуточный идентификатор в выражении поиска идентифицирует a UIComponent это не a NamingContainer; java.lang.NullPointerException - если expr null

invokeOnComponent

public boolean invokeOnComponent(FacesContext context,
                                 java.lang.String clientId,
                                 ContextCallback callback)
                          throws FacesException

Запускаясь в этом компоненте в иерархии Представления, ищите компонент с a clientId равный параметру clientId и, если найдено, вызовите ContextCallback#invokeContextCallback метод на параметре callback, передача тока FacesContext и найденный компонент как параметры. Этот метод подобен findComponent(java.lang.String) но это не поддерживает продвижение UINamingContainer#getSeparatorChar синтаксис для того, чтобы искать от корня Представления.

Реализация по умолчанию сначала проверит если this.getClientId() равно параметру clientId. Если так, сначала вызовите pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent), тогда вызовите ContextCallback#invokeContextCallback метод на обратном вызове параметра, проходя FacesContext параметр и передающий это как компонентный параметр. Затем вызовите popComponentFromEL(javax.faces.context.FacesContext). Если Exception бросается обратным вызовом, оберните его в a FacesException и повторно бросьте это. Иначе, возвратиться true.

Иначе, для каждого компонента, возвращенного getFacetsAndChildren(), вызвать invokeOnComponent() передача параметров этому методу, в порядке. В первый раз invokeOnComponent() возвращает true, прервите пересекающую остальную часть Iterator и возвратитесь true.

Вызывая ContextCallback#invokeContextCallback реализация этого метода должна гарантировать, что состояние компонента, который передают к обратному вызову правильно, отражает позицию компонента в иерархии Представления относительно любого состояния, найденного в параметре clientId. Например, компонент итерации такой как UIData должен будет установить его строку, индексируют, чтобы правильно отразить параметр clientId прежде, чем найти соответствующий дочерний компонент отступало корректной строкой. Когда обратный вызов возвращается, или обычно или бросая Exception реализация этого метода должна восстановить состояние представления к способу, которым это прежде вызывало обратный вызов.

Если ни один из элементов от getFacetsAndChildren() возвращенный true от invokeOnComponent(), возвратиться false.

Простой пример использования, чтобы найти компонент clientId.


private UIComponent found = null;

private void doFind(FacesContext context, String clientId) {
  context.getViewRoot().invokeOnComponent(context, clientId,
      new ContextCallback() {
         public void invokeContextCallback(FacesContext context,
                                       UIComponent component) {
           found = component;
         }
      });
}

Параметры:: context - FacesContext для текущего запроса; clientId - клиентский идентификатор компонента, который передадут к обратному вызову параметра.; callback - реализация интерфейса Обратного вызова.
Возвраты:: true если компонент с данным clientId находится, метод обратного вызова был успешно вызван, передавая тот компонент как параметр, и никакое Исключение не было выдано. Возвраты false если никакой компонент с данным clientId находится.
Броски:: java.lang.NullPointerException - если каким-либо из параметров является нуль; FacesException - если Обратный вызов параметра выдает Исключение, он обертывается в a FacesException и повторно брошенный.
С тех пор:: 1.2

getFacets

public abstract java.util.Map<java.lang.String,UIComponent> getFacets()

Возвратите изменчивое Map представление фасета UIComponents связанный с этим UIComponent, включенный фасетным именем (который должен быть Строкой). Возвращенная реализация должна поддерживать все стандартные и дополнительные Map методы, плюс поддержка следующие дополнительные требования:

Map реализация должна реализовать java.io.Serializable интерфейс.
Любая попытка добавить a null ключ или значение должны бросить NullPointerException.
Любая попытка добавить ключ, который не является Строкой, должна бросить ClassCastException.
Любая попытка добавить значение, которое не является a UIComponent должен бросить ClassCastException.
Всякий раз, когда новый фасет UIComponent добавляется:
- parent свойство компонента должно быть установлено в этот компонентный экземпляр.
- Если parent свойство компонента уже было ненулем, компонент должен сначала быть удален из его предыдущего родителя (где это, возможно, был или дочерний элемент или фасет).
Всякий раз, когда существующий фасет UIComponent удаляется:
- parent свойство фасета должно быть установлено в null.

getFacetCount

public int getFacetCount()

Возвратите число фасета UIComponents, которые связываются с этим UIComponent. Если нет никаких фасетов, этот метод должен возвратиться 0. Метод не должен вызвать создание фасетной компонентной карты.

Для назад compatability с классами, которые расширяют UIComponent непосредственно, реализация по умолчанию - то, при условии, что просто вызывает getFacets() и затем вызовы size() метод на возвращенном Map. В более оптимизированной версии этого метода обеспечивают UIComponentBase#getFacetCount.

С тех пор:: 1.2

getFacet

public abstract UIComponent getFacet(java.lang.String name)

Метод удобства, чтобы возвратить именованный фасет, если это существует, или null иначе. Если требуемый фасет не существует, Карта фасетов не должна быть создана.

Параметры:: name - Имя требуемого фасета

getFacetsAndChildren

public abstract java.util.Iterator<UIComponent> getFacetsAndChildren()

Возвратитесь Iterator по фасету, сопровождаемому дочерним элементом UIComponents этого UIComponent. Фасеты возвращаются в неопределенном порядке, сопровождаемом всеми дочерними элементами в порядке, они сохранены в дочернем списке. Если у этого компонента нет никаких фасетов или дочерних элементов, пустого Iterator возвращается.

Возвращенный Iterator не должен поддерживать remove() работа.

широковещательная передача

public abstract void broadcast(FacesEvent event)
                        throws AbortProcessingException

Широковещательно передайте указанное FacesEvent всем зарегистрированным слушателям события, которые выразили интерес к событиям этого типа. Слушателей вызывают в порядке, в котором они были добавлены.

Если event экземпляр BehaviorEvent и ток component источник event вызвать BehaviorEvent.getBehavior() добраться Behavior для события. Вызвать Behavior.broadcast(javax.faces.event.BehaviorEvent) на Behavior экземпляр.

Параметры:: event - FacesEvent быть широковещательно переданным
Броски:: AbortProcessingException - Сигнализируйте реализацию Поверхностей JavaServer, что никакая дальнейшая обработка на текущем событии не должна быть выполнена; IllegalArgumentException - если реализация class этого FacesEvent не поддерживается этим компонентом; java.lang.NullPointerException - если event null

декодировать

public abstract void decode(FacesContext context)

Декодируйте любое новое состояние этого UIComponent от запроса, содержавшегося в указанном FacesContext, и сохраните это состояние как необходимый.

Во время декодирования события могут ставиться в очередь для дальнейшей обработки (слушателями события, которые зарегистрировали интерес), вызывая queueEvent().

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

visitTree

public boolean visitTree(VisitContext context,
                         VisitCallback callback)

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

UIComponent.visitTree () реализации не вызывают VisitCallback непосредственно, но вместо этого вызовите VisitContext#invokeVisitCallback вызвать обратный вызов. Это позволяет VisitContext реализации, чтобы обеспечить оптимизированные обходы дерева, например только вызывая VisitCallback для подмножества компонентов.

UIComponent.visitTree () реализации должен вызвать UIComponent.pushComponentToEL () прежде, чем выполнить посещение и UIComponent.popComponentFromEL () после посещения.

Параметры:: context - VisitContext для этого посещения; callback - VisitCallback экземпляр, чей visit метод вызовут для каждого узла, который посещают.
Возвраты:: компонентные реализации могут возвратиться true указать, что древовидное посещение полно (eg. все компоненты, которые нужно посетить, были посещены). Это приводит к древовидному посещению, закорачиваемому так, что, больше компонентов не посещают.
С тех пор:: 2.0
См. Также:: VisitContext.invokeVisitCallback()

isVisitable

protected boolean isVisitable(VisitContext context)

Возвратиться true если этот компонент нужно посетить, false иначе. Вызванный UIComponent.visitTree() определить, удовлетворяет ли этот компонент подсказки, возвращенные VisitContext.getHints().

Если этот метод возвращает false, дерево, которое посещают, не закорачивается так, что ни компонент, ни любого из его потомков посетят>

Пользовательский visitTree() реализации могут вызвать этот метод, чтобы определить, является ли компонент visitable прежде, чем выполнить какую-либо связанную с посещением обработку.

С тех пор:: 2.0

encodeBegin

public abstract void encodeBegin(FacesContext context)
                          throws java.io.IOException

Если наш rendered свойство true, представьте начало текущего состояния этого UIComponent к ответу, содержавшемуся в указанном FacesContext. Вызвать pushComponentToEL(javax.faces.context.FacesContext,javax.faces.component.UIComponent). Вызвать Application.publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object), передача PreRenderComponentEvent.class как первый параметр и компонентный экземпляр, который будет представлен как второй параметр.

Если a Renderer связывается с этим UIComponent, фактическое кодирование будет делегировано к Renderer#encodeBegin(FacesContext, UIComponent).

Если наш rendered свойство false, вызвать pushComponentToEL(javax.faces.context.FacesContext,javax.faces.component.UIComponent) и возвратитесь сразу.

Параметры:: context - FacesContext для ответа мы создаем
Броски:: java.io.IOException - если ввод/ошибка на выходе происходит, представляя; java.lang.NullPointerException - если context null

encodeChildren

public abstract void encodeChildren(FacesContext context)
                             throws java.io.IOException

Если наш rendered свойство true, представьте дочерний элемент UIComponents этого UIComponent. Этот метод только вызовут если rendersChildren свойство true.

Если a Renderer связывается с этим UIComponent, фактическое кодирование будет делегировано к Renderer#encodeChildren(FacesContext, UIComponent). Если нет Renderer связывается с этим UIComponent, выполните итерации по каждому из дочерних элементов этого компонента и вызова encodeAll(javax.faces.context.FacesContext).

Параметры:: context - FacesContext для ответа мы создаем
Броски:: java.io.IOException - если ввод/ошибка на выходе происходит, представляя; java.lang.NullPointerException - если context null

encodeEnd

public abstract void encodeEnd(FacesContext context)
                        throws java.io.IOException

Если наш rendered свойство true, представьте окончание текущего состояния этого UIComponent.

Если a Renderer связывается с этим UIComponent, фактическое кодирование будет делегировано к Renderer#encodeEnd(FacesContext, UIComponent).

Вызвать UIComponent#popComponentFromEL. прежде, чем возвратиться независимо от значения rendered свойство.

Параметры:: context - FacesContext для ответа мы создаем
Броски:: java.io.IOException - если ввод/ошибка на выходе происходит, представляя; java.lang.NullPointerException - если context null

encodeAll

public void encodeAll(FacesContext context)
               throws java.io.IOException

Если этот компонент возвращается true от isRendered(), предпримите следующие меры.

Представьте этот компонент и все его дочерние элементы тот возврат true от isRendered(), независимо от значения getRendersChildren() флаг.

Броски:: java.io.IOException - если ввод/ошибка на выходе происходит, представляя; java.lang.NullPointerException - если context null
С тех пор:: 1.2

pushComponentToEL

public final void pushComponentToEL(FacesContext context,
                                    UIComponent component)

Продвиньте ток UIComponent this к FacesContext припишите карту, используя ключ CURRENT_COMPONENT сохранение предыдущего UIComponent связанный с CURRENT_COMPONENT для последующего звонка popComponentFromEL(javax.faces.context.FacesContext).

Этот метод и popComponentFromEL() сформируйте основание для контракта, который включает ЭЛЬ Выражению"#{component}"чтобы решить к "текущему" компоненту, который обрабатывается в жизненном цикле. Требования, для когда pushComponentToEL() и popComponentFromEL() должен быть вызван определяются как необходимый в javadoc для этого class.

После pushComponentToEL() возвраты, звонок getCurrentComponent(javax.faces.context.FacesContext) должен возвратиться this UIComponent экземпляр до popComponentFromEL() вызывается, после который точка предыдущее UIComponent экземпляр будет возвращен из getCurrentComponent()

Параметры:: context - FacesContext для текущего запроса; component - component продвигать к ЭЛЬ. Если component null UIComponent экземпляр, на который был вызван этот вызов, будет продвинут к ЭЛЬ.
Броски:: java.lang.NullPointerException - если context null
С тех пор:: 2.0
См. Также:: FacesContext.getAttributes()

popComponentFromEL

public final void popComponentFromEL(FacesContext context)

Вытолкайте ток UIComponent от FacesContext атрибуты отображаются так, чтобы предыдущее UIComponent, если таковые вообще имеются, становится текущим компонентом.

Параметры:: context - FacesContext для текущего запроса
Броски:: java.lang.NullPointerException - если context null
С тех пор:: 2.0
См. Также:: FacesContext.getAttributes()

isCompositeComponent

public static boolean isCompositeComponent(UIComponent component)

Возвратиться true если component составной компонент, иначе false.

Параметры:: component - UIComponent протестировать
Броски:: java.lang.NullPointerException - если component null
С тех пор:: 2.0

getCompositeComponentParent

public static UIComponent getCompositeComponentParent(UIComponent component)

Находит самого близкого составного компонентного родителя указанного компонента.

Параметры:: component - компонент, от которого можно запустить поиск с
Возвраты:: если component null, возвратиться null, иначе ищите родителя компонента hierachy самый близкий родительский составной компонент. Если никакой родительский составной компонент не находится, возвратиться null
С тех пор:: 2.0

getCurrentComponent

public static UIComponent getCurrentComponent(FacesContext context)

Возвратитесь UIComponent экземпляр, который в настоящий момент обрабатывает. Это эквивалентно оценке ЭЛЬ выражения"#{component}"и выполнение a getValue работа на результанте ValueExpression.

Этот метод должен возвратиться null если есть не в настоящий момент обработка UIComponent

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

getCurrentCompositeComponent

public static UIComponent getCurrentCompositeComponent(FacesContext context)

Возвратите самый близкий компонент предка относительно компонента, возвращенного из getCurrentComponent(javax.faces.context.FacesContext), это - составной компонент, или null если никакой такой компонент не существует.

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

addFacesListener

protected abstract void addFacesListener(FacesListener listener)

Добавьте указанное FacesListener к группе слушателей, зарегистрированных, чтобы получить уведомления о событии от этого UIComponent. Это ожидается это UIComponent у классов, действующих как источники событий, будут соответствующие безопасные с точки зрения типов API для того, чтобы зарегистрировать слушателей необходимого типа, и реализация тех регистрационных методов делегирует к этому методу. Например:

 public class FooEvent extends FacesEvent { ... }

 public interface FooListener extends FacesListener {
   public void processFoo(FooEvent event);
 }

 public class FooComponent extends UIComponentBase {
   ...
   public void addFooListener(FooListener listener) {
     addFacesListener(listener);
   }
   public void removeFooListener(FooListener listener) {
     removeFacesListener(listener);
   }
   ...
 }

Параметры:: listener - FacesListener быть зарегистрированным
Броски:: java.lang.NullPointerException - если listener null

getFacesListeners

protected abstract FacesListener[] getFacesListeners(java.lang.Class clazz)

Возвратите массив зарегистрированных FacesListeners, которые являются экземплярами указанного class. Если нет таких зарегистрированных слушателей, массив нулевой длиной возвращается. Возвращенный массив может быть безопасно быть брошенным массиву, со строгим контролем типов к типу элемента clazz.

Параметры:: clazz - Класс, который должен быть реализован a FacesListener для этого, чтобы быть возвращенным
Броски:: IllegalArgumentException - если class не, и не реализует, FacesListener; java.lang.NullPointerException - если clazz null

removeFacesListener

protected abstract void removeFacesListener(FacesListener listener)

Удалите указанное FacesListener от группы слушателей, зарегистрированных, чтобы получить уведомления о событии от этого UIComponent.

Параметры:: listener - FacesListener быть вычеркнутым из списка
Броски:: java.lang.NullPointerException - если listener null

queueEvent

public abstract void queueEvent(FacesEvent event)

Поставьте событие в очередь для широковещательной передачи в конце текущей фазы жизненного цикла обработки запросов. Реализация по умолчанию в UIComponentBase должен делегировать этот звонок queueEvent() метод родителя UIComponent.

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

subscribeToEvent

public void subscribeToEvent(java.lang.Class<? extends SystemEvent> eventClass,
                             ComponentSystemEventListener componentListener)

Эта реализация броски UnsupportedOperationException и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class. UIComponentBase обеспечивает реализацию этого метода.

С тех пор:: 2.1

unsubscribeFromEvent

public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> eventClass,
                                 ComponentSystemEventListener componentListener)

С тех пор:: 2.1

getListenersForEventClass

public java.util.List<SystemEventListener> getListenersForEventClass(java.lang.Class<? extends SystemEvent> eventClass)

Определенный:: getListenersForEventClass в интерфейсе SystemEventListenerHolder

С тех пор:: 2.1

getNamingContainer

public UIComponent getNamingContainer()

Запускаясь с "этого", возвратите самый близкий компонент в родословной, которая является a NamingContainer или null если ни один не может быть найден.

С тех пор:: 2.0

processRestoreState

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

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

Вызовите restoreState() метод этого компонента.
Вызвать UIComponent#pushComponentToEL.
Вызовите processRestoreState() метод всех фасетов и дочерние элементы этого UIComponent в порядке, определенном звонком getFacetsAndChildren(). После возврата из processRestoreState() метод на дочернем элементе или фасете, вызвать UIComponent#popComponentFromEL

Этот метод нельзя вызвать, если метод сохранения состояния устанавливается в сервер.

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

processDecodes

public abstract void processDecodes(FacesContext context)

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

Если rendered свойство этого UIComponent false, пропуск, далее обрабатывающий.
Вызвать pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent).
Вызовите processDecodes() метод всех фасетов и дочерние элементы этого UIComponent, в порядке, определенном звонком getFacetsAndChildren().
Вызовите decode() метод этого компонента.
Вызвать popComponentFromEL(javax.faces.context.FacesContext) изнутри a finally block, just before returning.
Если a RuntimeException бросается во время обработки декодирования, вызвать FacesContext#renderResponse и повторно бросьте исключение.

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

processEvent

public void processEvent(ComponentSystemEvent event)
                  throws AbortProcessingException

Реализация по умолчанию выполняет следующее действие. Если параметр event экземпляр PostRestoreStateEvent, вызвать this.getValueExpression(java.lang.String) передача литеральной строки "привязка", без кавычек, как параметр. Если результат не -null, установите значение ValueExpression быть this.

Определенный:: processEvent в интерфейсе ComponentSystemEventListener

Параметры:: event - ComponentSystemEvent экземпляр, который обрабатывается.
Броски:: AbortProcessingException - если обработка жизненного цикла должна прекратиться для этого запроса.

processValidators

public abstract void processValidators(FacesContext context)

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

Если rendered свойство этого UIComponent false, пропуск, далее обрабатывающий.
Вызвать pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent).
Вызовите processValidators() метод всех фасетов и дочерние элементы этого UIComponent, в порядке, определенном звонком getFacetsAndChildren().
После возврата из вызова getFacetsAndChildren() вызвать UIComponent#popComponentFromEL.

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

processUpdates

public abstract void processUpdates(FacesContext context)

Выполните компонентное дерево обработка необходимого фазой Значений Модели Обновления жизненного цикла обработки запросов для всех фасетов этого компонента, всех дочерних элементов этого компонента, и этого компонента непосредственно, следующим образом.

Если rendered свойство этого UIComponent false, пропуск, далее обрабатывающий.
Вызвать pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent).
Вызовите processUpdates() метод всех фасетов и дочерние элементы этого UIComponent, в порядке, определенном звонком getFacetsAndChildren(). После возврата из processUpdates() метод на дочернем элементе или фасете, вызвать UIComponent#popComponentFromEL

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

processSaveState

public abstract java.lang.Object processSaveState(FacesContext context)

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

консультируйтесь transient свойство этого компонента. Если это правда, только возвратитесь null.
Вызвать pushComponentToEL(javax.faces.context.FacesContext, javax.faces.component.UIComponent).
Вызовите processSaveState() метод всех фасетов и дочерние элементы этого UIComponent в порядке, определенном звонком getFacetsAndChildren(), пропуск дочерних элементов и фасетов, которые являются переходным процессом. Гарантируйте это popComponentFromEL(javax.faces.context.FacesContext) вызывается правильно после каждого дочернего элемента или фасета.
Вызовите saveState() метод этого компонента.
Инкапсулируйте дочернее состояние и Ваше состояние в Сериализуемый Объект и возвратите это.

Этот метод нельзя вызвать, если метод сохранения состояния устанавливается в сервер.

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

getFacesContext

protected abstract FacesContext getFacesContext()

Метод удобства, чтобы возвратиться FacesContext экземпляр для текущего запроса.

getRenderer

protected abstract Renderer getRenderer(FacesContext context)

Метод удобства, чтобы возвратиться Renderer экземпляр, связанный с этим компонентом, если любой; иначе, возвратиться null.

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

Краткий обзор

Пакет

Класс

Дерево

Устаревшие

Индексировать

Справка

ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС

ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ

СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД

ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД

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

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

javax.faces.component Класс UIComponent

HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME

CURRENT_COMPONENT

CURRENT_COMPOSITE_COMPONENT

BEANINFO_KEY

FACETS_KEY

VIEW_LOCATION_KEY

COMPOSITE_COMPONENT_TYPE_KEY

COMPOSITE_FACET_NAME

ATTRS_WITH_DECLARED_DEFAULT_VALUES

привязка

UIComponent

getAttributes

getValueBinding

setValueBinding

getValueExpression

setValueExpression

markInitialState

initialStateMarked

clearInitialState

getStateHelper

getStateHelper

getTransientStateHelper

getTransientStateHelper

restoreTransientState

saveTransientState

isInView

setInView

getClientId

getClientId

getContainerClientId

getFamily

getId

setId

getParent

setParent

isRendered

setRendered

getRendererType

setRendererType

getRendersChildren

getResourceBundleMap

getChildren

getChildCount

findComponent

invokeOnComponent

getFacets

getFacetCount

getFacet

getFacetsAndChildren

широковещательная передача

декодировать

visitTree

isVisitable

encodeBegin

encodeChildren

encodeEnd

encodeAll

pushComponentToEL

popComponentFromEL

isCompositeComponent

getCompositeComponentParent

getCurrentComponent

getCurrentCompositeComponent

addFacesListener

getFacesListeners

removeFacesListener

queueEvent

subscribeToEvent

unsubscribeFromEvent

getListenersForEventClass

getNamingContainer

processRestoreState

processDecodes

processEvent

processValidators

processUpdates

processSaveState

getFacesContext

getRenderer

javax.faces.component
Класс UIComponent