java.beans.beancontext

Interface BeanContextServices

All Superinterfaces:

BeanContext ， BeanContextChild ， BeanContextServiceRevokedListener ， BeanContextServicesListener ， Collection ， DesignMode ， EventListener ， Iterable ， Visibility

所有已知实现类：

BeanContextServicesSupport

public interface BeanContextServices
extends BeanContext, BeanContextServicesListener

BeanContextServices接口提供了一个机制，让BeanContext将通用的“服务”公开给它的BeanContextChild对象。

Field Summary

Fields inherited from interface java.beans.beancontext.BeanContext

globalHierarchyLock

Fields inherited from interface java.beans.DesignMode

PROPERTYNAME

方法摘要

Modifier and Type	Method and Description
void	addBeanContextServicesListener(BeanContextServicesListener bcsl) 添加一个 BeanContextServicesListener来此BeanContext
boolean	addService(类 serviceClass, BeanContextServiceProvider serviceProvider) 向这个BeanContext添加一个服务。
Iterator	getCurrentServiceClasses() 获取此上下文的当前可用服务。
Iterator	getCurrentServiceSelectors(类 serviceClass) 通过调用底层BeanContextServiceProvider上的getCurrentServiceSelectors（），获取指定服务的服务相关服务参数（服务选择器）列表。
Object	getService(BeanContextChild child, Object requestor, 类 serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) A BeanContextChild或与 BeanContextChild任何任意对象可以通过调用该方法从其嵌套 BeanContextServices获得对当前注册服务的 BeanContextServices 。
boolean	hasService(类 serviceClass) 报告当前是否可以从此上下文获得给定的服务。
void	releaseService(BeanContextChild child, Object requestor, Object service) 通过调用底层BeanContextServiceProvider上的releaseService（），释放一个 BeanContextChild （或任何与BeanContextChild关联的任意对象）对指定服务的 BeanContextServiceProvider 。
void	removeBeanContextServicesListener(BeanContextServicesListener bcsl) 从此 BeanContextServicesListener删除 BeanContext
void	revokeService(类 serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) 希望从此上下文中删除当前注册的服务的BeanContextServiceProviders可以通过调用此方法来实现。

Methods inherited from interface java.beans.beancontext.BeanContext

addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener

Methods inherited from interface java.beans.beancontext.BeanContextChild

addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext

Methods inherited from interface java.util.Collection

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

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.beans.DesignMode

isDesignTime, setDesignTime

Methods inherited from interface java.beans.Visibility

avoidingGui, dontUseGui, needsGui, okToUseGui

Methods inherited from interface java.beans.beancontext.BeanContextServicesListener

serviceAvailable

Methods inherited from interface java.beans.beancontext.BeanContextServiceRevokedListener

serviceRevoked

方法详细信息

addService

boolean addService(类 serviceClass,
                   BeanContextServiceProvider serviceProvider)

向这个BeanContext添加一个服务。 BeanContextServiceProvider称这个方法用这个上下文来注册一个特定的服务。 如果服务先前没有被添加，该BeanContextServices关联与服务BeanContextServiceProvider并触发一个BeanContextServiceAvailableEvent到所有当前已注册BeanContextServicesListeners 。 该方法然后返回true ，表示添加服务成功。 如果给定的服务已经被添加，这个方法只返回false 。

参数

serviceClass - 要添加的服务

serviceProvider - 与服务相关 BeanContextServiceProvider BeanContextServiceProvider

结果

如果服务成功添加，则为true，否则为false

revokeService

void revokeService(类 serviceClass,
                   BeanContextServiceProvider serviceProvider,
                   boolean revokeCurrentServicesNow)

希望从此上下文中删除当前注册的服务的BeanContextServiceProviders可以通过调用此方法来实现。 该服务被BeanContextServices ， BeanContextServiceRevokedEvent将其BeanContextServiceRevokedListeners和BeanContextServicesListeners列表中的BeanContextServicesListeners 。

参数

serviceClass - 从这个BeanContextServices撤销的服务

serviceProvider - 与正在撤销的特定服务相关联的BeanContextServiceProvider

revokeCurrentServicesNow -值 true表示特殊情况，其中 BeanContextServiceProvider或 BeanContextServices希望立即终止服务，指定服务当前所有未完成的引用。

hasService

boolean hasService(类 serviceClass)

报告当前是否可以从此上下文获得给定的服务。

参数

serviceClass - 有关服务

结果

如果服务可用，则为true

getService

Object getService(BeanContextChild child,
                  Object requestor,
                  类 serviceClass,
                  Object serviceSelector,
                  BeanContextServiceRevokedListener bcsrl)
           throws TooManyListenersException

A BeanContextChild或与BeanContextChild任何任意对象可以通过调用该方法从其嵌套BeanContextServices获得对当前注册服务的BeanContextServices 。 当被调用时，该方法通过调用底层上的getService（）方法获取的服务BeanContextServiceProvider 。

参数

child - 与此请求相关 BeanContextChild BeanContextChild

requestor - 请求服务的对象

serviceClass - 所请求的服务的类

serviceSelector - 服务相关参数

bcsrl - BeanContextServiceRevokedListener通知服务是否应该以后被撤销

结果

根据请求引用此上下文的命名服务或 null

异常

TooManyListenersException - 如果听众太多了

releaseService

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

通过调用底层BeanContextServiceProvider上的releaseService（），释放一个 BeanContextChild （或任何与BeanContextChild关联的任意对象）对指定服务的 BeanContextServiceProvider 。

参数

child - BeanContextChild

requestor - 请求者

service - 服务

getCurrentServiceClasses

Iterator getCurrentServiceClasses()

获取此上下文的当前可用服务。

结果

一个 Iterator由当前可用的服务组成

getCurrentServiceSelectors

Iterator getCurrentServiceSelectors(类 serviceClass)

通过调用底层BeanContextServiceProvider上的getCurrentServiceSelectors（），获取指定服务的服务相关服务参数（服务选择器）列表。

参数

serviceClass - 指定的服务

结果

名为serviceClass的当前可用的服务选择器

addBeanContextServicesListener

void addBeanContextServicesListener(BeanContextServicesListener bcsl)

添加一个 BeanContextServicesListener来此BeanContext

参数

bcsl - 要添加的 BeanContextServicesListener

removeBeanContextServicesListener

void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

从此 BeanContextServicesListener删除 BeanContext

参数

bcsl - 从此上下文中删除的 BeanContextServicesListener