Класс BeanContextChildSupport

java.lang.Object

java.beans.beancontext.BeanContextChildSupport

Все реализованные интерфейсы:: BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Serializable, EventListener

Непосредственные известные подклассы:: BeanContextSupport

public class BeanContextChildSupport extends Object implements BeanContextChild, BeanContextServicesListener, Serializable

Этот класс является общей вспомогательной классом для реализации протокола BeanContextChild. Этот класс можно либо напрямую наследовать, либо использовать для инкапсуляции и делегирования реализации этого интерфейса для данного компонента.

Since:

1.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected BeanContext`	`beanContext`	Контекст бин.
`BeanContextChild`	`beanContextChildPeer`	Контекст, в котором вложен этот `BeanContextChild`.
`protected PropertyChangeSupport`	`pcSupport`	`PropertyChangeSupport` связанный с этим `BeanContextChildSupport`.
`protected boolean`	`rejectedSetBCOnce`	Флаг, указывающий, что по крайней мере одна `PropertyChangeVetoException` была выброшена для попытки операции setBeanContext.
`protected VetoableChangeSupport`	`vcSupport`	`VetoableChangeSupport` связанный с этим `BeanContextChildSupport`.

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

Конструктор	Описание
`BeanContextChildSupport()`	Конструктор BeanContextChildSupport, где этот класс был унаследован для реализации самого компонента JavaBean.
`BeanContextChildSupport(BeanContextChild bcc)`	Конструктор BeanContextChildSupport, где сам компонент JavaBean реализует BeanContextChild и инкапсулирует его, делегируя этот интерфейс этой реализации.

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

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(String name, PropertyChangeListener pcl)`	Добавляет PropertyChangeListener для конкретного свойства.
`void`	`addVetoableChangeListener(String name, VetoableChangeListener vcl)`	Добавляет VetoableChangeListener для конкретного свойства.
`void`	`firePropertyChange(String name, Object oldValue, Object newValue)`	Сообщает об обновлении связанного свойства всем зарегистрированным слушателям.
`void`	`fireVetoableChange(String name, Object oldValue, Object newValue)`	Сообщает об обновлении vetoable свойства всем зарегистрированным слушателям.
`BeanContext`	`getBeanContext()`	Получает вложенный `BeanContext` для этого `BeanContextChildSupport`.
`BeanContextChild`	`getBeanContextChildPeer()`	Получает `BeanContextChild` связанный с этим `BeanContextChildSupport`.
`protected void`	`initializeBeanContextResources()`	Этот метод может быть переопределен подклассами для обеспечения собственных инициализационных действий.
`boolean`	`isDelegated()`	Указывает, является ли этот класс делегатом другого.
`protected void`	`releaseBeanContextResources()`	Этот метод может быть переопределен подклассами для обеспечения собственных действий выхода.
`void`	`removePropertyChangeListener(String name, PropertyChangeListener pcl)`	Удаляет PropertyChangeListener для конкретного свойства.
`void`	`removeVetoableChangeListener(String name, VetoableChangeListener vcl)`	Удаляет `VetoableChangeListener`.
`void`	`serviceAvailable(BeanContextServiceAvailableEvent bcsae)`	Доступен новый сервис из вложенного BeanContext.
`void`	`serviceRevoked(BeanContextServiceRevokedEvent bcsre)`	Сервис, предоставляемый вложенным BeanContext, был отозван.
`void`	`setBeanContext(BeanContext bc)`	Устанавливает `BeanContext` для этого `BeanContextChildSupport`.
`boolean`	`validatePendingSetBeanContext(BeanContext newValue)`	Вызывается из setBeanContext для проверки (или иного) ожидаемого изменения значения свойства вложенного BeanContext.

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

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

Подробное описание полей

beanContextChildPeer

public BeanContextChild beanContextChildPeer

Контекст, в котором вложен этот элемент.

pcSupport

protected PropertyChangeSupport pcSupport

Объект, связанный с этим элементом.

vcSupport

protected VetoableChangeSupport vcSupport

Объект, связанный с этим элементом.

beanContext

protected transient BeanContext beanContext

Контекст bean.

rejectedSetBCOnce

protected transient boolean rejectedSetBCOnce

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

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

BeanContextChildSupport

public BeanContextChildSupport()

Конструирует BeanContextChildSupport, где этот класс был расширен для реализации компонента JavaBean.

BeanContextChildSupport

public BeanContextChildSupport(BeanContextChild bcc)

Конструирует BeanContextChildSupport, где компонент JavaBean сам реализует BeanContextChild и инкапсулирует его, делегируя этот интерфейс этой реализации

Параметры:: bcc - базовый элемент bean context child

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

setBeanContext

public void setBeanContext(BeanContext bc) throws PropertyVetoException

Устанавливает контекст для этого элемента.

Установлено в:: setBeanContext в интерфейсе BeanContextChild
Параметры:: bc - новое значение для свойства BeanContext
Исключения:: PropertyVetoException - если изменение отклонено

getBeanContext

public BeanContext getBeanContext()

Возвращает вложенный контекст для этого элемента.

Установлено в:: getBeanContext в интерфейсе BeanContextChild
Возвращает:: вложенный контекст для этого элемента.

addPropertyChangeListener

public void addPropertyChangeListener(String name, PropertyChangeListener pcl)

