Класс BeanContextServicesSupport

public class BeanContextServicesSupport
extends BeanContextSupport
implements BeanContextServices

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

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

Поля

services

protected transient HashMap services

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

serializable

protected transient int serializable

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

proxy

protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy

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

bcsListeners

protected transient ArrayList bcsListeners

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

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

BeanContextServicesSupport

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

Параметры:

peer - Объект BeanContext, для которого предоставляется реализация. Если null, этот объект является своим собственным peer.

lcle - Текущий Locale для данного BeanContext.

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

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

BeanContextServicesSupport

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

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

Параметры:

peer - Объект BeanContext, для которого предоставляется реализация. Если null, этот объект является своим собственным peer.

lcle - Текущий Locale для данного BeanContext.

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

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle)

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

Параметры:

peer - Объект BeanContext, для которого предоставляется реализация. Если null, этот объект является своим собственным peer.

lcle - Текущий Locale для данного BeanContext.

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer)

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

Параметры:

peer - Объект BeanContext, для которого предоставляется реализация. Если null, этот объект является своим собственным peer.

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)

Переопределяет:

createBCSChild в классе BeanContextSupport

Параметры:

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

peer - peer, если targetChild и peer связаны BeanContextProxy

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 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)

Вызывается из операций удаления дочерних элементов суперкласса после успешного удаления дочернего элемента. Вызывается с синхронизированным child. Этот подкласс использует этот обработчик для немедленного отзыва любых услуг, используемых этим дочерним элементом, если он является 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 перед сериализацией дочерних элементов... Этот класс сериализует все сериализуемые BeanContextServiceProviders. Подклассы могут оборачивать этот метод, чтобы вставить свою обработку сериализации, которая должна произойти до сериализации дочерних элементов

Переопределяет:

bcsPreSerializationHook в классе BeanContextSupport

Параметры:

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

Исключения:

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

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

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

Переопределяет:

bcsPreDeserializationHook в классе BeanContextSupport

Параметры:

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

Исключения:

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

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