Класс BeanContextServicesSupport

Все реализованные интерфейсы:
BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServices, BeanContextServicesListener, DesignMode, PropertyChangeListener, VetoableChangeListener, Visibility, Serializable, Iterable, Collection, EventListener 
public class BeanContextServicesSupport
extends BeanContextSupport
implements BeanContextServices

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

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

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

Вложенные классы

Модификатор и тип Класс Описание
protected class  BeanContextServicesSupport.BCSSChild
protected class  BeanContextServicesSupport.BCSSProxyServiceProvider
protected static class  BeanContextServicesSupport.BCSSServiceProvider

Подклассы могут наследовать от этого вложенного класса для добавления поведения для каждого BeanContextServicesProvider.

Вложенные классы/интерфейсы, объявленные в классе java.beans.beancontext.BeanContextSupport

BeanContextSupport.BCSChild, BeanContextSupport.BCSIterator

Поля

Модификатор и тип Поле Описание
protected ArrayList<BeanContextServicesListener> bcsListeners

Список объектов BeanContextServicesListener.

protected BeanContextServicesSupport.BCSSProxyServiceProvider proxy

Делегат для BeanContextServiceProvider.

protected int serializable

Количество экземпляров сериализуемого BeanContextServceProvider.

protected HashMap<Object,​BeanContextServicesSupport.BCSSServiceProvider> services

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

Поля, объявленные в классе java.beans.beancontext.BeanContextSupport

bcmListeners, children, designTime, locale, okToUseGui

Поля, объявленные в классе java.beans.beancontext.BeanContextChildSupport

beanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport

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

globalHierarchyLock

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

PROPERTYNAME

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

Конструктор Описание
BeanContextServicesSupport()

Создать экземпляр, который не является делегатом другого объекта
BeanContextServicesSupport​(BeanContextServices peer)

Создать экземпляр с пэром
BeanContextServicesSupport​(BeanContextServices peer, Locale lcle)

Создать экземпляр, используя указанный локаль
BeanContextServicesSupport​(BeanContextServices peer, Locale lcle, boolean dtime)

Создать экземпляр, используя указанный локаль и режим проектирования.
BeanContextServicesSupport​(BeanContextServices peer, Locale lcle, boolean dTime, boolean visible)

Создать экземпляр BeanContextServicesSupport

Методы

Модификатор и тип Метод Описание
void addBeanContextServicesListener​(BeanContextServicesListener bcsl)

Добавить BeanContextServicesListener
boolean addService​(Class<?> serviceClass, BeanContextServiceProvider bcsp)

Добавить сервис
protected boolean addService​(Class<?> serviceClass, BeanContextServiceProvider bcsp, boolean fireEvent)

Добавить сервис
protected void bcsPreDeserializationHook​(ObjectInputStream ois)

Вызывается из BeanContextSupport readObject перед десериализацией дочерних элементов...
protected void bcsPreSerializationHook​(ObjectOutputStream oos)

Вызывается из BeanContextSupport writeObject перед сериализацией дочерних элементов...
protected void childJustRemovedHook​(Object child, BeanContextSupport.BCSChild bcsc)

Вызывается из операций удаления дочерних элементов в суперклассе после успешного удаления дочернего элемента. Вызывается с синхронизацией по дочернему элементу.
protected BeanContextSupport.BCSChild createBCSChild​(Object targetChild, Object peer)

Подклассы могут переопределить этот метод для вставки своего собственного подкласса Child без необходимости переопределять add() или другие методы Collection, добавляющие дочерние элементы в набор.
protected BeanContextServicesSupport.BCSSServiceProvider createBCSSServiceProvider​(Class<?> sc, BeanContextServiceProvider bcsp)

Подклассы могут переопределить этот метод для создания новых подклассов BCSSServiceProvider без необходимости переопределять addService() для создания экземпляра.
protected void fireServiceAdded​(BeanContextServiceAvailableEvent bcssae)

Вызывает событие BeanContextServiceAvailableEvent, указывающее на то, что новый сервис стал доступен.
protected void fireServiceAdded​(Class<?> serviceClass)

Вызывает событие BeanContextServiceEvent, уведомляющее о новом сервисе.
protected void fireServiceRevoked​(BeanContextServiceRevokedEvent bcsre)

Вызывает событие BeanContextServiceEvent, уведомляющее об отзыве сервиса.
protected void fireServiceRevoked​(Class<?> serviceClass, boolean revokeNow)

Вызывает событие BeanContextServiceRevokedEvent, указывающее на то, что конкретный сервис больше недоступен.
BeanContextServices getBeanContextServicesPeer()

Получает BeanContextServices, связанный с этим BeanContextServicesSupport.
protected static BeanContextServicesListener getChildBeanContextServicesListener​(Object child)

