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

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, представьте дочерний элемент UIComponents этого 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()
          Возвратите число дочернего элемента UIComponents, которые связываются с этим UIComponent.
abstract  java.util.List<UIComponent> getChildren()
          Возвратите изменчивое List представление дочернего элемента UIComponents связанный с этим компонентом.
 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)
          Возвратите массив зарегистрированных FacesListeners, которые являются экземплярами указанного class.
abstract  UIComponent getFacet(java.lang.String name)
          Метод удобства, чтобы возвратить именованный фасет, если это существует, или null иначе.
 int getFacetCount()
          Возвратите число фасета UIComponents, которые связываются с этим UIComponent.
abstract  java.util.Map<java.lang.String,UIComponent> getFacets()
          Возвратите изменчивое Map представление фасета UIComponents связанный с этим UIComponent, включенный фасетным именем (который должен быть Строкой).
abstract  java.util.Iterator<UIComponent> getFacetsAndChildren()
          Возвратитесь Iterator по фасету, сопровождаемому дочерним элементом UIComponents этого 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 методы, плюс поддержка следующие дополнительные требования:


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() реализация):

Параметры:
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 будет опубликован также, сначала для этого узла, и затем для дочерних элементов узла, но только если любое из следующих условий является истиной.

Этот метод никогда не должны вызывать разработчики; 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 методы, плюс поддержка следующие дополнительные требования:


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 может использоваться, пока конечный результат является тем же самым:

Параметры:
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 методы, плюс поддержка следующие дополнительные требования:


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)

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

С тех пор:
2.1

getListenersForEventClass

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

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

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

getNamingContainer

public UIComponent getNamingContainer()

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

С тех пор:
2.0

processRestoreState

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

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

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

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

processDecodes

public abstract void processDecodes(FacesContext context)

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

Параметры:
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)

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

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

processUpdates

public abstract void processUpdates(FacesContext context)

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

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

processSaveState

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

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

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

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

getFacesContext

protected abstract FacesContext getFacesContext()

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


getRenderer

protected abstract Renderer getRenderer(FacesContext context)

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

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


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

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

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


Spec-Zone.ru - all specs in one place



free hit counter