Класс BeanContextSupport

public class BeanContextSupport
extends BeanContextChildSupport
implements BeanContext, Serializable, PropertyChangeListener, VetoableChangeListener

Этот вспомогательный класс предоставляет реализацию интерфейса java.beans.beancontext.BeanContext.

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

Поля

children

protected transient HashMap children

все обращения к полю protected HashMap children должны быть синхронизированы на этом объекте.

bcmListeners

protected transient ArrayList bcmListeners

все обращения к полю protected ArrayList bcmListeners должны быть синхронизированы на этом объекте.

locale

protected Locale locale

Текущий язык (locale) этого BeanContext.

okToUseGui

protected boolean okToUseGui

Указывает, может ли данная инстанция отображать графический интерфейс (GUI).

designTime

protected boolean designTime

Указывает, находится ли данный объект в режиме проектирования.

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

BeanContextSupport

public BeanContextSupport(BeanContext peer,
                          Locale lcle,
                          boolean dTime,
                          boolean visible)

Создаёт экземпляр BeanContextSupport.

Параметры:

peer - Объект-виртуальный посредник (peer), для которого мы предоставляем реализацию, или null если этот объект является своим собственным посредником

lcle - Текущий язык (locale) для этого BeanContext. Если lcle равен null, по умолчанию используется язык (locale) для экземпляра BeanContext.

dTime - Начальное состояние: true если в режиме проектирования, false если в режиме выполнения.

visible - Начальная видимость.

См. также:

Locale.getDefault(), Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer,
                          Locale lcle,
                          boolean dtime)

Создаёт экземпляр с указанным языком (locale) и режимом проектирования.

Параметры:

peer - Объект-виртуальный посредник (peer), для которого мы предоставляем реализацию, или null если этот объект является своим собственным посредником

lcle - Текущий язык (locale) для этого BeanContext. Если lcle равен null, по умолчанию используется язык (locale) для экземпляра BeanContext.

dtime - Начальное состояние: true если в режиме проектирования, false если в режиме выполнения.

См. также:

Locale.getDefault(), Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer,
                          Locale lcle)

Создаёт экземпляр с указанным языком (locale).

Параметры:

peer - Объект-виртуальный посредник (peer) BeanContext, для которого мы предоставляем реализацию, или null если этот объект является своим собственным посредником

lcle - Текущий язык (locale) для этого BeanContext. Если lcle равен null, по умолчанию используется язык (locale) для экземпляра BeanContext.

См. также:

Locale.getDefault(), Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer)

Создаёт экземпляр с использованием языка (locale) по умолчанию.

Параметры:

peer - Объект-виртуальный посредник (peer), для которого мы предоставляем реализацию, или null если этот объект является своим собственным посредником

BeanContextSupport

public BeanContextSupport()

Создаёт экземпляр, который не является делегатом другого объекта.

Методы

getBeanContextPeer

public BeanContext getBeanContextPeer()

Возвращает экземпляр BeanContext, для которого этот объект предоставляет реализацию.

Возвращает:

экземпляр BeanContext

instantiateChild

public Object instantiateChild(String beanName)
                        throws IOException,
                               ClassNotFoundException

Определено в:

instantiateChild в интерфейсе BeanContext

Параметры:

beanName - имя объекта Bean, который необходимо создать в этом BeanContext

Возвращает:

новый объект

Исключения:

IOException - если при десериализации объекта произошла ошибка ввода-вывода

ClassNotFoundException - если класс, идентифицируемый параметром beanName, не найден

size

public int size()

Возвращает количество дочерних объектов, вложенных в этот BeanContext.

Определено в:

size в интерфейсе Collection

Возвращает:

количество дочерних объектов

isEmpty

public boolean isEmpty()

Указывает, пуст ли данный BeanContext. BeanContext считается пустым, если он содержит ноль дочерних вложенных объектов.

Определено в:

isEmpty в интерфейсе Collection

Возвращает:

true, если нет дочерних объектов

contains

public boolean contains(Object o)

