Класс BeanContextChildSupport

Все реализованные интерфейсы:
BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Serializable, EventListener
Прямые известные подклассы:
BeanContextSupport
public class BeanContextChildSupport
extends Object
implements BeanContextChild, BeanContextServicesListener, Serializable

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

С:
1.2
См. также:
BeanContext, BeanContextServices, BeanContextChild, Сериализованная форма

Поля

Модификатор и тип Поле Описание
protected BeanContext beanContext

Контекст бин.
BeanContextChild beanContextChildPeer

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

protected PropertyChangeSupport pcSupport

Связанный с этим BeanContextChildSupport PropertyChangeSupport.

protected boolean rejectedSetBCOnce

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

Связанный с этим BeanContextChildSupport VetoableChangeSupport.

Конструкторы

Конструктор Описание
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

Контекст бин.

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, 2020, 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/11/docs/api/java.desktop/java/beans/beancontext/BeanContextChildSupport.html

Spec-Zone .ru
спецификации, руководства, описания, API