Интерфейс BeanContextServices
- Все суперинтерфейсы:
- BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Collection, DesignMode, EventListener, Iterable, Visibility
- Все известные реализующие классы:
- BeanContextServicesSupport
public interface BeanContextServices extends BeanContext, BeanContextServicesListener
Интерфейс BeanContextServices предоставляет механизм для BeanContext, чтобы предоставлять общие «сервисы» объектам BeanContextChild внутри.
Поля
Поля, унаследованные от интерфейса java.beans.beancontext.BeanContext
globalHierarchyLock
Поля, унаследованные от интерфейса java.beans.DesignMode
PROPERTYNAME
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
addBeanContextServicesListener(BeanContextServicesListener bcsl) Добавляет |
boolean |
addService(Class serviceClass,
BeanContextServiceProvider serviceProvider) Добавляет сервис в этот BeanContext. |
Iterator |
getCurrentServiceClasses() Получает доступные в данный момент сервисы для этого контекста. |
Iterator |
getCurrentServiceSelectors(Class serviceClass) Получает список параметров сервиса, зависящих от сервиса (Селекторы Сервиса), для указанного сервиса, вызывая getCurrentServiceSelectors() на базовом BeanContextServiceProvider. |
Object |
getService(BeanContextChild child,
Object requestor,
Class serviceClass,
Object serviceSelector,
BeanContextServiceRevokedListener bcsrl) Любой объект, связанный с |
boolean |
hasService(Class serviceClass) Сообщает, доступен ли данный сервис в данном контексте. |
void |
releaseService(BeanContextChild child,
Object requestor,
Object service) Освобождает ссылку объекта |
void |
removeBeanContextServicesListener(BeanContextServicesListener bcsl) Удаляет |
void |
revokeService(Class serviceClass,
BeanContextServiceProvider serviceProvider,
boolean revokeCurrentServicesNow) BeanContextServiceProviders, желающие удалить зарегистрированный сервис из данного контекста, могут сделать это, вызвав этот метод. |
Методы, унаследованные от интерфейса 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
Методы, унаследованные от интерфейса java.lang.Iterable
forEach
Методы, унаследованные от интерфейса java.beans.DesignMode
isDesignTime, setDesignTime
Методы, унаследованные от интерфейса java.beans.Visibility
avoidingGui, dontUseGui, needsGui, okToUseGui
Методы, унаследованные от интерфейса java.beans.beancontext.BeanContextServicesListener
serviceAvailable
Методы, унаследованные от интерфейса java.beans.beancontext.BeanContextServiceRevokedListener
serviceRevoked
Методы
addService
boolean addService(Class serviceClass,
BeanContextServiceProvider serviceProvider)
Добавляет сервис в этот BeanContext. BeanContextServiceProvider вызов этого метода регистрирует конкретный сервис в этом контексте. Если сервис ранее не был добавлен, BeanContextServices связывает сервис с BeanContextServiceProvider и отправляет BeanContextServiceAvailableEvent всем текущим зарегистрированным BeanContextServicesListeners. Затем метод возвращает true, указывая, что добавление сервиса было успешным. Если данный сервис уже был добавлен, этот метод просто возвращает false.
- Параметры:
-
serviceClass- добавляемый сервис -
serviceProvider-BeanContextServiceProvider, связанный с сервисом - Возвращает:
- true, если сервис был успешно добавлен, иначе false
revokeService
void revokeService(Class serviceClass,
BeanContextServiceProvider serviceProvider,
boolean revokeCurrentServicesNow)
BeanContextServiceProviders, желающие удалить зарегистрированный сервис из данного контекста, могут сделать это, вызвав этот метод. При отзыве сервиса, BeanContextServices отправляет BeanContextServiceRevokedEvent в свой список текущих зарегистрированных BeanContextServiceRevokedListeners и BeanContextServicesListeners.
- Параметры:
-
serviceClass- сервис, подлежащий отзыву из BeanContextServices -
serviceProvider- BeanContextServiceProvider, связанный с этим конкретным сервисом, который отзывается -
revokeCurrentServicesNow- значениеtrueуказывает на исключительные обстоятельства, когдаBeanContextServiceProviderилиBeanContextServicesхотят немедленно прекратить обслуживание всех текущих активных ссылок на указанный сервис.
hasService
boolean hasService(Class serviceClass)
Сообщает, доступен ли данный сервис в данном контексте.
- Параметры:
-
serviceClass- интересующий сервис - Возвращает:
- true, если сервис доступен
getService
Object getService(BeanContextChild child,
Object requestor,
Class serviceClass,
Object serviceSelector,
BeanContextServiceRevokedListener bcsrl)
throws TooManyListenersException
Любой объект, связанный с BeanContextChild, может получить ссылку на зарегистрированный сервис из своего вложенного BeanContextServices с помощью этого метода. При вызове этот метод получает сервис, вызывая метод getService() на базовом BeanContextServiceProvider.
- Параметры:
-
child-BeanContextChild, связанный с запросом -
requestor- запрашивающий объект -
serviceClass- класс запрашиваемого сервиса -
serviceSelector- параметр, зависящий от сервиса -
bcsrl-BeanContextServiceRevokedListenerдля уведомления, если сервис позже будет отозван - Возвращает:
- ссылка на указанный сервис контекста или
null - Исключения:
-
TooManyListenersException- если слушателей слишком много
releaseService
void releaseService(BeanContextChild child,
Object requestor,
Object service)
Освобождает ссылку объекта BeanContextChild (или любого произвольного объекта, связанного с BeanContextChild) на указанный сервис, вызывая releaseService() на базовом BeanContextServiceProvider.
- Параметры:
-
child-BeanContextChild -
requestor- запрашивающий -
service- сервис
getCurrentServiceClasses
Iterator getCurrentServiceClasses()
Получает доступные в данный момент сервисы для этого контекста.
- Возвращает:
- список текущих доступных сервисов
getCurrentServiceSelectors
Iterator getCurrentServiceSelectors(Class serviceClass)
Получает список параметров сервиса, зависящих от сервиса (Селекторы Сервиса), для указанного сервиса, вызывая getCurrentServiceSelectors() на базовом BeanContextServiceProvider.
- Параметры:
-
serviceClass- указанный сервис - Возвращает:
- текущие доступные селекторы сервиса для данного serviceClass
addBeanContextServicesListener
void addBeanContextServicesListener(BeanContextServicesListener bcsl)
Добавляет BeanContextServicesListener в этот BeanContext
- Параметры:
-
bcsl- добавляемыйBeanContextServicesListener
removeBeanContextServicesListener
void removeBeanContextServicesListener(BeanContextServicesListener bcsl)
Удаляет BeanContextServicesListener из этого BeanContext
- Параметры:
-
bcsl- удаляемыйBeanContextServicesListenerиз этого контекста
© 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.