Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: НЕОБХОДИМЫЙ | ДОПОЛНИТЕЛЬНЫЙ | ДЕТАЛЬ: ЭЛЕМЕНТ |
@Retention(value=RUNTIME) @Target(value=TYPE) @Inherited public @interface ListenerFor
Классы, тегированные с этой аннотацией, устанавливаются как слушатели, использующие метод Application.subscribeToEvent(java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Class<?>, javax.faces.event.SystemEventListener)
или UIComponent.subscribeToEvent(java.lang.Class<? extends javax.faces.event.SystemEvent>, javax.faces.event.ComponentSystemEventListener)
(в зависимости от обстоятельств, описанных ниже).
Реализация по умолчанию должна поддерживать присоединение этой аннотации к UIComponent
или Renderer
классы. В обоих случаях обработка аннотации, описанная здесь, должна начаться во время реализации любой разновидности Application
.createComponent()
и должен завершиться перед UIComponent
экземпляр возвращается из createComponent()
. Обработка аннотации должна продолжиться согласно алгоритму, семантически эквивалентному следующему.
Если эта аннотация не присутствует на рассматриваемом class, никакие меры не должны быть предприняты.
Определите "цель", на которой можно вызвать subscribeToEvent
.
Если class, к которому эта аннотация присоединяется реализации ComponentSystemEventListener
и a UIComponent
экземпляр, "цель" UIComponent
экземпляр.
Если class, к которому эта аннотация присоединяется реализации ComponentSystemEventListener
и a Renderer
экземпляр, "цель" UIComponent
экземпляр, который должен быть представлен этим Renderer
экземпляр.
Если class, к которому эта аннотация присоединяется реализации ComponentSystemEventListener
и ни один не экземпляр Renderer
ни UIComponent
, предпринятые меры являются неуказанными. Этот случай не должен инициировать вид ошибки.
Если class, к которому эта аннотация присоединяется реализации SystemEventListener
и не реализует ComponentSystemEventListener
, "цель" Application
экземпляр.
Определите разновидность subscribeToEvent()
вызывать и параметры, чтобы передать к этому.
Если "цель" является a UIComponent
вызвать UIComponent.subscribeToEvent(Class, ComponentSystemEventListener)
, передача systemEventClass()
из аннотации как первый параметр и экземпляр class, к которому присоединяется эта аннотация (который должен реализовать ComponentSystemEventListener
) как второй параметр.
Если "цель" Application
экземпляр, осмотрите значение sourceClass()
значение атрибута аннотации.
Если значение Void.class
, вызвать Application.subscribeToEvent(Class, SystemEventListener)
, передача значения systemEventClass()
как первый параметр и экземпляр class, к которому присоединяется эта аннотация (который должен реализовать SystemEventListener) as the second argument.
Иначе, вызвать Application.subscribeToEvent(Class, Class, SystemEventListener)
, передача значения systemEventClass()
как первый параметр, значение sourceClass()
как второй параметр, и экземпляр class, к которому присоединяется эта аннотация (который должен реализовать SystemEventListener) as the third argument.
Пример: стандартное средство рендеринга для javax.faces.resource.Stylesheet
должен иметь следующее объявление аннотации:
@ListenerFor(systemEventClass=PostAddToViewEvent.class)
Это заставит средство рендеринга быть добавленным как слушатель для PostAddToViewEvent
ко всем компонентам, которые перечисляют это как их средство рендеринга.
Необходимая Сводка Элемента | |
---|---|
java.lang.Class<? extends SystemEvent> |
systemEventClass
Вид системного события, для которого этот class будет установлен как слушатель. |
Дополнительная Сводка Элемента | |
---|---|
java.lang.Class |
sourceClass
Вид объекта, который испускает события типа, данного значением |
Деталь элемента |
---|
public abstract java.lang.Class<? extends SystemEvent> systemEventClass
Вид системного события, для которого этот class будет установлен как слушатель. Реализация только поддерживает точные совпадения на Class
и не должен соблюдать отношения подкласса. Это допустимо, чтобы иметь ЭЛЬ Выражения в значении этого атрибута, пока выражение решает к экземпляру ожидаемого типа.
public abstract java.lang.Class sourceClass
Вид объекта, который испускает события типа, данного значением systemEventClass()
атрибут. Это допустимо, чтобы иметь ЭЛЬ Выражения в значении этого атрибута, пока выражение решает к экземпляру ожидаемого типа.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: НЕОБХОДИМЫЙ | ДОПОЛНИТЕЛЬНЫЙ | ДЕТАЛЬ: ЭЛЕМЕНТ |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41