java.beans.beancontext
介面 BeanContextServices

所有父級介面：

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

所有已知實作類別：

BeanContextServicesSupport

public interface BeanContextServices
extends BeanContext, BeanContextServicesListener

BeanContextServices 介面為 BeanContext 提供某種機制，將一般的 "services" 向其中的 BeanContextChild 物件公開。

欄位摘要

從介面 java.beans.beancontext.BeanContext 繼承的欄位

globalHierarchyLock

從介面 java.beans.DesignMode 繼承的欄位

PROPERTYNAME

方法摘要

void	addBeanContextServicesListener(BeanContextServicesListener bcsl) 將一個 BeanContextServicesListener 添加到此 BeanContext
boolean	addService(Class serviceClass, BeanContextServiceProvider serviceProvider) 向此 BeanContext 添加服務。
Iterator	getCurrentServiceClasses() 獲得此上下文的當前可用服務。
Iterator	getCurrentServiceSelectors(Class serviceClass) 通過在基礎 BeanContextServiceProvider 上調用 getCurrentServiceSelectors() 獲得指定服務的與服務有關的服務參數列表（服務選擇器）。
Object	getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) BeanContextChild（或任意與 BeanContextChild 關聯的物件）可以通過調用此方法從其巢狀 BeanContextServices 中獲得對當前已註冊服務的參考。
boolean	hasService(Class serviceClass) 報告是否可以從此上下文中得到給定服務。
void	releaseService(BeanContextChild child, Object requestor, Object service) 通過在基礎 BeanContextServiceProvider 上調用 releaseService() 釋放 BeanContextChild（或與 BeanContextChild 關聯的任意物件）對指定服務的參考。
void	removeBeanContextServicesListener(BeanContextServicesListener bcsl) 從此 BeanContext 中移除一個 BeanContextServicesListener
void	revokeService(Class serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow) 希望從此上下文中移除當前已註冊服務的 BeanContextServiceProvider 可以通過調用此方法實作移除。

從介面 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, remove, removeAll, retainAll, size, toArray, toArray

從介面 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 相關聯，並對所有當前已註冊的 BeanContextServicesListeners 觸發一個 BeanContextServiceAvailableEvent。然後該方法返回 true，指示成功添加了服務。如果已添加給定服務，則此方法僅返回 false。

參數：

serviceClass - 要添加的服務

serviceProvider - 與該服務相關聯的 BeanContextServiceProvider

revokeService

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

希望從此上下文中移除當前已註冊服務的 BeanContextServiceProvider 可以通過調用此方法實作移除。在撤消該服務時，BeanContextServices 對當前已註冊的 BeanContextServiceRevokedListeners 和 BeanContextServicesListeners 的列表觸發一個 BeanContextServiceRevokedEvent。

參數：

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（或任意與 BeanContextChild 關聯的物件）可以通過調用此方法從其巢狀 BeanContextServices 中獲得對當前已註冊服務的參考。此方法在調用時通過在基礎 BeanContextServiceProvider 上調用 getService() 獲得服務。

參數：

child - 與此請求相關聯的 BeanContextChild

requestor - 請求服務的物件

serviceClass - 所請求服務的類別

serviceSelector - 與服務有關的參數

bcsrl - 通知稍後是否應該取消服務的 BeanContextServiceRevokedListener

返回：

所請求的此上下文的指定 Service 的參考，或 null

拋出：

TooManyListenersException

releaseService

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

通過在基礎 BeanContextServiceProvider 上調用 releaseService() 釋放 BeanContextChild（或與 BeanContextChild 關聯的任意物件）對指定服務的參考。

參數：

child - BeanContextChild

requestor - 請求者

service - 服務

getCurrentServiceClasses

Iterator getCurrentServiceClasses()

獲得此上下文的當前可用服務。

返回：

由當前可用服務組成的 Iterator

getCurrentServiceSelectors

Iterator getCurrentServiceSelectors(Class serviceClass)

通過在基礎 BeanContextServiceProvider 上調用 getCurrentServiceSelectors() 獲得指定服務的與服務有關的服務參數列表（服務選擇器）。

參數：

serviceClass - 指定服務

返回：

指定 serviceClass 的當前可用的服務選擇器

addBeanContextServicesListener

void addBeanContextServicesListener(BeanContextServicesListener bcsl)

將一個 BeanContextServicesListener 添加到此 BeanContext

參數：

bcsl - 要添加的 BeanContextServicesListener

removeBeanContextServicesListener

void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

從此 BeanContext 中移除一個 BeanContextServicesListener

參數：

bcsl - 要從此上下文移除的 BeanContextServicesListener