Определяет, является ли указанный объект дочерним объектом данного BeanContext.

Определено в:

contains в интерфейсе Collection

Параметры:

o - объект

Возвращает:

true, если объект является дочерним

containsKey

public boolean containsKey(Object o)

Определяет, является ли указанный объект дочерним объектом данного BeanContext.

Параметры:

o - объект

Возвращает:

true, если объект является дочерним

iterator

public Iterator iterator()

Возвращает все объекты JavaBean или BeanContext, которые в данный момент вложены в этот BeanContext.

Определено в:

iterator в интерфейсе Iterable

Определено в:

iterator в интерфейсе Collection

Возвращает:

итератор по вложенным дочерним объектам

toArray

public Object[] toArray()

Возвращает все объекты JavaBean или BeanContext, которые в данный момент вложены в этот BeanContext.

Определено в:

toArray в интерфейсе Collection

Возвращает:

массив, содержащий все элементы в этом наборе

toArray

public Object[] toArray(Object[] arry)

Возвращает массив, содержащий все дочерние объекты этого BeanContext, которые соответствуют типам в массиве.

Определено в:

toArray в интерфейсе Collection

Параметры:

arry - массив типов объектов, представляющих интерес

Возвращает:

массив дочерних объектов

createBCSChild

protected BeanContextSupport.BCSChild createBCSChild(Object targetChild,
                                                     Object peer)

Параметры:

targetChild - дочерний объект, для которого необходимо создать Child

peer - виртуальный посредник (peer), если tragetChild и peer связаны реализацией BeanContextProxy. * @return Подкласс Child, специфичный для подкласса, без переопределения методов коллекции

add

public boolean add(Object targetChild)

Определено в:

add в интерфейсе Collection

Параметры:

targetChild - дочерние объекты для вложения в этот BeanContext

Возвращает:

true, если дочерний объект был успешно добавлен.

См. также:

validatePendingAdd(java.lang.Object)

remove

public boolean remove(Object targetChild)

Удаляет дочерний объект из этого BeanContext. Если дочерний объект не подходит для добавления, этот метод выбрасывает IllegalStateException.

Определено в:

remove в интерфейсе Collection

Параметры:

targetChild - дочерние объекты для удаления

Возвращает:

true если элемент был удалён в результате этого вызова

См. также:

validatePendingRemove(java.lang.Object)

remove

protected boolean remove(Object targetChild,
                         boolean callChildSetBC)

Внутренний метод удаления, используемый при удалении, вызванном непредвиденной setBeanContext или вызовом remove().

Параметры:

targetChild - удаляемый JavaBean, BeanContext или объект

callChildSetBC - используется для указания, нужно ли уведомить дочерний объект о том, что он больше не вложен в этот BeanContext.

Возвращает:

было ли этот элемент до этого удален

containsAll

public boolean containsAll(Collection c)

Проверяет, являются ли все объекты в указанном Collection дочерними объектами этого BeanContext.

Определено в:

containsAll в интерфейсе Collection

Параметры:

c - указанный Collection

Возвращает:

true если все объекты в наборе являются дочерними объектами этого BeanContext, иначе false.

См. также:

Collection.contains(Object)

addAll

public boolean addAll(Collection c)

Добавление набора в набор дочерних элементов (не поддерживается). Реализации должны быть синхронизированы на блокировке иерархии и защищенном поле «children».

Определено в:

addAll в интерфейсе Collection

Параметры:

c - коллекция, содержащая элементы, которые нужно добавить в эту коллекцию

Возвращает:

этот объект без условий выбрасывает UnsupportedOperationException

Исключения:

UnsupportedOperationException - выбрасывается без условий этим объектом

См. также:

Collection.add(Object)

removeAll

public boolean removeAll(Collection c)

удаляет все указанные дочерние элементы (не поддерживается) реализации должны быть синхронизированы на блокировке иерархии и защищенном поле «children»

Определено в:

removeAll в интерфейсе Collection

Параметры:

c - коллекция, содержащая элементы, которые нужно удалить из этой коллекции

Возвращает:

