Класс BeanContextChildSupport

public class BeanContextChildSupport
extends Object
implements BeanContextChild, BeanContextServicesListener, Serializable

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

Поля

beanContextChildPeer

public BeanContextChild beanContextChildPeer

Вложенная 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

Параметры:

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.