Spec-Zone .ru спецификации, руководства, описания, API

javax.faces.event
Тип аннотации ListenerFor

@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 ко всем компонентам, которые перечисляют это как их средство рендеринга.

С тех пор:

2.0

Необходимая Сводка Элемента

java.lang.Class<? extends SystemEvent>

systemEventClass Вид системного события, для которого этот class будет установлен как слушатель.

Дополнительная Сводка Элемента

java.lang.Class

sourceClass Вид объекта, который испускает события типа, данного значением systemEventClass() атрибут.

Деталь элемента

systemEventClass

public abstract java.lang.Class<? extends SystemEvent> systemEventClass

Вид системного события, для которого этот class будет установлен как слушатель. Реализация только поддерживает точные совпадения на Class и не должен соблюдать отношения подкласса. Это допустимо, чтобы иметь ЭЛЬ Выражения в значении этого атрибута, пока выражение решает к экземпляру ожидаемого типа.

sourceClass

public abstract java.lang.Class sourceClass

Вид объекта, который испускает события типа, данного значением systemEventClass() атрибут. Это допустимо, чтобы иметь ЭЛЬ Выражения в значении этого атрибута, пока выражение решает к экземпляру ожидаемого типа.

Значение по умолчанию:

java.lang. Пусто. class