Класс EventSetDescriptor

public class EventSetDescriptor
extends FeatureDescriptor

EventSetDescriptor описывает группу событий, которые генерирует данный Java-компонент.

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

Конструкторы

EventSetDescriptor

public EventSetDescriptor(Class<?> sourceClass,
                          String eventSetName,
                          Class<?> listenerType,
                          String listenerMethodName)
                   throws IntrospectionException

Создаёт EventSetDescriptor, предполагая, что вы следуете самому простому стандартному шаблону проектирования, где именованное событие «fred» (1) доставляется как вызов единственного метода интерфейса FredListener, (2) имеет единственный аргумент типа FredEvent, и (3) где FredListener может быть зарегистрирован с помощью вызова метода addFredListener компонента-источника и удалён с помощью вызова метода removeFredListener.

Параметры:

sourceClass - Класс, генерирующий событие.

eventSetName - Программное имя события. Например, «fred». Обратите внимание, что оно обычно должно начинаться с маленькой буквы.

listenerType - Целевой интерфейс, которому будут доставляться события.

listenerMethodName - Метод, который будет вызываться при доставке события целевому интерфейсу-слушателю.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

EventSetDescriptor

public EventSetDescriptor(Class<?> sourceClass,
                          String eventSetName,
                          Class<?> listenerType,
                          String[] listenerMethodNames,
                          String addListenerMethodName,
                          String removeListenerMethodName)
                   throws IntrospectionException

Создаёт EventSetDescriptor с нуля, используя строковые имена.

Параметры:

sourceClass - Класс, генерирующий событие.

eventSetName - Программное имя набора событий. Обратите внимание, что оно обычно должно начинаться с маленькой буквы.

listenerType - Класс целевого интерфейса, которому будут доставляться события.

listenerMethodNames - Имена методов, которые будут вызываться при доставке события целевому интерфейсу-слушателю.

addListenerMethodName - Имя метода в источнике события, который можно использовать для регистрации объекта-слушателя события.

removeListenerMethodName - Имя метода в источнике события, который можно использовать для отмены регистрации объекта-слушателя события.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

EventSetDescriptor

public EventSetDescriptor(Class<?> sourceClass,
                          String eventSetName,
                          Class<?> listenerType,
                          String[] listenerMethodNames,
                          String addListenerMethodName,
                          String removeListenerMethodName,
                          String getListenerMethodName)
                   throws IntrospectionException

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

Параметры:

sourceClass - Класс, генерирующий событие.

eventSetName - Программное имя набора событий. Обратите внимание, что оно обычно должно начинаться с маленькой буквы.

listenerType - Класс целевого интерфейса, которому будут доставляться события.

listenerMethodNames - Имена методов, которые будут вызываться при доставке события целевому интерфейсу-слушателю.

addListenerMethodName - Имя метода в источнике события, который можно использовать для регистрации объекта-слушателя события.

removeListenerMethodName - Имя метода в источнике события, который можно использовать для отмены регистрации объекта-слушателя события.

getListenerMethodName - Метод в источнике события, который можно использовать для доступа к массиву объектов-слушателей события.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

С:

1.4

EventSetDescriptor

public EventSetDescriptor(String eventSetName,
                          Class<?> listenerType,
                          Method[] listenerMethods,
                          Method addListenerMethod,
                          Method removeListenerMethod)
                   throws IntrospectionException

Создаёт EventSetDescriptor с нуля, используя объекты java.lang.reflect.Method и java.lang.Class.

Параметры:

eventSetName - Программное имя набора событий.

listenerType - Класс интерфейса-слушателя.

listenerMethods - Массив объектов Method, описывающих каждый из методов обработки событий в целевом интерфейсе-слушателе.

addListenerMethod - Метод в источнике события, который можно использовать для регистрации объекта-слушателя события.

removeListenerMethod - Метод в источнике события, который можно использовать для отмены регистрации объекта-слушателя события.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

EventSetDescriptor

