Класс EventSetDescriptor

java.lang.Object

java.beans.FeatureDescriptor

java.beans.EventSetDescriptor

public class EventSetDescriptor extends FeatureDescriptor

EventSetDescriptor описывает группу событий, генерируемых указанным 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)`	Помечает набор событий как одноадресный (или не одноадресный).

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

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

Методы, объявленные в классе 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 — Class целевого интерфейса, которому будут передаваться события.; 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 — Class целевого интерфейса, которому будут передаваться события.; 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 — Class интерфейса прослушивателя.; 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 — Class интерфейса прослушивателя.; 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 — Class интерфейса прослушивателя.; 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.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/beans/EventSetDescriptor.html