Получает BeanContextServicesListener (если есть) указанного дочернего элемента.
Iterator<Object> getCurrentServiceClasses()

Получает текущие доступные сервисы для этого контекста.
Iterator<?> getCurrentServiceSelectors​(Class<?> serviceClass)

Получает список параметров сервиса, зависящих от сервиса (селекторы сервиса), для указанного сервиса, вызывая getCurrentServiceSelectors() на базовом BeanContextServiceProvider.
Object getService​(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)

Получить сервис, который может быть делегирован.
boolean hasService​(Class<?> serviceClass)

Имеет сервис, который может быть делегирован.
void initialize()

Вызывается классом-суперклассом BeanContextSupport во время построения и десериализации для инициализации транзиентного состояния подкласса.
protected void initializeBeanContextResources()

Вызывается из setBeanContext для уведомления BeanContextChild о выделении ресурсов, полученных из вложенного BeanContext.
protected void releaseBeanContextResources()

Вызывается из setBeanContext для уведомления BeanContextChild об освобождении ресурсов, полученных из вложенного BeanContext.
void releaseService​(BeanContextChild child, Object requestor, Object service)

Освободить сервис.
void removeBeanContextServicesListener​(BeanContextServicesListener bcsl)

Удалить BeanContextServicesListener
void revokeService​(Class<?> serviceClass, BeanContextServiceProvider bcsp, boolean revokeCurrentServicesNow)

Удалить сервис
void serviceAvailable​(BeanContextServiceAvailableEvent bcssae)

Обратный вызов BeanContextServicesListener, передает событие всем текущим зарегистрированным слушателям и дочерним элементам BeanContextServices, если сам этот BeanContextService не реализует этот сервис.
void serviceRevoked​(BeanContextServiceRevokedEvent bcssre)

Обратный вызов BeanContextServicesListener, передает событие всем текущим зарегистрированным слушателям и дочерним элементам BeanContextServices, если сам этот BeanContextService не реализует этот сервис.

Методы, объявленные в классе java.beans.beancontext.BeanContextSupport

add, addAll, addBeanContextMembershipListener, avoidingGui, bcsChildren, childDeserializedHook, childJustAddedHook, classEquals, clear, contains, containsAll, containsKey, copyChildren, deserialize, dontUseGui, fireChildrenAdded, fireChildrenRemoved, getBeanContextPeer, getChildBeanContextChild, getChildBeanContextMembershipListener, getChildPropertyChangeListener, getChildSerializable, getChildVetoableChangeListener, getChildVisibility, getLocale, getResource, getResourceAsStream, instantiateChild, isDesignTime, isEmpty, isSerializing, iterator, needsGui, okToUseGui, propertyChange, readChildren, remove, remove, removeAll, removeBeanContextMembershipListener, retainAll, serialize, setDesignTime, setLocale, size, toArray, toArray, validatePendingAdd, validatePendingRemove, vetoableChange, writeChildren

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

addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, isDelegated, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext, validatePendingSetBeanContext

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

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

Методы, объявленные в интерфейсе java.beans.beancontext.BeanContext

addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener

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

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

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

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray

Методы, объявленные в интерфейсе java.beans.DesignMode

isDesignTime, setDesignTime

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

forEach

Методы, объявленные в интерфейсе java.beans.Visibility

avoidingGui, dontUseGui, needsGui, okToUseGui

Поля

services

protected transient HashMap<Object,BeanContextServicesSupport.BCSSServiceProvider> services

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

serializable

protected transient int serializable

Количество экземпляров сериализуемого BeanContextServceProvider.

proxy

protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy

Делегат для BeanContextServiceProvider.

bcsListeners

protected transient ArrayList<BeanContextServicesListener> bcsListeners

Список объектов BeanContextServicesListener.

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

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle,
                                  boolean dTime,
                                  boolean visible)

Создать экземпляр BeanContextServicesSupport.

Параметры:
peer - Внешний BeanContext, для которого мы предоставляем реализацию, если null, то этот объект является своим собственным внешним объектом.
lcle - Текущий язык для этого BeanContext.
dTime - Начальное состояние: true, если в режиме проектирования; false, если в режиме выполнения.
visible - Начальная видимость.

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle,
                                  boolean dtime)

Создать экземпляр, используя указанный язык и режим проектирования.

Параметры:
peer - Внешний BeanContext, для которого мы предоставляем реализацию, если null, то этот объект является своим собственным внешним объектом.
lcle - Текущий язык для этого BeanContext.
dtime - Начальное состояние: true, если в режиме проектирования; false, если в режиме выполнения.

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle)

Создать экземпляр, используя указанный язык.