Добавляет PropertyChangeListener для определенного свойства. Один и тот же объект слушателя может быть добавлен более одного раза. Для каждого свойства слушатель будет вызываться столько раз, сколько раз он был добавлен для этого свойства. Если name или pcl равно null, исключение не выбрасывается и никаких действий не выполняется.

Установлено в:: addPropertyChangeListener в интерфейсе BeanContextChild
Параметры:: name - имя свойства, за которым нужно наблюдать; pcl - добавляемый слушатель

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)

Удаляет PropertyChangeListener для определенного свойства. Если pcl был добавлен более одного раза к одному и тому же источнику событий для указанного свойства, он будет уведомлен на один раз меньше после удаления. Если name равно null, исключение не выбрасывается и никаких действий не выполняется. Если pcl равно null или никогда не добавлялся для указанного свойства, исключение не выбрасывается и никаких действий не выполняется.

Установлено в:: removePropertyChangeListener в интерфейсе BeanContextChild
Параметры:: name - имя свойства, за которым наблюдали; pcl - удаляемый слушатель

addVetoableChangeListener

public void addVetoableChangeListener(String name, VetoableChangeListener vcl)

Добавляет VetoableChangeListener для определенного свойства. Один и тот же объект слушателя может быть добавлен более одного раза. Для каждого свойства слушатель будет вызываться столько раз, сколько раз он был добавлен для этого свойства. Если name или vcl равно null, исключение не выбрасывается и никаких действий не выполняется.

Установлено в:: addVetoableChangeListener в интерфейсе BeanContextChild
Параметры:: name - имя свойства, за которым нужно наблюдать; vcl - добавляемый слушатель

removeVetoableChangeListener

public void removeVetoableChangeListener(String name, VetoableChangeListener vcl)

Удаляет слушателя. Если pcl был добавлен более одного раза к одному и тому же источнику событий для указанного свойства, он будет уведомлен на один раз меньше после удаления. Если name равно null, исключение не выбрасывается и никаких действий не выполняется. Если vcl равно null или никогда не добавлялся для указанного свойства, исключение не выбрасывается и никаких действий не выполняется.

Установлено в:: removeVetoableChangeListener в интерфейсе BeanContextChild
Параметры:: name - имя свойства, за которым наблюдали; vcl - удаляемый слушатель

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcsre)

Услуга, предоставляемая вложенным BeanContext, была отозвана. Подклассы могут переопределить этот метод, чтобы реализовать собственное поведение.

Установлено в:: serviceRevoked в интерфейсе BeanContextServiceRevokedListener
Параметры:: bcsre - событие, сгенерированное при отзыве услуги

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcsae)

Новая услуга доступна из вложенного BeanContext. Подклассы могут переопределить этот метод, чтобы реализовать собственное поведение

Установлено в:: serviceAvailable в интерфейсе BeanContextServicesListener
Параметры:: bcsae - событие, сгенерированное при доступности услуги

getBeanContextChildPeer

public BeanContextChild getBeanContextChildPeer()

Возвращает объект, связанный с этим элементом.

Возвращает:: объект-виртуальный помощник этого класса

isDelegated

public boolean isDelegated()

Указывает, является ли этот класс делегатом другого.

Возвращает:: true, если этот класс является делегатом другого

firePropertyChange

public void firePropertyChange(String name, Object oldValue, Object newValue)

Сообщает о внесении изменений в свойство зарегистрированным слушателям. Событие не генерируется, если старое и новое значения равны и не равны null.

Параметры:: name - программное имя измененного свойства; oldValue - старое значение свойства; newValue - новое значение свойства

fireVetoableChange

public void fireVetoableChange(String name, Object oldValue, Object newValue) throws PropertyVetoException

Сообщает о возможных изменениях свойства зарегистрированным слушателям. Если кто-то отклонит изменение, то сгенерирует новое событие, вернув всех к старому значению, и затем повторно выбросит PropertyVetoException.

Событие не генерируется, если старое и новое значения равны и не равны null.

Параметры:: name - программное имя свойства, которое собирается измениться; oldValue - старое значение свойства; newValue - новое значение свойства
Исключения:: PropertyVetoException - если получатель хочет отменить изменение свойства.

validatePendingSetBeanContext

public boolean validatePendingSetBeanContext(BeanContext newValue)

Вызывается из setBeanContext для проверки (или иного) ожидаемого изменения значения свойства вложенного BeanContext. Возврат false приведет к выбросу PropertyVetoException в setBeanContext.

Параметры:: newValue - запрашиваемое новое значение свойства BeanContext
Возвращает:: true если операция изменения должна быть отклонена

releaseBeanContextResources

protected void releaseBeanContextResources()

Этот метод может быть переопределен подклассами для обеспечения собственного поведения при освобождении. При вызове любые ресурсы, удерживаемые этим экземпляром, полученные из текущего свойства BeanContext, должны быть освобождены, так как объект больше не вложен в этот BeanContext.

initializeBeanContextResources

protected void initializeBeanContextResources()

Этот метод может быть переопределен подклассами для обеспечения собственного поведения при инициализации. При вызове любые ресурсы, необходимые BeanContextChild, должны быть получены из текущего BeanContext.

© 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/beancontext/BeanContextChildSupport.html