Интерфейс BeanContextChild
- Все известные подинтерфейсы:
-
BeanContext,BeanContextServices
- Все известные реализующие классы:
-
BeanContextChildSupport,BeanContextServicesSupport,BeanContextSupport
public interface BeanContextChild
Классы JavaBeans, желающие быть вложенными и получить ссылку на свою среду выполнения или контекст, как определено подинтерфейсом BeanContext, должны реализовать этот интерфейс.
Соответствующие BeanContext в качестве побочного эффекта добавления объекта BeanContextChild должны передать ссылку на себя через метод setBeanContext() этого интерфейса.
Обратите внимание, что BeanContextChild может отклонить изменение состояния, бросив исключение PropertyVetoedException в ответ.
Для правильной работы механизмов сохранения для экземпляров BeanContextChild в широком диапазоне сценариев реализующие классы этого интерфейса должны определить как transient любые или все поля или переменные экземпляра, которые могут содержать или представлять ссылки на вложенный экземпляр BeanContext или другие ресурсы, полученные из BeanContext с помощью любых неопределённых механизмов.
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addPropertyChangeListener |
Добавляет
PropertyChangeListener в этот BeanContextChild, чтобы получать PropertyChangeEvent, когда указанное свойство изменится. |
void |
addVetoableChangeListener |
Добавляет
VetoableChangeListener в этот BeanContextChild, чтобы получать события, когда указанное свойство изменится. |
BeanContext |
getBeanContext() |
Получает
BeanContext связанный с этим BeanContextChild. |
void |
removePropertyChangeListener |
Удаляет
PropertyChangeListener из этого BeanContextChild, чтобы он больше не получал PropertyChangeEvents, когда указанное свойство изменится. |
void |
removeVetoableChangeListener |
Удаляет
VetoableChangeListener из этого BeanContextChild, чтобы он больше не получал события, когда указанное свойство изменится. |
void |
setBeanContext |
Объекты, реализующие этот интерфейс, должны генерировать java.beans.PropertyChangeEvent с параметрами: propertyName "beanContext", oldValue (предыдущий вложенный
BeanContext экземпляр или null), newValue (текущий вложенный BeanContext экземпляр или null). |
Подробное описание методов
setBeanContext
void setBeanContext(BeanContext bc) throws PropertyVetoException
Объекты, реализующие этот интерфейс, должны генерировать java.beans.PropertyChangeEvent с параметрами: propertyName "beanContext", oldValue (предыдущий вложенный BeanContext экземпляр или null), newValue (текущий вложенный 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.
© 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/BeanContextChild.html