Параметры:
peer - Внешний BeanContext, для которого мы предоставляем реализацию, если null, то этот объект является своим собственным внешним объектом.
lcle - Текущий язык для этого BeanContext.

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer)

Создать экземпляр с внешним объектом.

Параметры:
peer - Внешний BeanContext, для которого мы предоставляем реализацию, если null, то этот объект является своим собственным внешним объектом.

BeanContextServicesSupport

public BeanContextServicesSupport()

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

Методы

initialize

public void initialize()

вызывается суперклассом BeanContextSupport во время создания и десериализации для инициализации транзиентного состояния подкласса. подклассы могут оборачивать этот метод, но не должны его переопределять или вызывать напрямую.

Переопределяет:
initialize в классе BeanContextSupport

getBeanContextServicesPeer

public BeanContextServices getBeanContextServicesPeer()

Получает BeanContextServices , связанный с этим BeanContextServicesSupport.

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

createBCSChild

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

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

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

createBCSSServiceProvider

protected BeanContextServicesSupport.BCSSServiceProvider createBCSSServiceProvider(Class<?> sc,
                                                                                   BeanContextServiceProvider bcsp)

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

Параметры:
sc - класс
bcsp - поставщик сервиса
Возвращает:
поставщик сервиса без переопределения addService()

addBeanContextServicesListener

public void addBeanContextServicesListener(BeanContextServicesListener bcsl)

добавить BeanContextServicesListener

Определено в:
addBeanContextServicesListener в интерфейсе BeanContextServices
Параметры:
bcsl - добавляемый BeanContextServicesListener
Исключения:
NullPointerException - если аргумент равен null

removeBeanContextServicesListener

public void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

удалить BeanContextServicesListener

Определено в:
removeBeanContextServicesListener в интерфейсе BeanContextServices
Параметры:
bcsl - BeanContextServicesListener для удаления из этого контекста

addService

public boolean addService(Class<?> serviceClass,
                          BeanContextServiceProvider bcsp)

добавить сервис

Определено в:
addService в интерфейсе BeanContextServices
Параметры:
serviceClass - класс сервиса
bcsp - поставщик сервиса
Возвращает:
true, если сервис был успешно добавлен, иначе false

addService

protected boolean addService(Class<?> serviceClass,
                             BeanContextServiceProvider bcsp,
                             boolean fireEvent)

добавить сервис

Параметры:
serviceClass - класс сервиса
bcsp - поставщик сервиса
fireEvent - следует ли генерировать событие
Возвращает:
true, если сервис был успешно добавлен

revokeService

public void revokeService(Class<?> serviceClass,
                          BeanContextServiceProvider bcsp,
                          boolean revokeCurrentServicesNow)

удалить сервис

Определено в:
revokeService в интерфейсе BeanContextServices
Параметры:
serviceClass - класс сервиса
bcsp - поставщик сервиса
revokeCurrentServicesNow - следует ли отменить сервис

hasService

public boolean hasService(Class<?> serviceClass)

имеется ли сервис, который может быть делегирован

Определено в:
hasService в интерфейсе BeanContextServices
Параметры:
serviceClass - запрашиваемый сервис
Возвращает:
true, если сервис доступен

getService

public Object getService(BeanContextChild child,
                         Object requestor,
                         Class<?> serviceClass,
                         Object serviceSelector,
                         BeanContextServiceRevokedListener bcsrl)
                  throws TooManyListenersException

получить сервис, который может быть делегирован

Определено в:
getService в интерфейсе BeanContextServices
Параметры:
child - BeanContextChild , связанный с этим запросом
requestor - объект, запрашивающий сервис
serviceClass - класс запрашиваемого сервиса
serviceSelector - параметр, зависящий от сервиса
bcsrl - BeanContextServiceRevokedListener для уведомления, если сервис позже будет отменен
Возвращает:
ссылка на именованный сервис контекста в соответствии с запросом или null
Исключения:
TooManyListenersException - если слушателей слишком много

releaseService

public void releaseService(BeanContextChild child,
                           Object requestor,
                           Object service)

освободить сервис

Определено в:
releaseService в интерфейсе BeanContextServices
Параметры:
child - BeanContextChild
requestor - запрашивающий
service - сервис

getCurrentServiceClasses

public Iterator<Object> getCurrentServiceClasses()

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

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

Определено в:
getCurrentServiceClasses в интерфейсе BeanContextServices
Возвращает:
итератор для всех текущих зарегистрированных классов сервисов.

getCurrentServiceSelectors

public Iterator<?> getCurrentServiceSelectors(Class<?> serviceClass)

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

Получает список параметров сервиса, зависящих от сервиса (Service Selectors), для указанного сервиса, вызывая getCurrentServiceSelectors() у базового BeanContextServiceProvider.

