java.beans.beancontext

インタフェース BeanContextServices

すべてのスーパーインタフェース:

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

既知のすべての実装クラス:

BeanContextServicesSupport

public interface BeanContextServices
extends BeanContext, BeanContextServicesListener

BeanContextServices インタフェースは、BeanContextChild オブジェクトがジェネリックサービスを受けられるようにするためのメカニズムを BeanContext に提供します。

フィールドのサマリー

インタフェース java.beans.beancontext.BeanContext から継承されたフィールド

globalHierarchyLock

インタフェース java.beans.DesignMode から継承されたフィールド

PROPERTYNAME

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	addBeanContextServicesListener(BeanContextServicesListener bcsl) この BeanContext に BeanContextServicesListener を追加します
boolean	addService(Class serviceClass, BeanContextServiceProvider serviceProvider) この BeanContext にサービスを追加します。
Iterator	getCurrentServiceClasses() このコンテキストに現在使用可能なサービスを取得します。
Iterator	getCurrentServiceSelectors(Class serviceClass) 基本的な BeanContextServiceProvider の getCurrentServiceSelectors() を呼び出すことによって、指定されたサービスのサービス依存サービスパラメータ (Service Selectors) のリストを取得します。
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) 現在登録されているサービスをこのコンテキストから削除するために、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, 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)

現在登録されているサービスをこのコンテキストから削除するために、BeanContextServiceProviders は、このメソッドを呼び出して削除できます。サービスの呼び出しの際、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

戻り値:

リクエストされた、このコンテキストの指定されたサービスへの参照、または 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() を呼び出すことによって、指定されたサービスのサービス依存サービスパラメータ (Service Selectors) のリストを取得します。

パラメータ:

serviceClass - 指定されたサービス

戻り値:

指定された serviceClass で現在使用可能なサービスセレクタ

addBeanContextServicesListener

void addBeanContextServicesListener(BeanContextServicesListener bcsl)

この BeanContext に BeanContextServicesListener を追加します

パラメータ:

bcsl - 追加する BeanContextServicesListener

removeBeanContextServicesListener

void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

この BeanContext から BeanContextServicesListener を削除します

パラメータ:

bcsl - このコンテキストから削除する BeanContextServicesListener