эта реализация без условий выбрасывает UnsupportedOperationException

Исключения:

UnsupportedOperationException - выбрасывается без условий этой реализацией

См. также:

Collection.remove(Object), Collection.contains(Object)

retainAll

public boolean retainAll(Collection c)

сохраняет только указанные дочерние элементы (не поддерживается) реализации должны быть синхронизированы на блокировке иерархии и защищенном поле «children»

Определено в:

retainAll в интерфейсе Collection

Параметры:

c - коллекция, содержащая элементы, которые нужно сохранить в этой коллекции

Возвращает:

эта реализация без условий выбрасывает UnsupportedOperationException

Исключения:

UnsupportedOperationException - выбрасывается без условий этой реализацией

См. также:

Collection.remove(Object), Collection.contains(Object)

clear

public void clear()

очищает дочерние элементы (не поддерживается) реализации должны быть синхронизированы на блокировке иерархии и защищенном поле «children»

Определено в:

clear в интерфейсе Collection

Исключения:

UnsupportedOperationException - выбрасывается без условий этой реализацией

addBeanContextMembershipListener

public void addBeanContextMembershipListener(BeanContextMembershipListener bcml)

Добавляет BeanContextMembershipListener

Определено в:

addBeanContextMembershipListener в интерфейсе BeanContext

Параметры:

bcml - добавляемый BeanContextMembershipListener

Исключения:

NullPointerException - если аргумент равен null

removeBeanContextMembershipListener

public void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)

Удаляет BeanContextMembershipListener

Определено в:

removeBeanContextMembershipListener в интерфейсе BeanContext

Параметры:

bcml - удаляемый BeanContextMembershipListener

Исключения:

NullPointerException - если аргумент равен null

getResourceAsStream

public InputStream getResourceAsStream(String name,
                                       BeanContextChild bcc)

Описание скопировано из интерфейса: BeanContext

Аналогично java.lang.ClassLoader.getResourceAsStream(), этот метод позволяет реализации BeanContext вставить поведение между дочерним элементом Component и базовым ClassLoader.

Определено в:

getResourceAsStream в интерфейсе BeanContext

Параметры:

name - имя запрашиваемого ресурса.

bcc - объект дочернего элемента, делающий запрос.

Возвращает:

запрашиваемый ресурс в виде потока InputStream

Исключения:

NullPointerException - если аргумент равен null

getResource

public URL getResource(String name,
                       BeanContextChild bcc)

Описание скопировано из интерфейса: BeanContext

Аналогично java.lang.ClassLoader.getResource(), этот метод позволяет реализации BeanContext вставить поведение между дочерним элементом Component и базовым ClassLoader.

Определено в:

getResource в интерфейсе BeanContext

Параметры:

name - имя запрашиваемого ресурса.

bcc - объект дочернего элемента, делающий запрос.

Возвращает:

запрашиваемый ресурс в виде потока InputStream

setDesignTime

public void setDesignTime(boolean dTime)

Устанавливает новое значение design time для этого BeanContext.

Определено в:

setDesignTime в интерфейсе DesignMode

Параметры:

dTime - новое значение designTime

См. также:

BeanContext, BeanContextMembershipListener, PropertyChangeEvent

isDesignTime

public boolean isDesignTime()

Указывает, находится ли этот объект в режиме разработки.

Определено в:

isDesignTime в интерфейсе DesignMode

Возвращает:

true если в режиме разработки, false если нет

setLocale

public void setLocale(Locale newLocale)
               throws PropertyVetoException

Устанавливает локаль для этого BeanContext.

Параметры:

newLocale - новая локаль. Этот вызов метода не будет иметь эффекта, если newLocale равен null.

Исключения:

PropertyVetoException - если новое значение отклонено

getLocale

public Locale getLocale()

Возвращает локаль для этого BeanContext.

Возвращает:

текущая локаль BeanContext

needsGui

public boolean needsGui()

Определено в:

needsGui в интерфейсе Visibility

Возвращает:

true если реализатору нужен GUI