Определено в:
getCurrentServiceSelectors в интерфейсе BeanContextServices
Параметры:
serviceClass - указанный сервис
Возвращает:
итератор для всех текущих доступных селекторов сервиса (если таковые имеются) для указанного сервиса.

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcssae)

Обработчик BeanContextServicesListener, распространяет событие всем текущим зарегистрированным слушателям и потомкам BeanContextServices, если этот BeanContextService сам не реализует этот сервис. подклассы могут переопределить или обернуть этот метод, чтобы реализовать свою собственную семантику распространения.

Определено в:
serviceAvailable в интерфейсе BeanContextServicesListener
Переопределяет:
serviceAvailable в классе BeanContextChildSupport
Параметры:
bcssae - BeanContextServiceAvailableEvent, сгенерированный в результате доступности сервиса

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcssre)

Обработчик BeanContextServicesListener, распространяет событие всем текущим зарегистрированным слушателям и потомкам BeanContextServices, если этот BeanContextService сам не реализует этот сервис. подклассы могут переопределить или обернуть этот метод, чтобы реализовать свою собственную семантику распространения.

Определено в:
serviceRevoked в интерфейсе BeanContextServiceRevokedListener
Переопределяет:
serviceRevoked в классе BeanContextChildSupport
Параметры:
bcssre - BeanContextServiceRevokedEvent , сгенерированный в результате отмены сервиса

getChildBeanContextServicesListener

protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)

Получает BeanContextServicesListener (если есть) указанного потомка.

Параметры:
child - указанный потомок
Возвращает:
BeanContextServicesListener (если есть) указанного потомка

childJustRemovedHook

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

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

Переопределяет:
childJustRemovedHook в классе BeanContextSupport
Параметры:
child - потомок
bcsc - BCSChild

releaseBeanContextResources

protected void releaseBeanContextResources()

вызывается из setBeanContext, чтобы уведомить BeanContextChild об освобождении ресурсов, полученных из вложенного BeanContext. Этот метод отменяет любые сервисы, полученные от родителя. подклассы могут обернуть этот метод для реализации собственных семантик.

Переопределяет:
releaseBeanContextResources в классе BeanContextChildSupport

initializeBeanContextResources

protected void initializeBeanContextResources()

вызывается из setBeanContext, чтобы уведомить BeanContextChild о выделении ресурсов, полученных из вложенного BeanContext. подклассы могут обернуть этот метод для реализации собственных семантик.

Переопределяет:
initializeBeanContextResources в классе BeanContextChildSupport

fireServiceAdded

protected final void fireServiceAdded(Class<?> serviceClass)

генерирует BeanContextServiceEvent, уведомляющий о новом сервисе.

Параметры:
serviceClass - класс сервиса

fireServiceAdded

protected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)

генерирует BeanContextServiceAvailableEvent, указывающий на доступность нового сервиса.

Параметры:
bcssae - BeanContextServiceAvailableEvent

fireServiceRevoked

protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)

генерирует BeanContextServiceEvent, уведомляющий об отмене сервиса.

Параметры:
bcsre - BeanContextServiceRevokedEvent

fireServiceRevoked

protected final void fireServiceRevoked(Class<?> serviceClass,
                                        boolean revokeNow)

Вызывает BeanContextServiceRevokedEvent, указывающий, что определённая служба больше недоступна.

Параметры:
serviceClass - класс службы
revokeNow - следует ли сейчас аннулировать событие

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos)
                                throws IOException

Вызывается из BeanContextSupport writeObject перед сериализацией дочерних элементов... Этот класс сериализует все Serializable BeanContextServiceProviders в нём. Подклассы могут обернуть этот метод, чтобы вставить свою обработку сериализации, которая должна произойти до сериализации дочерних элементов

Переопределяет:
bcsPreSerializationHook в классе BeanContextSupport
Параметры:
oos - ObjectOutputStream для использования во время сериализации
Исключения:
IOException - если сериализация не удалась

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

Вызывается из BeanContextSupport readObject перед десериализацией дочерних элементов... Этот класс десериализует все сериализованные ранее Serializable BeanContextServiceProviders, делая их доступными для дочерних элементов во время их десериализации. Подклассы могут обернуть этот метод, чтобы вставить свою обработку сериализации, которая должна произойти до десериализации дочерних элементов

Переопределяет:
bcsPreDeserializationHook в классе BeanContextSupport
Параметры:
ois - ObjectInputStream для использования во время десериализации
Исключения:
IOException - если десериализация не удалась
ClassNotFoundException - если необходимые классы не найдены

© 1993, 2020, 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/11/docs/api/java.desktop/java/beans/beancontext/BeanContextServicesSupport.html

Spec-Zone .ru
спецификации, руководства, описания, API