Spec-Zone.ru › OpenJDK 25

Класс BeanContextSupport

java.lang.Object
java.beans.beancontext.BeanContextChildSupport
java.beans.beancontext.BeanContextSupport
Все реализованные интерфейсы:
BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, DesignMode, PropertyChangeListener, VetoableChangeListener, Visibility, Serializable, Iterable, Collection, EventListener
Прямые известные подклассы:
BeanContextServicesSupport
@Deprecated(since="23", forRemoval=true) public class BeanContextSupport extends BeanContextChildSupport implements BeanContext, Serializable, PropertyChangeListener, VetoableChangeListener
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Этот вспомогательный класс предоставляет служебную реализацию интерфейса java.beans.beancontext.BeanContext.

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

Начиная с версии:
1.2
См. также:
  • Сериализованная форма

Краткое описание вложенных классов

Модификатор и тип Класс Описание
protected class  BeanContextSupport.BCSChild
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Защищенный вложенный класс, содержащий сведения об отдельных дочерних элементах в хеш-таблице children.
protected static final class  BeanContextSupport.BCSIterator
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Защищенный подкласс final, инкапсулирующий итератор, но реализующий метод remove() без выполнения операций.

Краткое описание полей

Модификатор и тип Поле Описание
protected ArrayList<BeanContextMembershipListener> bcmListeners
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Все обращения к полю protected ArrayList bcmListeners должны синхронизироваться по этому объекту.
protected HashMap<Object, BeanContextSupport.BCSChild> children
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Все обращения к полю protected HashMap children должны синхронизироваться по этому объекту.
protected boolean designTime
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Значение boolean, указывающее, находится ли этот объект в данный момент в режиме проектирования.
protected Locale locale
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Текущая локаль этого BeanContext.
protected boolean okToUseGui
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Значение boolean, указывающее, может ли этот экземпляр теперь отображать графический интерфейс.

Поля, объявленные в классе BeanContextChildSupport

beanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport

Поля, объявленные в интерфейсе BeanContext

globalHierarchyLock

Поля, объявленные в интерфейсе DesignMode

PROPERTYNAME

Краткое описание конструкторов

Конструктор Описание
BeanContextSupport()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Создает экземпляр, не являющийся делегатом другого объекта
BeanContextSupport(BeanContext peer)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Создает экземпляр с локалью по умолчанию
BeanContextSupport(BeanContext peer, Locale lcle)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Создает экземпляр с указанной локалью
BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Создает экземпляр с указанной локалью и режимом проектирования.
BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Создает экземпляр BeanContextSupport

Краткое описание методов