dontUseGui

public void dontUseGui()

уведомляет этот экземпляр о том, что он больше не может отображать GUI.

Определено в:

dontUseGui в интерфейсе Visibility

okToUseGui

public void okToUseGui()

Уведомляет этот экземпляр о том, что он теперь может отображать GUI

Определено в:

okToUseGui в интерфейсе Visibility

avoidingGui

public boolean avoidingGui()

Используется для определения, избегает ли дочерний элемент BeanContext использования своего GUI.

Определено в:

avoidingGui в интерфейсе Visibility

Возвращает:

избегает ли этот экземпляр использования своего GUI?

См. также:

Visibility

isSerializing

public boolean isSerializing()

Является ли этот BeanContext в процессе сериализации?

Возвращает:

если этот BeanContext в настоящее время сериализуется

bcsChildren

protected Iterator bcsChildren()

Возвращает итератор всех дочерних элементов этого BeanContext.

Возвращает:

итератор всех текущих значений BCSChild

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos)
                                throws IOException

вызывается методом writeObject после defaultWriteObject(), но до сериализации текущих сериализуемых дочерних элементов. Этот метод может быть переопределен подклассами для выполнения пользовательской сериализации состояния перед сериализацией дочерних элементов этим суперклассом. Этот метод, однако, не должен использоваться подклассами для замены собственной реализации (если таковая имеется) writeObject().

Параметры:

oos - ObjectOutputStream для использования во время сериализации

Исключения:

IOException - если сериализация не удалась

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

вызывается методом readObject после defaultReadObject(), но до десериализации любых дочерних элементов. Этот метод может быть переопределен подклассами для выполнения пользовательской десериализации состояния перед десериализацией дочерних элементов этим суперклассом. Этот метод, однако, не должен использоваться подклассами для замены собственной реализации (если таковая имеется) readObject().

Параметры:

ois - ObjectInputStream для использования во время десериализации

Исключения:

IOException - если десериализация не удалась

ClassNotFoundException - если необходимые классы не найдены

childDeserializedHook

protected void childDeserializedHook(Object child,
                                     BeanContextSupport.BCSChild bcsc)

Вызывается методом readObject с недавно десериализованным дочерним элементом и BCSChild.

Параметры:

child - недавно десериализованный дочерний элемент

bcsc - недавно десериализованный BCSChild

serialize

protected final void serialize(ObjectOutputStream oos,
                               Collection coll)
                        throws IOException

Используется методом writeObject для сериализации коллекции.

Параметры:

oos - ObjectOutputStream для использования во время сериализации

coll - Collection для сериализации

Исключения:

IOException - если сериализация не удалась

deserialize

protected final void deserialize(ObjectInputStream ois,
                                 Collection coll)
                          throws IOException,
                                 ClassNotFoundException

используется методом readObject для десериализации коллекции.

Параметры:

ois - ObjectInputStream для использования

coll - коллекция

Исключения:

IOException - если десериализация не удалась

ClassNotFoundException - если необходимые классы не найдены

writeChildren

public final void writeChildren(ObjectOutputStream oos)
                         throws IOException

Используется для сериализации всех дочерних элементов этого BeanContext.

Параметры:

oos - используемый ObjectOutputStream при сериализации

Исключения:

IOException - если сериализация не удалась

readChildren

public final void readChildren(ObjectInputStream ois)
                        throws IOException,
                               ClassNotFoundException

Когда экземпляр этого класса используется в качестве делегата для реализации протоколов BeanContext (и его подпротоколов), при десериализации возникает проблема «курица и яйцо»

Параметры:

ois - используемый ObjectInputStream

Исключения:

IOException - если десериализация не удалась

ClassNotFoundException - если необходимые классы не найдены

vetoableChange

public void vetoableChange(PropertyChangeEvent pce)
                    throws PropertyVetoException

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

Определено в:

vetoableChange в интерфейсе VetoableChangeListener

Параметры:

pce - объект PropertyChangeEvent, описывающий источник события и свойство, которое изменилось.

Исключения:

PropertyVetoException - если получатель хочет отменить изменение свойства.

propertyChange

public void propertyChange(PropertyChangeEvent pce)

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

Определено в:

propertyChange в интерфейсе PropertyChangeListener

Параметры:

pce - Объект PropertyChangeEvent, описывающий источник события и свойство, которое изменилось.

validatePendingAdd

protected boolean validatePendingAdd(Object targetChild)

Параметры:

targetChild - дочерний элемент, для которого создается Child

Возвращает:

true, если дочерний элемент может быть добавлен в этот BeanContext, иначе false.

validatePendingRemove

protected boolean validatePendingRemove(Object targetChild)

Параметры:

targetChild - дочерний элемент, для которого создается Child

Возвращает:

true, если дочерний элемент может быть удален из этого BeanContext, иначе false.

childJustAddedHook

protected void childJustAddedHook(Object child,
                                  BeanContextSupport.BCSChild bcsc)

подклассы могут переопределить этот метод, чтобы просто расширить семантику add() после добавления дочернего элемента и перед уведомлением о событии. Метод вызывается с синхронизированным дочерним элементом.

Параметры:

child - дочерний элемент

bcsc - BCSChild

childJustRemovedHook

protected void childJustRemovedHook(Object child,
                                    BeanContextSupport.BCSChild bcsc)

подклассы могут переопределить этот метод, чтобы просто расширить семантику remove() после удаления дочернего элемента и перед уведомлением о событии. Метод вызывается с синхронизированным дочерним элементом.

Параметры:

child - дочерний элемент

bcsc - BCSChild

getChildVisibility

protected static final Visibility getChildVisibility(Object child)

Получает компонент (если есть), связанный с указанным дочерним элементом.

Параметры:

child - указанный дочерний элемент

Возвращает:

Компонент (если есть), связанный с указанным дочерним элементом.

getChildSerializable

protected static final Serializable getChildSerializable(Object child)

Получает Serializable (если есть), связанный с указанным дочерним элементом.

Параметры:

child - указанный дочерний элемент

Возвращает:

Serializable (если есть), связанный с указанным дочерним элементом

getChildPropertyChangeListener

protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)

Получает PropertyChangeListener (если есть) указанного дочернего элемента

Параметры:

child - указанный дочерний элемент

Возвращает:

PropertyChangeListener (если есть) указанного дочернего элемента

getChildVetoableChangeListener

protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)

Получает VetoableChangeListener (если есть) указанного дочернего элемента

Параметры:

child - указанный дочерний элемент

Возвращает:

VetoableChangeListener (если есть) указанного дочернего элемента

getChildBeanContextMembershipListener

protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)

Получает BeanContextMembershipListener (если есть) указанного дочернего элемента

Параметры:

child - указанный дочерний элемент

Возвращает:

BeanContextMembershipListener (если есть) указанного дочернего элемента

getChildBeanContextChild

protected static final BeanContextChild getChildBeanContextChild(Object child)

Получает BeanContextChild (если есть) указанного дочернего элемента

Параметры:

child - указанный дочерний элемент

Возвращает:

BeanContextChild (если есть) указанного дочернего элемента

Исключения:

IllegalArgumentException - если дочерний элемент реализует как BeanContextChild, так и BeanContextProxy

fireChildrenAdded

protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)

Отправка события BeanContextshipEvent для интерфейса BeanContextMembershipListener

Параметры:

bcme - событие для отправки

fireChildrenRemoved

protected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)

Отправка события BeanContextshipEvent для интерфейса BeanContextMembershipListener

Параметры:

bcme - событие для отправки

initialize

protected void initialize()

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

copyChildren

protected final Object[] copyChildren()

Получает копию дочерних элементов этого BeanContext.

Возвращает:

копию текущих вложенных дочерних элементов

classEquals

protected static final boolean classEquals(Class first,
                                           Class second)

Проверяет, равны ли два объекта класса или их имена.

Параметры:

first - первый объект

second - второй объект

Возвращает:

true, если равны, иначе false