Интерфейс 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 в этот BeanContext |
boolean |
addService |
Добавляет сервис в этот BeanContext. |
Iterator<?> |
getCurrentServiceClasses() |
Получает доступные сервисы для этого контекста. |
Iterator<?> |
getCurrentServiceSelectors |
Получает список параметров сервисов, зависящих от сервиса (селекторы сервиса), для указанного сервиса, вызывая getCurrentServiceSelectors() в базовом BeanContextServiceProvider. |
Object |
getService |
Любой объект, связанный с BeanContextChild, может получить ссылку на зарегистрированный сервис из своего вложенного BeanContextServices через вызов этого метода. |
boolean |
hasService |
Указывает, доступен ли данный сервис в этом контексте. |
void |
releaseService |
Освобождает ссылку объекта (или любого произвольного объекта, связанного с BeanContextChild) на указанный сервис, вызывая releaseService() в базовом BeanContextServiceProvider. |
void |
removeBeanContextServicesListener |
Удаляет BeanContextServicesListener из этого BeanContext
|
void |
revokeService |
BeanContextServiceProviders, желающие удалить зарегистрированный сервис из этого контекста, могут сделать это, вызвав этот метод. |
Методы, объявленные в интерфейсе java.beans.beancontext.BeanContext
addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener
Методы, объявленные в интерфейсе java.beans.beancontext.BeanContextChild
addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
Методы, объявленные в интерфейсе java.beans.beancontext.BeanContextServiceRevokedListener
serviceRevoked
Методы, объявленные в интерфейсе java.beans.beancontext.BeanContextServicesListener
serviceAvailable
Методы, объявленные в интерфейсе 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.beans.Visibility
avoidingGui, dontUseGui, needsGui, okToUseGui
Подробности методов
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
A
BeanContextChild, или любой произвольный объект, связанный с 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()
Получает доступные в данный момент сервисы для этого контекста.
- Возвращает:
- a
Iterator, содержащий доступные в настоящий момент сервисы
getCurrentServiceSelectors
Iterator<?> getCurrentServiceSelectors(Class<?> serviceClass)
Получает список зависимых от сервиса параметров сервиса (Service Selectors) для указанного сервиса, вызвав getCurrentServiceSelectors() у базового BeanContextServiceProvider.
- Параметры:
-
serviceClass- указанный сервис - Возвращает:
- текущие доступные селекторы сервиса для данного сервисного класса
addBeanContextServicesListener
void addBeanContextServicesListener(BeanContextServicesListener bcsl)
Добавляет
BeanContextServicesListener в этот BeanContext- Параметры:
-
bcsl- добавляемыйBeanContextServicesListener
removeBeanContextServicesListener
void removeBeanContextServicesListener(BeanContextServicesListener bcsl)
Удаляет
BeanContextServicesListener из этого BeanContext
- Параметры:
-
bcsl-BeanContextServicesListenerдля удаления из этого контекста
© 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/BeanContextServices.html