Модификатор и тип Метод Описание
boolean add(Object targetChild)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Добавляет или вкладывает дочерний элемент в этот BeanContext.
boolean addAll(Collection c)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Добавляет Collection в набор дочерних элементов (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищенному полю "children".
void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Добавляет BeanContextMembershipListener
boolean avoidingGui()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Используется для определения того, не использует ли дочерний элемент BeanContext свой графический интерфейс.
protected Iterator<BeanContextSupport.BCSChild> bcsChildren()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает итератор по всем дочерним элементам этого BeanContext.
protected void bcsPreDeserializationHook(ObjectInputStream ois)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Вызывается методом readObject после defaultReadObject(), но до десериализации любых дочерних элементов.
protected void bcsPreSerializationHook(ObjectOutputStream oos)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Вызывается методом writeObject после defaultWriteObject(), но до сериализации дочерних элементов, которые в данный момент можно сериализовать.
protected void childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Вызывается методом readObject с только что десериализованными дочерним элементом и BCSChild.
protected void childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы могут переопределить этот метод, чтобы расширить семантику add() после добавления дочернего элемента и до отправки уведомления о событии.
protected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы могут переопределить этот метод, чтобы расширить семантику remove() после удаления дочернего элемента и до отправки уведомления о событии.
protected static final boolean classEquals(Class<?> first, Class<?> second)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Проверяет, равны ли два объекта Class или их имена.
void clear()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Очищает список дочерних элементов (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищенному полю "children".
boolean contains(Object o)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Определяет, является ли указанный объект в данный момент дочерним элементом этого BeanContext.
boolean containsAll(Collection c)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Проверяет, являются ли все объекты в указанном Collection дочерними элементами этого BeanContext.
boolean containsKey(Object o)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Определяет, является ли указанный объект в данный момент дочерним элементом этого BeanContext.
protected final Object[] copyChildren()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает копию дочерних элементов этого BeanContext.
protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы могут переопределить этот метод, чтобы использовать собственный подкласс Child, не переопределяя add() или другие методы Collection, добавляющие дочерние элементы в набор.
protected final void deserialize(ObjectInputStream ois, Collection coll)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Используется методом readObject для десериализации коллекции.
void dontUseGui()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Уведомляет этот экземпляр о том, что он больше не может отображать графический интерфейс.
protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Отправляет BeanContextMembershipEvent через интерфейс BeanContextMembershipListener
protected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Отправляет BeanContextMembershipEvent через интерфейс BeanContextMembershipListener
BeanContext getBeanContextPeer()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает экземпляр BeanContext, реализацию которого предоставляет этот объект.
protected static final BeanContextChild getChildBeanContextChild(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает BeanContextChild (если есть) указанного дочернего элемента
protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает BeanContextMembershipListener (если есть) указанного дочернего элемента
protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает PropertyChangeListener (если есть) указанного дочернего элемента
protected static final Serializable getChildSerializable(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает Serializable (если есть), связанный с указанным дочерним элементом
protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает VetoableChangeListener (если есть) указанного дочернего элемента
protected static final Visibility getChildVisibility(Object child)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает Component (если есть), связанный с указанным дочерним элементом.
Locale getLocale()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает локаль для этого BeanContext.
URL getResource(String name, BeanContextChild bcc)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подобно java.lang.ClassLoader.getResource(), этот метод позволяет реализации BeanContext внедрять свое поведение между дочерним Component и нижележащим ClassLoader.
InputStream getResourceAsStream(String name, BeanContextChild bcc)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подобно java.lang.ClassLoader.getResourceAsStream(), этот метод позволяет реализации BeanContext внедрять свое поведение между дочерним Component и нижележащим ClassLoader.
protected void initialize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Защищенный метод, вызываемый конструктором и readObject для инициализации временного состояния экземпляра BeanContextSupport.
Object instantiateChild(String beanName)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Метод instantiateChild — это вспомогательный хук в BeanContext, упрощающий задачу создания вложенного компонента Bean в BeanContext.
boolean isDesignTime()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Сообщает, находится ли этот объект в данный момент в режиме проектирования.
boolean isEmpty()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Сообщает, является ли этот BeanContext пустым.
boolean isSerializing()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Выполняется ли сериализация этого BeanContext?
Iterator<Object> iterator()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает все экземпляры JavaBean или BeanContext, вложенные в данный момент в этот BeanContext.
boolean needsGui()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Обычно этот метод вызывается средой, чтобы определить, «нужен» ли реализующему его объекту графический интерфейс.
void okToUseGui()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Уведомляет этот экземпляр о том, что теперь он может отображать графический интерфейс
void propertyChange(PropertyChangeEvent pce)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы могут обернуть этот метод для отслеживания изменений свойств дочерних элементов.
final void readChildren(ObjectInputStream ois)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Когда экземпляр этого класса используется в качестве делегата для реализации протоколов BeanContext (и их подпротоколов), при десериализации возникает проблема «курицы и яйца»
boolean remove(Object targetChild)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Удаляет дочерний элемент из этого BeanContext.
protected boolean remove(Object targetChild, boolean callChildSetBC)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Внутреннее удаление, используемое, когда удаление вызвано неожиданным setBeanContext или вызовом remove().
boolean removeAll(Collection c)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Удаляет все указанные дочерние элементы (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищенному полю "children".
void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Удаляет BeanContextMembershipListener
boolean retainAll(Collection c)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Оставляет только указанные дочерние элементы (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищенному полю "children".
protected final void serialize(ObjectOutputStream oos, Collection<?> coll)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Используется методом writeObject для сериализации Collection.
void setDesignTime(boolean dTime)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Устанавливает новое значение режима проектирования для этого BeanContext.
void setLocale(Locale newLocale)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Устанавливает локаль этого BeanContext.
int size()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает количество дочерних элементов, в данный момент вложенных в этот BeanContext.
Object[] toArray()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает все экземпляры JavaBean или BeanContext, вложенные в данный момент в этот BeanContext.
Object[] toArray(Object[] arry)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Возвращает массив, содержащий все дочерние элементы этого BeanContext, типы которых соответствуют типам, содержащимся в arry.
protected boolean validatePendingAdd(Object targetChild)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы этого класса могут переопределить или обернуть этот метод, чтобы добавить проверку дочерних объектов для BeanContext непосредственно перед их добавлением в BeanContext.
protected boolean validatePendingRemove(Object targetChild)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы этого класса могут переопределить или обернуть этот метод, чтобы добавить проверку дочерних объектов для BeanContext непосредственно перед их удалением из BeanContext.
void vetoableChange(PropertyChangeEvent pce)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Подклассы могут обернуть этот метод для отслеживания отклоненных изменений свойств дочерних элементов.
final void writeChildren(ObjectOutputStream oos)
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Используется для сериализации всех дочерних элементов этого BeanContext.

Методы, объявленные в классе BeanContextChildSupport

addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, initializeBeanContextResources, isDelegated, releaseBeanContextResources, removePropertyChangeListener, removeVetoableChangeListener, serviceAvailable, serviceRevoked, setBeanContext, validatePendingSetBeanContext

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе BeanContextChild

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

Методы, объявленные в интерфейсе Collection

equals, hashCode, parallelStream, removeIf, spliterator, stream, toArray

Методы, объявленные в интерфейсе Iterable

forEach

Подробное описание полей

children

protected transient HashMap<Object, BeanContextSupport.BCSChild> children
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
все обращения к полю protected HashMap children должны синхронизироваться по этому объекту.

bcmListeners

protected transient ArrayList<BeanContextMembershipListener> bcmListeners
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
все обращения к полю protected ArrayList bcmListeners должны синхронизироваться по этому объекту.

locale

protected Locale locale
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Текущая локаль этого BeanContext.

okToUseGui

protected boolean okToUseGui
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
boolean, указывающий, может ли этот экземпляр теперь отображать графический интерфейс.

designTime

protected boolean designTime
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
boolean, указывающий, находится ли этот объект в настоящее время в режиме проектирования.

Подробное описание конструкторов

BeanContextSupport

public BeanContextSupport(BeanContext peer, Locale lcle, boolean dTime, boolean visible)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Создаёт экземпляр BeanContextSupport
Параметры:
peer — узел-партнёр BeanContext, для которого мы предоставляем реализацию, или null, если этот объект является собственным узлом-партнёром
lcle — текущая локаль для этого BeanContext. Если lcle равно null, экземпляру BeanContext назначается локаль по умолчанию.
dTime — начальное состояние: true, если включён режим проектирования, false — если выполняется среда выполнения.
visible — начальная видимость.
См. также:
  • Locale.getDefault()
  • Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer, Locale lcle, boolean dtime)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Создаёт экземпляр с указанной локалью и режимом проектирования.
Параметры:
peer — узел-партнёр BeanContext, для которого мы предоставляем реализацию, или null, если этот объект является собственным узлом-партнёром
lcle — текущая локаль для этого BeanContext. Если lcle равно null, экземпляру BeanContext назначается локаль по умолчанию.
dtime — начальное состояние: true, если включён режим проектирования, false — если выполняется среда выполнения.
См. также:
  • Locale.getDefault()
  • Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer, Locale lcle)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Создаёт экземпляр с указанной локалью
Параметры:
peer — узел-партнёр BeanContext, для которого мы предоставляем реализацию, или null, если этот объект является собственным узлом-партнёром
lcle — текущая локаль для этого BeanContext. Если lcle равно null, экземпляру BeanContext назначается локаль по умолчанию.
См. также:
  • Locale.getDefault()
  • Locale.setDefault(java.util.Locale)

BeanContextSupport

public BeanContextSupport(BeanContext peer)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Создаёт экземпляр с локалью по умолчанию
Параметры:
peer — узел-партнёр BeanContext, для которого мы предоставляем реализацию, или null, если этот объект является собственным узлом-партнёром

BeanContextSupport

public BeanContextSupport()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Создаёт экземпляр, не являющийся делегатом другого объекта

Подробное описание методов

getBeanContextPeer

public BeanContext getBeanContextPeer()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает экземпляр BeanContext, для которого этот объект предоставляет реализацию.
Возвращает:
экземпляр BeanContext

instantiateChild

public Object instantiateChild(String beanName) throws IOException, ClassNotFoundException
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.

Метод instantiateChild — это удобный метод-перехватчик в BeanContext, упрощающий создание вложенного JavaBean в BeanContext.

Семантика параметра beanName определяется методом java.beans.Beans.instantiate.

Определён в:
instantiateChild в интерфейсе BeanContext
Параметры:
beanName — имя JavaBean, который требуется создать в этом BeanContext
Возвращает:
новый объект
Исключения:
IOException — если при десериализации bean произошла ошибка ввода-вывода
ClassNotFoundException — если класс, указанный параметром beanName, не найден

size

public int size()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает количество дочерних объектов, вложенных в данный BeanContext в настоящий момент.
Определён в:
size в интерфейсе Collection
Возвращает:
количество дочерних объектов

isEmpty

public boolean isEmpty()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Проверяет, является ли этот BeanContext пустым. BeanContext считается пустым, если в нём нет вложенных дочерних объектов.
Определён в:
isEmpty в интерфейсе Collection
Возвращает:
true, если дочерних объектов нет; в противном случае — false

contains

public boolean contains(Object o)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Определяет, является ли указанный объект в настоящий момент дочерним объектом этого BeanContext.
Определён в:
contains в интерфейсе Collection
Параметры:
o — проверяемый объект
Возвращает:
true, если этот объект является дочерним; в противном случае — false

containsKey

public boolean containsKey(Object o)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Определяет, является ли указанный объект в настоящий момент дочерним объектом этого BeanContext.
Параметры:
o — проверяемый объект
Возвращает:
true, если этот объект является дочерним; в противном случае — false

iterator

public Iterator<Object> iterator()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает все экземпляры JavaBean или BeanContext, вложенные в данный BeanContext в настоящий момент.
Определён в:
iterator в интерфейсе Collection
Определён в:
iterator в интерфейсе Iterable
Возвращает:
Iterator вложенных дочерних объектов

toArray

public Object[] toArray()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает все экземпляры JavaBean или BeanContext, вложенные в данный BeanContext в настоящий момент.
Определён в:
toArray в интерфейсе Collection
Возвращает:
массив, тип компонентов времени выполнения которого — Object; массив содержит все элементы этой коллекции

toArray

public Object[] toArray(Object[] arry)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает массив, содержащий все дочерние объекты этого BeanContext, типы которых соответствуют типам, содержащимся в arry.
Определён в:
toArray в интерфейсе Collection
Параметры:
arry — массив интересующих типов объектов.
Возвращает:
массив дочерних объектов

createBCSChild

protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.

Подклассы могут переопределить этот метод, чтобы создать собственный подкласс Child, не переопределяя add() или другие методы Collection, добавляющие дочерние объекты в набор.

Параметры:
targetChild — дочерний объект, от имени которого создаётся Child
peer — узел-партнёр, если targetChild и узел-партнёр связаны реализацией BeanContextProxy
Возвращает:
подкласс Child, специфичный для данного подтипа, без переопределения методов коллекции

add

public boolean add(Object targetChild)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Добавляет/вкладывает дочерний объект в этот BeanContext.

Вызывается как побочный эффект java.beans.Beans.instantiate(). Если дочерний объект нельзя добавить, этот метод выбрасывает IllegalStateException.

Определён в:
add в интерфейсе Collection
Параметры:
targetChild — дочерний объект, который нужно вложить в этот BeanContext
Возвращает:
true, если дочерний объект успешно добавлен.
См. также:
  • validatePendingAdd(Object)

remove

public boolean remove(Object targetChild)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Удаляет дочерний объект из этого BeanContext. Если дочерний объект нельзя добавить, этот метод выбрасывает IllegalStateException.
Определён в:
remove в интерфейсе Collection
Параметры:
targetChild — дочерний объект, который нужно удалить
Возвращает:
true, если в результате вызова был удалён элемент
См. также:
  • validatePendingRemove(Object)

remove

protected boolean remove(Object targetChild, boolean callChildSetBC)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
внутреннее удаление, используемое, когда удаление вызвано неожиданным setBeanContext или вызовом remove().
Параметры:
targetChild — JavaBean, BeanContext или Object, который требуется удалить
callChildSetBC — указывает, следует ли уведомить дочерний объект о том, что он больше не вложен в этот BeanContext.
Возвращает:
был ли объект добавлен до удаления

containsAll

public boolean containsAll(Collection c)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Проверяет, являются ли все объекты из указанной Collection дочерними объектами этого BeanContext.
Определён в:
containsAll в интерфейсе Collection
Параметры:
c — указанная Collection
Возвращает:
true, если все объекты коллекции являются дочерними объектами этого BeanContext; в противном случае — false.
См. также:
  • Collection.contains(Object)

addAll

public boolean addAll(Collection c)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
добавляет коллекцию в набор дочерних объектов (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищённому полю "children"
Определён в:
addAll в интерфейсе Collection
Параметры:
c — коллекция, содержащая элементы для добавления в эту коллекцию
Возвращает:
эта реализация всегда выбрасывает UnsupportedOperationException
Исключения:
UnsupportedOperationException — всегда выбрасывается этой реализацией
См. также:
  • Collection.add(Object)

removeAll

public boolean removeAll(Collection c)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
удаляет все указанные дочерние объекты (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищённому полю "children"
Определён в:
removeAll в интерфейсе Collection
Параметры:
c — коллекция, содержащая элементы для удаления из этой коллекции
Возвращает:
эта реализация всегда выбрасывает UnsupportedOperationException
Исключения:
UnsupportedOperationException — всегда выбрасывается этой реализацией
См. также:
  • Collection.remove(Object)
  • Collection.contains(Object)

retainAll

public boolean retainAll(Collection c)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
оставляет только указанные дочерние объекты (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищённому полю "children"
Определён в:
retainAll в интерфейсе Collection
Параметры:
c — коллекция, содержащая элементы, которые нужно сохранить в этой коллекции
Возвращает:
эта реализация всегда выбрасывает UnsupportedOperationException
Исключения:
UnsupportedOperationException — всегда выбрасывается этой реализацией
См. также:
  • Collection.remove(Object)
  • Collection.contains(Object)

clear

public void clear()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
очищает список дочерних объектов (не поддерживается); реализации должны синхронизироваться по блокировке иерархии и защищённому полю "children"
Определён в:
clear в интерфейсе Collection
Исключения:
UnsupportedOperationException — всегда выбрасывается этой реализацией

addBeanContextMembershipListener

public void addBeanContextMembershipListener(BeanContextMembershipListener bcml)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Добавляет BeanContextMembershipListener
Определён в:
addBeanContextMembershipListener в интерфейсе BeanContext
Параметры:
bcml — BeanContextMembershipListener, который нужно добавить
Исключения:
NullPointerException — если аргумент равен null

removeBeanContextMembershipListener

public void removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Удаляет BeanContextMembershipListener
Определён в:
removeBeanContextMembershipListener в интерфейсе BeanContext
Параметры:
bcml — BeanContextMembershipListener, который нужно удалить
Исключения:
NullPointerException — если аргумент равен null

getResourceAsStream

public InputStream getResourceAsStream(String name, BeanContextChild bcc)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Описание скопировано из интерфейса: BeanContext
Подобно java.lang.ClassLoader.getResourceAsStream(), этот метод позволяет реализации BeanContext перехватывать взаимодействие между дочерним объектом Component и базовым ClassLoader.
Определён в:
getResourceAsStream в интерфейсе BeanContext
Параметры:
name — имя запрашиваемого ресурса.
bcc — дочерний объект, выполняющий запрос.
Возвращает:
запрошенный ресурс в виде InputStream
Исключения:
NullPointerException — если аргумент равен null

getResource

public URL getResource(String name, BeanContextChild bcc)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Описание скопировано из интерфейса: BeanContext
Подобно java.lang.ClassLoader.getResource(), этот метод позволяет реализации BeanContext перехватывать взаимодействие между дочерним объектом Component и базовым ClassLoader.
Определён в:
getResource в интерфейсе BeanContext
Параметры:
name — имя запрашиваемого ресурса.
bcc — дочерний объект, выполняющий запрос.
Возвращает:
запрошенный ресурс в виде InputStream

setDesignTime

public void setDesignTime(boolean dTime)
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Устанавливает новое значение режима проектирования для этого BeanContext.
Определён в:
setDesignTime в интерфейсе DesignMode
Параметры:
dTime — новое значение designTime
См. также:
  • BeanContext
  • BeanContextMembershipListener
  • PropertyChangeEvent

isDesignTime

public boolean isDesignTime()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Проверяет, находится ли этот объект в настоящее время в режиме проектирования.
Определён в:
isDesignTime в интерфейсе DesignMode
Возвращает:
true, если включён режим проектирования; false — если нет

setLocale

public void setLocale(Locale newLocale) throws PropertyVetoException
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Задаёт локаль этого BeanContext.
Параметры:
newLocale — новая локаль. Этот вызов метода не даст эффекта, если newLocale равно null.
Исключения:
PropertyVetoException — если новое значение отклонено

getLocale

public Locale getLocale()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Возвращает локаль для этого BeanContext.
Возвращает:
текущая локаль BeanContext

needsGui

public boolean needsGui()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.

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

Используемый здесь алгоритм проверяет BeanContextPeer и его текущие дочерние объекты, определяя, являются ли они контейнерами или компонентами либо реализуют ли они Visibility и возвращают ли needsGui() == true.

Определён в:
needsGui в интерфейсе Visibility
Возвращает:
true, если реализации требуется графический интерфейс

dontUseGui

public void dontUseGui()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
уведомляет этот экземпляр о том, что он больше не может отображать графический интерфейс.
Определён в:
dontUseGui в интерфейсе Visibility

okToUseGui

public void okToUseGui()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Уведомляет этот экземпляр о том, что теперь он может отображать графический интерфейс
Определён в:
okToUseGui в интерфейсе Visibility

avoidingGui

public boolean avoidingGui()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Используется для определения того, избегает ли дочерний объект BeanContext использования своего графического интерфейса.
Определён в:
avoidingGui в интерфейсе Visibility
Возвращает:
избегает ли этот экземпляр использования своего графического интерфейса?
См. также:
  • Visibility

isSerializing

public boolean isSerializing()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Выполняется ли сериализация этого BeanContext?
Возвращает:
true, если этот BeanContext в данный момент сериализуется; в противном случае — false

bcsChildren

protected Iterator<BeanContextSupport.BCSChild> bcsChildren()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает итератор по всем потомкам этого BeanContext.
Возвращает:
итератор по всем текущим значениям BCSChild

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Вызывается методом writeObject после defaultWriteObject(), но до сериализации потомков, подлежащих сериализации. Подклассы могут переопределить этот метод для выполнения пользовательской сериализации своего состояния до того, как этот суперкласс сериализует потомков. Однако подклассам не следует использовать этот метод вместо собственной реализации (если она имеется) метода writeObject().
Параметры:
oos — ObjectOutputStream, используемый при сериализации
Выбрасывает:
IOException — если сериализация не удалась

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Вызывается методом readObject после defaultReadObject(), но до десериализации каких-либо потомков. Подклассы могут переопределить этот метод для выполнения пользовательской десериализации своего состояния до того, как этот суперкласс десериализует потомков. Однако подклассам не следует использовать этот метод вместо собственной реализации (если она имеется) метода readObject().
Параметры:
ois — ObjectInputStream, используемый при десериализации
Выбрасывает:
IOException — если десериализация не удалась
ClassNotFoundException — если необходимые классы не найдены

childDeserializedHook

protected void childDeserializedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Вызывается методом readObject с только что десериализованными потомком и BCSChild.
Параметры:
child — только что десериализованный потомок
bcsc — только что десериализованный BCSChild

serialize

protected final void serialize(ObjectOutputStream oos, Collection<?> coll) throws IOException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Используется методом writeObject для сериализации коллекции.
Параметры:
oos — ObjectOutputStream, используемый при сериализации
coll — Collection для сериализации
Выбрасывает:
IOException — если сериализация не удалась

deserialize

protected final void deserialize(ObjectInputStream ois, Collection coll) throws IOException, ClassNotFoundException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Используется методом readObject для десериализации коллекции.
Параметры:
ois — ObjectInputStream, который следует использовать
coll — Collection
Выбрасывает:
IOException — если десериализация не удалась
ClassNotFoundException — если необходимые классы не найдены

writeChildren

public final void writeChildren(ObjectOutputStream oos) throws IOException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Используется для сериализации всех потомков этого BeanContext.
Параметры:
oos — ObjectOutputStream, используемый при сериализации
Выбрасывает:
IOException — если сериализация не удалась

readChildren

public final void readChildren(ObjectInputStream ois) throws IOException, ClassNotFoundException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Если экземпляр этого класса используется в качестве делегата для реализации протоколов BeanContext (и их подпротоколов), при десериализации возникает проблема «курицы и яйца»
Параметры:
ois — ObjectInputStream, который следует использовать
Выбрасывает:
IOException — если десериализация не удалась
ClassNotFoundException — если необходимые классы не найдены

vetoableChange

public void vetoableChange(PropertyChangeEvent pce) throws PropertyVetoException
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Подклассы могут переопределить этот метод, чтобы отслеживать изменения свойств потомков, которые могут быть отменены.
Определён в:
vetoableChange в интерфейсе VetoableChangeListener
Параметры:
pce — объект PropertyChangeEvent, описывающий источник события и изменившееся свойство.
Выбрасывает:
PropertyVetoException — если получатель желает отменить изменение свойства.

propertyChange

public void propertyChange(PropertyChangeEvent pce)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Подклассы могут переопределить этот метод, чтобы отслеживать изменения свойств потомков.
Определён в:
propertyChange в интерфейсе PropertyChangeListener
Параметры:
pce — объект PropertyChangeEvent, описывающий источник события и изменившееся свойство.

validatePendingAdd

protected boolean validatePendingAdd(Object targetChild)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.

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

Параметры:
targetChild — потомок, от имени которого создаётся Child
Возвращает:
true, если потомка можно добавить в этот BeanContext; в противном случае — false.

validatePendingRemove

protected boolean validatePendingRemove(Object targetChild)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.

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

Параметры:
targetChild — потомок, от имени которого создаётся Child
Возвращает:
true, если потомка можно удалить из этого BeanContext; в противном случае — false.

childJustAddedHook

protected void childJustAddedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Подклассы могут переопределить этот метод, чтобы дополнить семантику add() после добавления потомка, но до отправки уведомления о событии. Метод вызывается при блокировке потомка.
Параметры:
child — потомок
bcsc — BCSChild

childJustRemovedHook

protected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Подклассы могут переопределить этот метод, чтобы дополнить семантику remove() после удаления потомка, но до отправки уведомления о событии. Метод вызывается при блокировке потомка.
Параметры:
child — потомок
bcsc — BCSChild

getChildVisibility

protected static final Visibility getChildVisibility(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает Component (если он есть), связанный с указанным потомком.
Параметры:
child — указанный потомок
Возвращает:
Component (если он есть), связанный с указанным потомком.

getChildSerializable

protected static final Serializable getChildSerializable(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает Serializable (если он есть), связанный с указанным Child
Параметры:
child — указанный потомок
Возвращает:
Serializable (если он есть), связанный с указанным Child

getChildPropertyChangeListener

protected static final PropertyChangeListener getChildPropertyChangeListener(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает PropertyChangeListener (если он есть) указанного потомка
Параметры:
child — указанный потомок
Возвращает:
PropertyChangeListener (если он есть) указанного потомка

getChildVetoableChangeListener

protected static final VetoableChangeListener getChildVetoableChangeListener(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает VetoableChangeListener (если он есть) указанного потомка
Параметры:
child — указанный потомок
Возвращает:
VetoableChangeListener (если он есть) указанного потомка

getChildBeanContextMembershipListener

protected static final BeanContextMembershipListener getChildBeanContextMembershipListener(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает BeanContextMembershipListener (если он есть) указанного потомка
Параметры:
child — указанный потомок
Возвращает:
BeanContextMembershipListener (если он есть) указанного потомка

getChildBeanContextChild

protected static final BeanContextChild getChildBeanContextChild(Object child)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает BeanContextChild (если он есть) указанного потомка
Параметры:
child — указанный потомок
Возвращает:
BeanContextChild (если он есть) указанного потомка
Выбрасывает:
IllegalArgumentException — если потомок реализует одновременно BeanContextChild и BeanContextProxy

fireChildrenAdded

protected final void fireChildrenAdded(BeanContextMembershipEvent bcme)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Отправляет событие BeanContextMembershipEvent слушателям интерфейса BeanContextMembershipListener
Параметры:
bcme — отправляемое событие

fireChildrenRemoved

protected final void fireChildrenRemoved(BeanContextMembershipEvent bcme)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Отправляет событие BeanContextMembershipEvent слушателям интерфейса BeanContextMembershipListener
Параметры:
bcme — отправляемое событие

initialize

protected void initialize()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Защищённый метод, вызываемый из конструктора и readObject для инициализации transient-состояния экземпляра BeanContextSupport. Этот класс использует данный метод для создания экземпляров внутренних классов-слушателей, отслеживающих события PropertyChange и VetoableChange у потомков. Подклассы могут обернуть этот метод, добавив собственную логику инициализации

copyChildren

protected final Object[] copyChildren()
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Возвращает копию потомков этого BeanContext.
Возвращает:
копию текущих вложенных потомков

classEquals

protected static final boolean classEquals(Class<?> first, Class<?> second)
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии.
Проверяет, равны ли два объекта Class или их имена.
Параметры:
first — первый объект
second — второй объект
Возвращает:
true, если объекты равны; иначе false

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.desktop/java/beans/beancontext/BeanContextSupport.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API