public EventSetDescriptor(String eventSetName,
                          Class<?> listenerType,
                          Method[] listenerMethods,
                          Method addListenerMethod,
                          Method removeListenerMethod,
                          Method getListenerMethod)
                   throws IntrospectionException

Этот конструктор создаёт EventSetDescriptor с нуля, используя объекты java.lang.reflect.Method и java.lang.Class.

Параметры:

eventSetName - Программное имя набора событий.

listenerType - Класс интерфейса-слушателя.

listenerMethods - Массив объектов Method, описывающих каждый из методов обработки событий в целевом интерфейсе-слушателе.

addListenerMethod - Метод в источнике события, который можно использовать для регистрации объекта-слушателя события.

removeListenerMethod - Метод в источнике события, который можно использовать для отмены регистрации объекта-слушателя события.

getListenerMethod - Метод в источнике события, который можно использовать для доступа к массиву объектов-слушателей события.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

С:

1.4

EventSetDescriptor

public EventSetDescriptor(String eventSetName,
                          Class<?> listenerType,
                          MethodDescriptor[] listenerMethodDescriptors,
                          Method addListenerMethod,
                          Method removeListenerMethod)
                   throws IntrospectionException

Создаёт EventSetDescriptor с нуля, используя объекты java.lang.reflect.MethodDescriptor и java.lang.Class.

Параметры:

eventSetName - Программное имя набора событий.

listenerType - Класс интерфейса-слушателя.

listenerMethodDescriptors - Массив объектов MethodDescriptor, описывающих каждый из методов обработки событий в целевом интерфейсе-слушателе.

addListenerMethod - Метод в источнике события, который можно использовать для регистрации объекта-слушателя события.

removeListenerMethod - Метод в источнике события, который можно использовать для отмены регистрации объекта-слушателя события.

Исключения:

IntrospectionException - если при интроспекции возникло исключение.

Методы

getListenerType

public Class<?> getListenerType()

Возвращает объект Class для целевого интерфейса.

Возвращает:

Объект Class для целевого интерфейса, который будет вызван при срабатывании события.

getListenerMethods

public Method[] getListenerMethods()

Получает методы целевого интерфейса-слушателя.

Возвращает:

Массив объектов Method для целевых методов в целевом интерфейсе-слушателе, которые будут вызваны при срабатывании событий.

getListenerMethodDescriptors

public MethodDescriptor[] getListenerMethodDescriptors()

Получает MethodDescriptor целевого интерфейса-слушателя.

Возвращает:

Массив объектов MethodDescriptor для целевых методов в целевом интерфейсе-слушателе, которые будут вызваны при срабатывании событий.

getAddListenerMethod

public Method getAddListenerMethod()

Получает метод добавления слушателей событий.

Возвращает:

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

getRemoveListenerMethod

public Method getRemoveListenerMethod()

Получает метод удаления слушателей событий.

Возвращает:

Метод, используемый для удаления слушателя в источнике события.

getGetListenerMethod

public Method getGetListenerMethod()

Получает метод доступа к зарегистрированным слушателям событий.

Возвращает:

Метод, используемый для доступа к массиву слушателей в источнике события, или null, если он не существует.

С:

1.4

setUnicast

public void setUnicast(boolean unicast)

Помечает набор событий как одноадресные (или нет).

Параметры:

unicast - True, если набор событий одноадресных.

isUnicast

public boolean isUnicast()

Обычно источники событий являются многоадресными. Однако есть некоторые исключения, которые являются строго одноадресными.

Возвращает:

true если набор событий одноадресных. По умолчанию false.

setInDefaultEventSet

public void setInDefaultEventSet(boolean inDefaultEventSet)

Помечает набор событий как находящийся в «стандартном» наборе (или нет). По умолчанию это true.

Параметры:

inDefaultEventSet - true если набор событий находится в «стандартном» наборе, false если нет

isInDefaultEventSet

public boolean isInDefaultEventSet()

Сообщает, находится ли набор событий в «стандартном» наборе.

Возвращает:

true если набор событий находится в «стандартном» наборе. По умолчанию true.