Класс 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

Модификатор и тип	Метод	Описание
`Enumeration<String>`	`attributeNames()`	Возвращает перечисление независимых от локали имён этой характеристики.
`String`	`getDisplayName()`	Возвращает локализованное отображаемое имя этой характеристики.
`String`	`getName()`	Возвращает программное имя этой характеристики.
`String`	`getShortDescription()`	Возвращает краткое описание этой характеристики.
`Object`	`getValue(String attributeName)`	Получает именованный атрибут этой характеристики.
`boolean`	`isExpert()`	Флаг «экспертный» позволяет отличать характеристики, предназначенные для опытных пользователей, от характеристик, предназначенных для обычных пользователей.
`boolean`	`isHidden()`	Флаг «скрытый» используется для обозначения характеристик, предназначенных только для инструментов и не отображаемых пользователям.
`boolean`	`isPreferred()`	Флаг «предпочтительный» используется для обозначения характеристик, которые особенно важно показывать пользователям.
`void`	`setDisplayName(String displayName)`	Задаёт локализованное отображаемое имя этой характеристики.
`void`	`setExpert(boolean expert)`	Флаг «экспертный» позволяет отличать характеристики, предназначенные для опытных пользователей, от характеристик, предназначенных для обычных пользователей.
`void`	`setHidden(boolean hidden)`	Флаг «скрытый» используется для обозначения характеристик, предназначенных только для инструментов и не отображаемых пользователям.
`void`	`setName(String name)`	Задаёт программное имя этой характеристики.
`void`	`setPreferred(boolean preferred)`	Флаг «предпочтительный» используется для обозначения характеристик, которые особенно важно показывать пользователям.
`void`	`setShortDescription(String text)`	К характеристике можно добавить краткое описательное сообщение.
`void`	`setValue(String attributeName, Object value)`	Добавляет к этой характеристике именованный атрибут.
`String`	`toString()`	Возвращает строковое представление объекта.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

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.

© 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.