Интерфейс BeanContextChild

Все известные подинтерфейсы:: BeanContext, BeanContextServices

Все известные реализующие классы:: BeanContextChildSupport, BeanContextServicesSupport, BeanContextSupport

public interface BeanContextChild

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

Соответствующие BeanContext в качестве побочного эффекта добавления объекта BeanContextChild передают ссылку на себя через метод setBeanContext() этого интерфейса.

Обратите внимание, что BeanContextChild может отклонить изменение состояния, бросив исключение PropertyVetoedException.

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

С:: 1.2
См. также:: BeanContext, PropertyChangeEvent, PropertyChangeListener, PropertyVetoException, VetoableChangeListener

Методы

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(String name, PropertyChangeListener pcl)`	Добавляет `PropertyChangeListener` к этому `BeanContextChild`, чтобы получать `PropertyChangeEvent`, когда указанное свойство изменится.
`void`	`addVetoableChangeListener(String name, VetoableChangeListener vcl)`	Добавляет `VetoableChangeListener` к этому `BeanContextChild`, чтобы получать события всякий раз, когда указанное свойство меняется.
`BeanContext`	`getBeanContext()`	Возвращает `BeanContext` , связанный с этим `BeanContextChild`.
`void`	`removePropertyChangeListener(String name, PropertyChangeListener pcl)`	Удаляет `PropertyChangeListener` из этого `BeanContextChild`, чтобы оно больше не получало `PropertyChangeEvents` при изменении указанного свойства.
`void`	`removeVetoableChangeListener(String name, VetoableChangeListener vcl)`	Удаляет `VetoableChangeListener` из этого `BeanContextChild`, чтобы оно больше не получало события при изменении указанного свойства.
`void`	`setBeanContext(BeanContext bc)`	Объекты, реализующие этот интерфейс, генерируют событие java.beans.PropertyChangeEvent со следующими параметрами: имя свойства "beanContext", предыдущее значение (предыдущий вложенный экземпляр `BeanContext`, или `null`), новое значение (текущий вложенный экземпляр `BeanContext`, или `null`).

Методы

setBeanContext

void setBeanContext(BeanContext bc)
             throws PropertyVetoException

Объекты, реализующие этот интерфейс, генерируют событие java.beans.PropertyChangeEvent со следующими параметрами: имя свойства "beanContext", предыдущее значение (предыдущий вложенный экземпляр BeanContext, или null), новое значение (текущий вложенный экземпляр BeanContext, или null).

Изменение значения свойства вложенного BeanContext этого BeanContextChild может быть отменено путём выброса соответствующего исключения.

Параметры:: bc - BeanContext , с которым следует связать этот BeanContextChild.
Исключения:: PropertyVetoException - если добавление указанного BeanContext отклоняется.

getBeanContext

BeanContext getBeanContext()

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

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

addPropertyChangeListener

void addPropertyChangeListener(String name,
                               PropertyChangeListener pcl)

Добавляет PropertyChangeListener к этому BeanContextChild, чтобы получать PropertyChangeEvent, когда указанное свойство изменится.

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

removePropertyChangeListener

void removePropertyChangeListener(String name,
                                  PropertyChangeListener pcl)

Удаляет PropertyChangeListener из этого BeanContextChild, чтобы оно больше не получало PropertyChangeEvents при изменении указанного свойства.

Параметры:: name - имя свойства, за которым следили; pcl - удаляемый PropertyChangeListener

addVetoableChangeListener

void addVetoableChangeListener(String name,
                               VetoableChangeListener vcl)

Добавляет VetoableChangeListener к этому BeanContextChild, чтобы получать события всякий раз, когда указанное свойство меняется.

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

removeVetoableChangeListener

void removeVetoableChangeListener(String name,
                                  VetoableChangeListener vcl)

Удаляет VetoableChangeListener из этого BeanContextChild, чтобы оно больше не получало события при изменении указанного свойства.

Параметры:: name - имя свойства, за которым следили.; vcl - удаляемый VetoableChangeListener.