Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.faces.component.UIComponent
public abstract class UIComponent
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 |
protected java.util.Map<java.lang.String,ValueExpression> |
привязка
Осуждаемый. |
static java.lang.String |
COMPOSITE_COMPONENT_TYPE_KEY
Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для a |
static java.lang.String |
COMPOSITE_FACET_NAME
Значение этой константы используется в качестве ключа |
static java.lang.String |
CURRENT_COMPONENT
Ключ тот, к который |
static java.lang.String |
CURRENT_COMPOSITE_COMPONENT
Ключ тот, к который составной объект |
static java.lang.String |
FACETS_KEY
Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для |
static java.lang.String |
HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME
|
static java.lang.String |
VIEW_LOCATION_KEY
Значение этой константы используется в качестве ключа в компонентных атрибутах |
Сводка конструктора | |
---|---|
UIComponent()
|
Сводка метода | |
---|---|
protected abstract void |
addFacesListener(FacesListener listener)
Добавьте указанное FacesListener к группе слушателей, зарегистрированных, чтобы получить уведомления о событии от этого UIComponent . |
abstract void |
broadcast(FacesEvent event)
Широковещательно передайте указанное FacesEvent всем зарегистрированным слушателям события, которые выразили интерес к событиям этого типа. |
void |
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()
Включите ЭЛЬ к доступу |
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)
Возвратитесь |
static UIComponent |
getCurrentCompositeComponent(FacesContext context)
Возвратите самый близкий компонент предка относительно компонента, возвращенного из |
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)
Эта реализация броски |
UIComponent |
getNamingContainer()
Запускаясь с "этого", возвратите самый близкий компонент в родословной, которая является a |
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 |
protected StateHelper |
getStateHelper()
Возвратитесь |
protected StateHelper |
getStateHelper(boolean create)
Как |
TransientStateHelper |
getTransientStateHelper()
Возвратитесь |
TransientStateHelper |
getTransientStateHelper(boolean create)
Возвратитесь |
abstract ValueBinding |
getValueBinding(java.lang.String name)
Осуждаемый. Это было заменено getValueExpression(java.lang.String) . |
ValueExpression |
getValueExpression(java.lang.String name)
Возвратитесь ValueExpression используемый, чтобы вычислить значение для указанного атрибута или имени свойства, если любой. |
boolean |
initialStateMarked()
Реализация |
boolean |
invokeOnComponent(FacesContext context, java.lang.String clientId, ContextCallback callback)
Запускаясь в этом компоненте в иерархии Представления, ищите компонент с a clientId равный параметру clientId и, если найдено, вызовите ContextCallback#invokeContextCallback метод на параметре callback , передача тока FacesContext и найденный компонент как параметры. |
static boolean |
isCompositeComponent(UIComponent component)
Возвратиться |
boolean |
isInView()
Возвратиться |
abstract boolean |
isRendered()
Возвратиться true если этот компонент (и его дочерние элементы) должен быть представлен во время Представлять фазы Ответа жизненного цикла обработки запросов. |
protected boolean |
isVisitable(VisitContext context)
Возвратиться |
void |
markInitialState()
Реализация |
void |
popComponentFromEL(FacesContext context)
Вытолкайте ток |
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)
Продвиньте ток |
abstract void |
queueEvent(FacesEvent event)
Поставьте событие в очередь для широковещательной передачи в конце текущей фазы жизненного цикла обработки запросов. |
protected abstract void |
removeFacesListener(FacesListener listener)
Удалите указанное FacesListener от группы слушателей, зарегистрированных, чтобы получить уведомления о событии от этого UIComponent . |
void |
restoreTransientState(FacesContext context, java.lang.Object state)
Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод восстановит любое состояние, на котором экономят предшествующий звонок |
java.lang.Object |
saveTransientState(FacesContext context)
Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод сохранит любое состояние, которое, как известно, является переходным процессом в природе. |
abstract void |
setId(java.lang.String id)
Установите компонентный идентификатор этого UIComponent (если любой). |
void |
setInView(boolean isInView)
Обновляет состояние относительно того, является ли этот компонент в настоящий момент в пределах иерархии представления. |
abstract void |
setParent(UIComponent parent)
Установите родителя |
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)
Эта реализация броски |
void |
unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)
Эта реализация броски |
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 |
Полевая Деталь |
---|
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
метод не соблюдают. Если эти параметры устанавливаются к истине, контракт соблюдают.
public static final java.lang.String CURRENT_COMPONENT
Ключ тот, к который UIComponent
в настоящий момент быть обработанным будет связано с в пределах FacesContext
карта атрибутов.
FacesContext.getAttributes()
, Постоянные Значения полейpublic static final java.lang.String CURRENT_COMPOSITE_COMPONENT
Ключ тот, к который составной объект UIComponent
в настоящий момент быть обработанным будет связано с в пределах FacesContext
карта атрибутов.
FacesContext.getAttributes()
, Постоянные Значения полейpublic static final java.lang.String BEANINFO_KEY
Значение этой константы используется в качестве ключа в компонентной карте атрибута, значении, для которого a java.beans.BeanInfo
реализация, описывающая составной компонент. Это BeanInfo
известен как составной компонент BeanInfo.
public static final java.lang.String FACETS_KEY
Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для Map<PropertyDescriptor>
это содержит метаинформацию для объявленных фасетов для этого составного компонента. Эта карта должна содержать запись под ключом COMPOSITE_FACET_NAME
, даже если никакие фасеты не были явно объявлены. См. COMPOSITE_FACET_NAME
.
public static final java.lang.String VIEW_LOCATION_KEY
Значение этой константы используется в качестве ключа в компонентных атрибутах Map
для Location
в представлении, при котором находится этот компонентный экземпляр.
public static final java.lang.String COMPOSITE_COMPONENT_TYPE_KEY
Значение этой константы используется в качестве ключа в составном компоненте BeanDescriptor для a ValueExpression
это оценивает к component-type
из составного компонентного корня
UIComponent
для этого составного компонента, если Вы были объявлены составным компонентным автором.
public static final java.lang.String COMPOSITE_FACET_NAME
Значение этой константы используется в качестве ключа Map
возвращенный как описано в FACETS_KEY
для PropertyDescriptor
описание составного компонентного фасета. Значение этой константы также используется в качестве ключа Map
возвращенный из getFacets()
. В этом случае это обращается к фактическому фасету, который является UIPanel
это - родитель всех компонентов в <composite:implementation>
раздел составного компонента файл VDL.
public static final java.lang.String ATTRS_WITH_DECLARED_DEFAULT_VALUES
Эта константа позволяет тому быстро обнаружить имена объявленных составных компонентных атрибутов, которым дал значения по умолчанию составной компонентный автор. Информация представляется как a Collection<String>
возвращенный из getValue()
метод на составном компоненте BeanDescriptor, когда эту константу передают как параметр.
@Deprecated protected java.util.Map<java.lang.String,ValueExpression> bindings
Деталь конструктора |
---|
public UIComponent()
Деталь метода |
---|
public abstract java.util.Map<java.lang.String,java.lang.Object> getAttributes()
Возвратите изменчивое Map
представляя атрибуты (и свойства, см. ниже), связал wth это UIComponent
, включенный названием атрибута (который должен быть Строкой). Возвращенная реализация должна поддерживать все стандартные и дополнительные Map
методы, плюс поддержка следующие дополнительные требования:
Map
реализация должна реализовать java.io.Serializable
интерфейс.null
ключ или значение должны бросить a NullPointerException
.ClassCastException
.UIComponent
's реализация class, у следующих методов будет специальное поведение: containsKey
- Возвратиться false
.get()
- Если свойство читаемо, вызовите метод метода get и возвратите возвращенное значение (обертывающий примитивные значения в их соответствующие классы обертки); иначе бросок IllegalArgumentException
.put()
- Если свойство является writeable, вызовите метод метода set, чтобы установить соответствующее значение (разворачивающий примитивные значения в их соответствующих классах обертки). Если свойство не является writeable, или попытка предпринимается, чтобы установить свойство типа примитива к null
, бросок IllegalArgumentException
.remove
- Бросок IllegalArgumentException
.
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
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
public ValueExpression getValueExpression(java.lang.String name)
Возвратитесь ValueExpression
используемый, чтобы вычислить значение для указанного атрибута или имени свойства, если любой.
Этот метод должен быть переопределен и реализован для компонентов, которые выполняют JSF 1.2 и позже.
name
- Имя атрибута или свойства, для которого можно получить a ValueExpression
java.lang.NullPointerException
- если name
null
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
параметр в наборе ValueExpression
s под ключом, данным параметром name
.
Этот метод должен быть переопределен и реализован для компонентов, которые выполняют JSF 1.2 и позже.
name
- Имя атрибута или свойства, для которого можно установить a ValueExpression
binding
- ValueExpression
установить, или null
удалить любого в настоящий момент набор ValueExpression
IllegalArgumentException
- если name
один из id
или parent
java.lang.NullPointerException
- если name
null
public void markInitialState()
Реализация PartialStateHolder#markInitialState
, этот метод вызывает время выполнения, чтобы указать, что экземпляр должен начать отслеживать изменения к своему состоянию.
markInitialState
в интерфейсе PartialStateHolder
public boolean initialStateMarked()
Реализация PartialStateHolder#initialStateMarked
, этот метод вызывает время выполнения, чтобы протестировать если PartialStateHolder#markInitialState
метод вызвали.
initialStateMarked
в интерфейсе PartialStateHolder
public void clearInitialState()
Реализация PartialStateHolder#clearInitialState
, этот метод вызывает время выполнения, чтобы сказать экземпляру прекращать отслеживать изменения состояния.
clearInitialState
в интерфейсе PartialStateHolder
protected StateHelper getStateHelper()
Возвратитесь StateHelper
экземпляр, используемый, чтобы помочь этой компонентной реализации PartialStateHolder
.
protected StateHelper getStateHelper(boolean create)
Как getStateHelper()
, но только создайте экземпляр помощника состояния если параметр creat
true
.
create
- если true
, новое StateHelper
экземпляр будет создаваться, если он уже не будет существовать. Если false
, и там является не существующим StateHelper
экземпляр, каждый не будет создаваться и null
будет возвращен.public final TransientStateHelper getTransientStateHelper()
Возвратитесь TransientStateHelper
экземпляр для этого UIComponent
экземпляр. Реализация по умолчанию просто вызывает через к getTransientStateHelper(boolean)
передача true
как параметр.
public TransientStateHelper getTransientStateHelper(boolean create)
Возвратитесь TransientStateHelper
экземпляр для этого UIComponent
экземпляр.
create
- если true
создайте, в случае необходимости, любые внутренние структуры данных. Если false
, не создавайте экземпляры. В этом случае для этого метода возможно возвратиться null
.public void restoreTransientState(FacesContext context, java.lang.Object state)
Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод восстановит любое состояние, на котором экономят предшествующий звонок saveTransientState(javax.faces.context.FacesContext)
.
restoreTransientState
в интерфейсе TransientStateHolder
state
- объект, содержащий переходные значенияpublic java.lang.Object saveTransientState(FacesContext context)
Для компонентов, которые должны поддерживать понятие переходного состояния, этот метод сохранит любое состояние, которое, как известно, является переходным процессом в природе.
saveTransientState
в интерфейсе TransientStateHolder
public boolean isInView()
Возвратиться true
если этот компонент в пределах иерархии представления иначе false
public void setInView(boolean isInView)
Обновляет состояние относительно того, является ли этот компонент в настоящий момент в пределах иерархии представления. Этот метод никогда не должны вызывать разработчики; a UIComponent
's внутренняя реализация вызовет это, поскольку компоненты добавляются к или удаляются от дочернего элемента родителя List
или фасет Map
.
isInView
- флаг, указывающий, является ли этот компонент в пределах представления hierachypublic java.lang.String getClientId()
Включите ЭЛЬ к доступу clientId
из компонента. Это особенно полезно в комбинации с component
и cc
неявные объекты. Реализация по умолчанию - то, при условии, что просто вызывает FacesContext#getCurrentInstance
и затем вызовы через к getClientId(FacesContext)
.
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
+ myIdRenderer#convertClientId
, передача myId
, и возвратите результат.
context
- FacesContext
для текущего запроса java.lang.NullPointerException
- если context
null
public java.lang.String getContainerClientId(FacesContext context)
Позвольте компонентам ту реализацию NamingContainer
выборочно отключить предварительное ожидание их clientId к clientIds их потомка, повреждая логику предна ожидании в seperately вызываемый метод. См. getClientId()
для использования.
По умолчанию этот метод вызовет через к getClientId()
и возвратите результат.
java.lang.NullPointerException
- если context
null
public abstract java.lang.String getFamily()
Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. Этот идентификатор, в соединении со значением rendererType
свойство, может использоваться, чтобы выбрать соответствующее Renderer
для этого компонентного экземпляра.
public abstract java.lang.String getId()
Возвратите компонентный идентификатор этого UIComponent
.
public abstract void setId(java.lang.String id)
Установите компонентный идентификатор этого UIComponent
(если любой). Компонентные идентификаторы должны повиноваться следующим ограничениям синтаксиса:
Компонентные идентификаторы должны также повиноваться, следующие семантические ограничения (отметьте, что это ограничение НЕ осуществляется setId()
реализация):
UIComponent
это - a NamingContainer
, или в рамках всего компонентного дерева, если нет такого предка, который является a NamingContainer
.
id
- Новый компонентный идентификатор, или null
указать что это UIComponent
не имеет компонентного идентификатора IllegalArgumentException
- если id
не синтаксически допустимоpublic abstract UIComponent getParent()
Возвратите родителя UIComponent
из этого UIComponent
, если любой. Компонент должен позволить дочерним компонентам быть добавленными к и удаленными из списка дочерних элементов этого компонента, даже при том, что дочерний компонент возвращает нуль из getParent( )
.
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
для корневого узла компонентного дереваpublic abstract boolean isRendered()
Возвратиться true
если этот компонент (и его дочерние элементы) должен быть представлен во время Представлять фазы Ответа жизненного цикла обработки запросов.
public abstract void setRendered(boolean rendered)
Установите rendered
свойство этого UIComponent
.
rendered
- Если true
представьте этот компонент; иначе, не представляйте этот компонентpublic abstract java.lang.String getRendererType()
Возвратитесь Renderer
введите для этого UIComponent
(если любой).
public abstract void setRendererType(java.lang.String rendererType)
Установите Renderer
введите для этого UIComponent
, или null
для компонентов, которые представляют себя.
rendererType
- Логический идентификатор типа Renderer
использовать, или null
для компонентов, которые представляют себяpublic abstract boolean getRendersChildren()
Возвратите флаг, указывающий, ответственен ли этот компонент за рендеринг его дочерних компонентов. Реализация по умолчанию в UIComponentBase#getRendersChildren
попытки найти средство рендеринга для этого компонента. Если это делает, это вызывает Renderer#getRendersChildren
и возвращает результат. Если это не делает, это возвращает false. С версии 1.2 Спецификации Поверхностей JavaServer компонентные авторы поощряются возвратиться true
от этого метода и полагаются UIComponentBase#encodeChildren
.
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
возвращается.
public abstract java.util.List<UIComponent> getChildren()
Возвратите изменчивое List
представление дочернего элемента UIComponent
s связанный с этим компонентом. Возвращенная реализация должна поддерживать все стандартные и дополнительные List
методы, плюс поддержка следующие дополнительные требования:
List
реализация должна реализовать java.io.Serializable
интерфейс.null
должен бросить NullPointerExceptionUIComponent
должен бросить 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
public abstract int getChildCount()
Возвратите число дочернего элемента UIComponent
s, которые связываются с этим UIComponent
. Если нет никаких дочерних элементов, этот метод должен возвратиться 0. Метод не должен вызвать создание дочернего компонентного списка.
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
это будет служить основанием.NamingContainer
встречается, это будет основа. NamingContainer
встречается), корень UIComponent
будет основа.id
это соответствует, в рамках основного компонента. Соответствие выполняется следующим образом: id
свойство, и затем рекурсивно через фасеты и дочерние элементы основы UIComponent
(за исключением того, что, если потомок NamingContainer
находится, его собственные фасеты и дочерние элементы не ищутся).NamingContainer
по правилам в предыдущем пункте маркированного списка. Затем, findComponent()
метод этого NamingContainer
будет вызван, передавая остаток от выражения поиска.
expr
- Выражение поиска, идентифицирующее UIComponent
быть возвращенным UIComponent
, или null
если компонент не был найден. IllegalArgumentException
- если промежуточный идентификатор в выражении поиска идентифицирует a UIComponent
это не a NamingContainer
java.lang.NullPointerException
- если expr
null
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
и повторно брошенный.public abstract java.util.Map<java.lang.String,UIComponent> getFacets()
Возвратите изменчивое Map
представление фасета UIComponent
s связанный с этим UIComponent
, включенный фасетным именем (который должен быть Строкой). Возвращенная реализация должна поддерживать все стандартные и дополнительные Map
методы, плюс поддержка следующие дополнительные требования:
Map
реализация должна реализовать java.io.Serializable
интерфейс.null
ключ или значение должны бросить NullPointerException.UIComponent
должен бросить ClassCastException.UIComponent
добавляется: parent
свойство компонента должно быть установлено в этот компонентный экземпляр.parent
свойство компонента уже было ненулем, компонент должен сначала быть удален из его предыдущего родителя (где это, возможно, был или дочерний элемент или фасет).UIComponent
удаляется: parent
свойство фасета должно быть установлено в null
.
public int getFacetCount()
Возвратите число фасета UIComponent
s, которые связываются с этим UIComponent
. Если нет никаких фасетов, этот метод должен возвратиться 0. Метод не должен вызвать создание фасетной компонентной карты.
Для назад compatability с классами, которые расширяют UIComponent непосредственно, реализация по умолчанию - то, при условии, что просто вызывает getFacets()
и затем вызовы size()
метод на возвращенном Map
. В более оптимизированной версии этого метода обеспечивают UIComponentBase#getFacetCount
.
public abstract UIComponent getFacet(java.lang.String name)
Метод удобства, чтобы возвратить именованный фасет, если это существует, или null
иначе. Если требуемый фасет не существует, Карта фасетов не должна быть создана.
name
- Имя требуемого фасетаpublic abstract java.util.Iterator<UIComponent> getFacetsAndChildren()
Возвратитесь Iterator
по фасету, сопровождаемому дочерним элементом UIComponent
s этого 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
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. все компоненты, которые нужно посетить, были посещены). Это приводит к древовидному посещению, закорачиваемому так, что, больше компонентов не посещают. VisitContext.invokeVisitCallback()
protected boolean isVisitable(VisitContext context)
Возвратиться true
если этот компонент нужно посетить, false
иначе. Вызванный UIComponent.visitTree()
определить, удовлетворяет ли этот компонент подсказки, возвращенные VisitContext.getHints()
.
Если этот метод возвращает false, дерево, которое посещают, не закорачивается так, что ни компонент, ни любого из его потомков посетят>
Пользовательский visitTree()
реализации могут вызвать этот метод, чтобы определить, является ли компонент visitable прежде, чем выполнить какую-либо связанную с посещением обработку.
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
public abstract void encodeChildren(FacesContext context) throws java.io.IOException
Если наш rendered
свойство true
, представьте дочерний элемент UIComponent
s этого 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
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
public void encodeAll(FacesContext context) throws java.io.IOException
Если этот компонент возвращается true
от isRendered()
, предпримите следующие меры.
Представьте этот компонент и все его дочерние элементы тот возврат true
от isRendered()
, независимо от значения getRendersChildren()
флаг.
java.io.IOException
- если ввод/ошибка на выходе происходит, представляя java.lang.NullPointerException
- если context
null
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
FacesContext.getAttributes()
public final void popComponentFromEL(FacesContext context)
Вытолкайте ток UIComponent
от FacesContext
атрибуты отображаются так, чтобы предыдущее UIComponent
, если таковые вообще имеются, становится текущим компонентом.
context
- FacesContext
для текущего запроса java.lang.NullPointerException
- если context
null
FacesContext.getAttributes()
public static boolean isCompositeComponent(UIComponent component)
Возвратиться true
если component
составной компонент, иначе false
.
component
- UIComponent
протестировать java.lang.NullPointerException
- если component
null
public static UIComponent getCompositeComponentParent(UIComponent component)
Находит самого близкого составного компонентного родителя указанного компонента.
component
- компонент, от которого можно запустить поиск с component
null
, возвратиться null
, иначе ищите родителя компонента hierachy самый близкий родительский составной компонент. Если никакой родительский составной компонент не находится, возвратиться null
public static UIComponent getCurrentComponent(FacesContext context)
Возвратитесь UIComponent
экземпляр, который в настоящий момент обрабатывает. Это эквивалентно оценке ЭЛЬ выражения"#{component}
"и выполнение a getValue
работа на результанте ValueExpression
.
Этот метод должен возвратиться null
если есть не в настоящий момент обработка UIComponent
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public static UIComponent getCurrentCompositeComponent(FacesContext context)
Возвратите самый близкий компонент предка относительно компонента, возвращенного из getCurrentComponent(javax.faces.context.FacesContext)
, это - составной компонент, или null
если никакой такой компонент не существует.
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
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
protected abstract FacesListener[] getFacesListeners(java.lang.Class clazz)
Возвратите массив зарегистрированных FacesListener
s, которые являются экземплярами указанного class. Если нет таких зарегистрированных слушателей, массив нулевой длиной возвращается. Возвращенный массив может быть безопасно быть брошенным массиву, со строгим контролем типов к типу элемента clazz
.
clazz
- Класс, который должен быть реализован a FacesListener
для этого, чтобы быть возвращенным IllegalArgumentException
- если class
не, и не реализует, FacesListener
java.lang.NullPointerException
- если clazz
null
protected abstract void removeFacesListener(FacesListener listener)
Удалите указанное FacesListener
от группы слушателей, зарегистрированных, чтобы получить уведомления о событии от этого UIComponent
.
listener
- FacesListener
быть вычеркнутым из списка java.lang.NullPointerException
- если listener
null
public abstract void queueEvent(FacesEvent event)
Поставьте событие в очередь для широковещательной передачи в конце текущей фазы жизненного цикла обработки запросов. Реализация по умолчанию в UIComponentBase
должен делегировать этот звонок queueEvent()
метод родителя UIComponent
.
event
- FacesEvent
быть поставленным в очередь IllegalStateException
- если этот компонент не является потомком a UIViewRoot
java.lang.NullPointerException
- если event
null
public void subscribeToEvent(java.lang.Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)
Эта реализация броски UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class. UIComponentBase
обеспечивает реализацию этого метода.
public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> eventClass, ComponentSystemEventListener componentListener)
Эта реализация броски UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class. UIComponentBase
обеспечивает реализацию этого метода.
public java.util.List<SystemEventListener> getListenersForEventClass(java.lang.Class<? extends SystemEvent> eventClass)
Эта реализация броски UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class. UIComponentBase
обеспечивает реализацию этого метода.
getListenersForEventClass
в интерфейсе SystemEventListenerHolder
public UIComponent getNamingContainer()
Запускаясь с "этого", возвратите самый близкий компонент в родословной, которая является a NamingContainer
или null
если ни один не может быть найден.
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
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.
RuntimeException
бросается во время обработки декодирования, вызвать FacesContext#renderResponse
и повторно бросьте исключение.
context
- FacesContext
для запроса мы обрабатываем java.lang.NullPointerException
- если context
null
public void processEvent(ComponentSystemEvent event) throws AbortProcessingException
Реализация по умолчанию выполняет следующее действие. Если параметр event
экземпляр PostRestoreStateEvent
, вызвать this.
getValueExpression(java.lang.String)
передача литеральной строки "привязка", без кавычек, как параметр. Если результат не -null
, установите значение ValueExpression
быть this
.
processEvent
в интерфейсе ComponentSystemEventListener
event
- ComponentSystemEvent
экземпляр, который обрабатывается. AbortProcessingException
- если обработка жизненного цикла должна прекратиться для этого запроса.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
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
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
protected abstract FacesContext getFacesContext()
Метод удобства, чтобы возвратиться FacesContext
экземпляр для текущего запроса.
protected abstract Renderer getRenderer(FacesContext context)
Метод удобства, чтобы возвратиться Renderer
экземпляр, связанный с этим компонентом, если любой; иначе, возвратиться null
.
context
- FacesContext
для текущего запроса
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41