Класс BeanContextChildSupport

java.lang.Object

java.beans.beancontext.BeanContextChildSupport

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

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

public class BeanContextChildSupport extends Object implements BeanContextChild, BeanContextServicesListener, Serializable

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

С момента:

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)`	Сообщает об обновлении отменяемого свойства всем зарегистрированным слушателям.
`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

Вложенный BeanContext для этого BeanContextChild.

pcSupport

protected PropertyChangeSupport pcSupport

Связанный PropertyChangeSupport для данного BeanContextChildSupport.

vcSupport

protected VetoableChangeSupport vcSupport

Связанный VetoableChangeSupport для этого BeanContextChildSupport.

beanContext

protected transient BeanContext beanContext

Контекст bean.

rejectedSetBCOnce

protected transient boolean rejectedSetBCOnce

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

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

BeanContextChildSupport

public BeanContextChildSupport()

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

BeanContextChildSupport

public BeanContextChildSupport(BeanContextChild bcc)

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

Параметры:: bcc - базовый компонент BeanContextChild

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

setBeanContext

public void setBeanContext(BeanContext bc) throws PropertyVetoException

Устанавливает BeanContext для данного BeanContextChildSupport.

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

getBeanContext

public BeanContext getBeanContext()

Возвращает вложенный BeanContext для данного BeanContextChildSupport.

Определено в:: getBeanContext в интерфейсе BeanContextChild
Возвращает:: вложенный BeanContext для данного BeanContextChildSupport.

addPropertyChangeListener

public void addPropertyChangeListener(String name, PropertyChangeListener pcl)

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

Определено в:: addPropertyChangeListener в интерфейсе BeanContextChild
Параметры:: name - Название свойства для прослушивания; pcl - Добавленный PropertyChangeListener

removePropertyChangeListener

public void removePropertyChangeListener(String name, PropertyChangeListener pcl)

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

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

addVetoableChangeListener

public void addVetoableChangeListener(String name, VetoableChangeListener vcl)

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

Определено в:: addVetoableChangeListener в интерфейсе BeanContextChild
Параметры:: name - Название свойства для прослушивания; vcl - Добавленный VetoableChangeListener

removeVetoableChangeListener

public void removeVetoableChangeListener(String name, VetoableChangeListener vcl)

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

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

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcsre)

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

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

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcsae)

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

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

getBeanContextChildPeer

public BeanContextChild getBeanContextChildPeer()

Возвращает BeanContextChild связанный с этим BeanContextChildSupport.

Возвращает:: объект-посредник BeanContextChild данного класса

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 приведет к тому, что setBeanContext выбросит PropertyVetoException.

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

releaseBeanContextResources

protected void releaseBeanContextResources()

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

initializeBeanContextResources

protected void initializeBeanContextResources()

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

© 1993, 2023, 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/21/docs/api/java.desktop/java/beans/beancontext/BeanContextChildSupport.html