Класс EventSetDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.EventSetDescriptor

public class EventSetDescriptor extends FeatureDescriptor

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

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

С момента:: 1.1

Краткое описание конструкторов

Конструктор	Описание
`EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String listenerMethodName)`	Создает `EventSetDescriptor`, предполагая, что вы следуете наиболее простому стандартному шаблону проектирования, где именованное событие "fred" (1) передается как вызов единственного метода интерфейса FredListener, (2) имеет один аргумент типа FredEvent и (3) где FredListener может быть зарегистрирован с помощью вызова метода addFredListener компонента-источника и удален с помощью вызова метода removeFredListener.
`EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName)`	Создает `EventSetDescriptor` с нуля, используя строковые имена.
`EventSetDescriptor(Class<?> sourceClass, String eventSetName, Class<?> listenerType, String[] listenerMethodNames, String addListenerMethodName, String removeListenerMethodName, String getListenerMethodName)`	Этот конструктор создает EventSetDescriptor с нуля, используя строковые имена.
`EventSetDescriptor(String eventSetName, Class<?> listenerType, MethodDescriptor[] listenerMethodDescriptors, Method addListenerMethod, Method removeListenerMethod)`	Создает `EventSetDescriptor` с нуля, используя `java.lang.reflect.MethodDescriptor` и `java.lang.Class` объекты.
`EventSetDescriptor(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod)`	Создает `EventSetDescriptor` с нуля, используя `java.lang.reflect.Method` и `java.lang.Class` объекты.
`EventSetDescriptor(String eventSetName, Class<?> listenerType, Method[] listenerMethods, Method addListenerMethod, Method removeListenerMethod, Method getListenerMethod)`	Этот конструктор создает EventSetDescriptor с нуля, используя объекты java.lang.reflect.Method и java.lang.Class.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Method`	`getAddListenerMethod()`	Возвращает метод, используемый для добавления обработчиков событий.
`Method`	`getGetListenerMethod()`	Возвращает метод, используемый для доступа к зарегистрированным обработчикам событий.
`MethodDescriptor[]`	`getListenerMethodDescriptors()`	Возвращает `MethodDescriptor` целевого интерфейса обработчика.
`Method[]`	`getListenerMethods()`	Возвращает методы целевого интерфейса обработчика.
`Class<?>`	`getListenerType()`	Возвращает объект `Class` для целевого интерфейса.
`Method`	`getRemoveListenerMethod()`	Возвращает метод, используемый для удаления обработчиков событий.
`boolean`	`isInDefaultEventSet()`	Сообщает, находится ли набор событий в наборе "по умолчанию".
`boolean`	`isUnicast()`	Обычно источники событий являются многоадресными.
`void`	`setInDefaultEventSet(boolean inDefaultEventSet)`	Помечает набор событий как находящийся в наборе "по умолчанию" (или нет).
`void`	`setUnicast(boolean unicast)`	Помечает набор событий как одноадресные (или нет).

Методы, объявленные в классе java.beans.FeatureDescriptor

attributeNames, getDisplayName, getName, getShortDescription, getValue, isExpert, isHidden, isPreferred, setDisplayName, setExpert, setHidden, setName, setPreferred, setShortDescription, setValue, toString

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

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 для целевого интерфейса.

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

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.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/beans/EventSetDescriptor.html