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

Возвращает:: Объект 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, 2021, 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/17/docs/api/java.desktop/java/beans/EventSetDescriptor.html