Spec-Zone.ru › OpenJDK 17

Класс BeanContextServicesSupport

java.lang.Object
java.beans.beancontext.BeanContextChildSupport
java.beans.beancontext.BeanContextSupport
java.beans.beancontext.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 final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)
Срабатывает BeanContextServiceAvailableEvent, указывая на то, что новый сервис стал доступен.
protected final void fireServiceAdded(Class<?> serviceClass)
Срабатывает BeanContextServiceEvent, уведомляя о новом сервисе.
protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)
Срабатывает BeanContextServiceEvent, уведомляя об аннулировании сервиса.
protected final void fireServiceRevoked(Class<?> serviceClass, boolean revokeNow)
Срабатывает BeanContextServiceRevokedEvent, указывая на то, что определённый сервис больше недоступен.
BeanContextServices getBeanContextServicesPeer()
Получает BeanContextServices, связанный с данным BeanContextServicesSupport.
protected static final 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 суперклассом во время построения и десериализации для инициализации состояния подкласса transient.
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 - взаимодействующий объект, если 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 сам не реализует эту службу. Подклассы могут переопределять или оборачивать этот метод для реализации собственной семантики распространения.
Specified by:
serviceAvailable в интерфейсе BeanContextServicesListener
Overrides:
serviceAvailable в классе BeanContextChildSupport
Parameters:
bcssae - Событие BeanContextServiceAvailableEvent, сгенерированное в результате доступности службы

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcssre)
Обработчик BeanContextServicesListener, распространяет событие всем текущим зарегистрированным слушателям и дочерним BeanContextServices, если данный BeanContextService сам не реализует эту службу. Подклассы могут переопределять или оборачивать этот метод для реализации собственной семантики распространения.
Specified by:
serviceRevoked в интерфейсе BeanContextServiceRevokedListener
Overrides:
serviceRevoked в классе BeanContextChildSupport
Parameters:
bcssre - Событие BeanContextServiceRevokedEvent , сгенерированное в результате отзыва службы

getChildBeanContextServicesListener

protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)
Получает BeanContextServicesListener (если есть) указанного дочернего элемента.
Parameters:
child - Указанный дочерний элемент
Returns:
BeanContextServicesListener (если есть) указанного дочернего элемента

childJustRemovedHook

protected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
Вызывается из операций удаления дочерних элементов суперкласса после успешного удаления дочернего элемента. Вызывается с синхронизацией по дочернему элементу. Этот подкласс использует этот обработчик для немедленного отзыва любых служб, используемых этим дочерним элементом, если это BeanContextChild. Подклассы могут оборачивать этот метод для реализации собственных побочных эффектов удаления дочерних элементов.
Overrides:
childJustRemovedHook в классе BeanContextSupport
Parameters:
child - дочерний элемент
bcsc - BCSChild

releaseBeanContextResources

protected void releaseBeanContextResources()
Вызывается из setBeanContext для уведомления BeanContextChild об освобождении ресурсов, полученных из вложенного BeanContext. Этот метод отзывает любые полученные от родительского элемента службы. Подклассы могут оборачивать этот метод для реализации собственной семантики.
Overrides:
releaseBeanContextResources в классе BeanContextChildSupport

initializeBeanContextResources

protected void initializeBeanContextResources()
Вызывается из setBeanContext для уведомления BeanContextChild об выделении ресурсов, полученных из вложенного BeanContext. Подклассы могут оборачивать этот метод для реализации собственной семантики.
Overrides:
initializeBeanContextResources в классе BeanContextChildSupport

fireServiceAdded

protected final void fireServiceAdded(Class<?> serviceClass)
Генерирует BeanContextServiceEvent, уведомляющий о новой службе.
Parameters:
serviceClass - класс службы

fireServiceAdded

protected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)
Генерирует BeanContextServiceAvailableEvent, указывающий, что новая служба стала доступна.
Parameters:
bcssae - BeanContextServiceAvailableEvent

fireServiceRevoked

protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)
Генерирует BeanContextServiceEvent, уведомляющий об отзыве службы.
Parameters:
bcsre - BeanContextServiceRevokedEvent

fireServiceRevoked

protected final void fireServiceRevoked(Class<?> serviceClass, boolean revokeNow)
Генерирует BeanContextServiceRevokedEvent, указывающий, что определённая служба больше недоступна.
Parameters:
serviceClass - класс службы
revokeNow - нужно ли отзывать событие сейчас

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException
Вызывается из BeanContextSupport writeObject перед сериализацией дочерних элементов ... Этот класс сериализует все Serializable BeanContextServiceProviders в нём. Подклассы могут оборачивать этот метод, чтобы добавить свою обработку сериализации, которая должна выполняться перед сериализацией дочерних элементов.
Overrides:
bcsPreSerializationHook в классе BeanContextSupport
Parameters:
oos - ObjectOutputStream для использования во время сериализации
Throws:
IOException - если сериализация не удалась

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException
Вызывается из BeanContextSupport readObject перед десериализацией дочерних элементов ... Этот класс десериализует все ранее сериализованные Serializable BeanContextServiceProviders, делая их доступными для дочерних элементов при их десериализации. Подклассы могут оборачивать этот метод, чтобы добавить свою обработку сериализации, которая должна выполняться перед сериализацией дочерних элементов
Overrides:
bcsPreDeserializationHook в классе BeanContextSupport
Parameters:
ois - ObjectInputStream для использования во время десериализации
Throws:
IOException - если десериализация не удалась
ClassNotFoundException - если необходимые классы не найдены

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/beans/beancontext/BeanContextServicesSupport.html

Spec-Zone.ru

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