java.beans.beancontext

クラスBeanContextServicesSupport

java.lang.Object

java.beans.beancontext.BeanContextChildSupport

java.beans.beancontext.BeanContextSupport

java.beans.beancontext.BeanContextServicesSupport

すべての実装されたインタフェース:

BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServices, BeanContextServicesListener, DesignMode, PropertyChangeListener, VetoableChangeListener, Visibility, Serializable, Iterable, Collection, EventListener

public class BeanContextServicesSupport
extends BeanContextSupport
implements BeanContextServices

このヘルパー・クラスは、java.beans.beancontext.BeanContextServicesインタフェースのユーティリティの実装を提供します。

このクラスは、BeanContextServicesインタフェースを直接実装するため、この実装をサブクラス化することによって、あるいはBeanContextProxyインタフェースを介してほかのインスタンスからこのクラスのインスタンスを委譲することによって使用することを目的としています。

導入されたバージョン:

1.2

関連項目:

直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
protected class	BeanContextServicesSupport.BCSSChild
protected class	BeanContextServicesSupport.BCSSProxyServiceProvider
protected static class	BeanContextServicesSupport.BCSSServiceProvider サブクラスは、この入れ子構造のクラスをサブクラス化して、各BeanContextServicesProviderの動作を追加できます。

クラス java.beans.beancontext.BeanContextSupportから継承されたネストされたクラス/インタフェース

BeanContextSupport.BCSChild, BeanContextSupport.BCSIterator

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
protected ArrayList	bcsListeners BeanContextServicesListenerオブジェクトのリスト。
protected BeanContextServicesSupport.BCSSProxyServiceProvider	proxy BeanContextServiceProviderの委譲。
protected int	serializable 直列化可能なBeanContextServceProviderのインスタンスの数。
protected HashMap	services protected transient HashMap services フィールドへのすべてのアクセスはそのオブジェクトで同期されるはずです

クラス java.beans.beancontext.BeanContextSupportから継承されたフィールド

bcmListeners, children, designTime, locale, okToUseGui

クラス java.beans.beancontext.BeanContextChildSupportから継承されたフィールド

beanContext, beanContextChildPeer, pcSupport, rejectedSetBCOnce, vcSupport

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

globalHierarchyLock

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

PROPERTYNAME

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
BeanContextServicesSupport() ほかのオブジェクトの委譲でないインスタンスを生成します。
BeanContextServicesSupport(BeanContextServices peer) ピアを使ってインスタンスを生成します。
BeanContextServicesSupport(BeanContextServices peer, Locale lcle) 指定されたロケールを使ってインスタンスを生成します。
BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dtime) 指定されたロケールを使って設計モードでインスタンスを生成します。
BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dTime, boolean visible) BeanContextServicesSupportのインスタンスを生成します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	addBeanContextServicesListener(BeanContextServicesListener bcsl) BeanContextServicesListenerを追加します
boolean	addService(Class serviceClass, BeanContextServiceProvider bcsp) サービスを追加します。
protected boolean	addService(Class serviceClass, BeanContextServiceProvider bcsp, boolean fireEvent) サービスを追加します。
protected void	bcsPreDeserializationHook(ObjectInputStream ois) BeanContextSupport readObjectが子を直列化する前に、BeanContextSupport readObjectによって呼び出されます。
protected void	bcsPreSerializationHook(ObjectOutputStream oos) BeanContextSupport writeObjectが子を直列化する前に、BeanContextSupport writeObjectによって呼び出されます。
protected void	childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc) 子が正常に削除されたあとで、スーパー・クラスの子削除操作から呼び出されます。
protected BeanContextSupport.BCSChild	createBCSChild(Object targetChild, Object peer) サブクラスはこのメソッドをオーバーライドすることにより、セットに子を追加するadd()メソッドやほかのCollectionメソッドをオーバーライドすることなく、Childの独自のサブクラスを挿入することができます。
protected BeanContextServicesSupport.BCSSServiceProvider	createBCSSServiceProvider(Class sc, BeanContextServiceProvider bcsp) サブクラスはこのメソッドをオーバーライドすることにより、インスタンス化するためにaddService()をオーバーライドすることなく、BCSSServiceProviderの新しいサブクラスを作成できます。
protected void	fireServiceAdded(BeanContextServiceAvailableEvent bcssae) 新しいサービスが利用可能になったことを示すBeanContextServiceAvailableEventをトリガーします。
protected void	fireServiceAdded(Class serviceClass) 新しいサービスを通知するBeanContextServiceEventをトリガーします。
protected void	fireServiceRevoked(BeanContextServiceRevokedEvent bcsre) サービスの取消しを通知するBeanContextServiceEventをトリガーします。
protected void	fireServiceRevoked(Class serviceClass, boolean revokeNow) 特定のサービスが利用できなくなったことを示すBeanContextServiceRevokedEventをトリガーします。
BeanContextServices	getBeanContextServicesPeer() このBeanContextServicesSupportに関連付けられているBeanContextServicesを取得します。
protected static BeanContextServicesListener	getChildBeanContextServicesListener(Object child) 指定された子のBeanContextServicesListener (存在する場合)を取得します。
Iterator	getCurrentServiceClasses() このコンテキストに現在使用可能なサービスを取得します。
Iterator	getCurrentServiceSelectors(Class serviceClass) 基本的なBeanContextServiceProviderのgetCurrentServiceSelectors()を呼び出すことによって、指定されたサービスのサービス依存サービス・パラメータ(Service Selectors)のリストを取得します。
Object	getService(BeanContextChild child, Object requestor, Class serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) サービスを取得します。そのサービスは委譲されることもあります。
boolean	hasService(Class serviceClass) サービスを持ちます。そのサービスは委譲されることもあります。
void	initialize() サブクラスの一時的な状態を初期化するために、作成時および直列化復元時にBeanContextSupportのスーパー・クラスによって呼び出されます。
protected void	initializeBeanContextResources() 入れ子になっているBeanContextから取得したリソースを割り当てるようBeanContextChildに通知するために、setBeanContextから呼び出されます。
protected void	releaseBeanContextResources() 入れ子になっているBeanContextから取得したリソースを解放するようBeanContextChildに通知するために、setBeanContextから呼び出されます。
void	releaseService(BeanContextChild child, Object requestor, Object service) サービスを解放します。
void	removeBeanContextServicesListener(BeanContextServicesListener bcsl) BeanContextServicesListenerを削除します
void	revokeService(Class serviceClass, BeanContextServiceProvider bcsp, boolean revokeCurrentServicesNow) サービスを削除します。
void	serviceAvailable(BeanContextServiceAvailableEvent bcssae) BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。
void	serviceRevoked(BeanContextServiceRevokedEvent bcssre) BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。

クラス java.beans.beancontext.BeanContextSupportから継承されたメソッド

add, addAll, addBeanContextMembershipListener, avoidingGui, bcsChildren, childDeserializedHook, childJustAddedHook, classEquals, clear, contains, containsAll, containsKey, copyChildren, deserialize, dontUseGui, fireChildrenAdded, fireChildrenRemoved, getBeanContextPeer, getChildBeanContextChild, getChildBeanContextMembershipListener, getChildPropertyChangeListener, getChildSerializable, getChildVetoableChangeListener, getChildVisibility, getLocale, getResource, getResourceAsStream, instantiateChild, isDesignTime, isEmpty, isSerializing, iterator, needsGui, okToUseGui, propertyChange, readChildren, remove, remove, removeAll, removeBeanContextMembershipListener, retainAll, serialize, setDesignTime, setLocale, size, toArray, toArray, validatePendingAdd, validatePendingRemove, vetoableChange, writeChildren

クラス java.beans.beancontext.BeanContextChildSupportから継承されたメソッド

addPropertyChangeListener, addVetoableChangeListener, firePropertyChange, fireVetoableChange, getBeanContext, getBeanContextChildPeer, isDelegated, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext, validatePendingSetBeanContext

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェース 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

フィールドの詳細

services

protected transient HashMap services

protected transient HashMap services フィールドへのすべてのアクセスはそのオブジェクトで同期されるはずです

serializable

protected transient int serializable

直列化可能なBeanContextServceProviderのインスタンスの数。

proxy

protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy

BeanContextServiceProviderの委譲。

bcsListeners

protected transient ArrayList bcsListeners

BeanContextServicesListenerオブジェクトのリスト。

コンストラクタの詳細

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle,
                                  boolean dTime,
                                  boolean visible)

BeanContextServicesSupportのインスタンスを生成します。

パラメータ:

peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull

lcle - このBeanContextの現在のロケール。

dTime - 初期状態、設計モードの場合はtrue、実行時の場合はfalse。

visible - 初期状態での可視性。

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle,
                                  boolean dtime)

指定されたロケールを使って設計モードでインスタンスを生成します。

パラメータ:

peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull

lcle - このBeanContextの現在のロケール。

dtime - 初期状態、設計モードの場合はtrue、実行時の場合はfalse。

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle)

指定されたロケールを使ってインスタンスを生成します。

パラメータ:

peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull

lcle - このBeanContextの現在のロケール。

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer)

ピアを使ってインスタンスを生成します。

パラメータ:

peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull

BeanContextServicesSupport

public BeanContextServicesSupport()

ほかのオブジェクトの委譲でないインスタンスを生成します。

メソッドの詳細

initialize

public void initialize()

サブクラスの一時的な状態を初期化するために、作成時および直列化復元時にBeanContextSupportのスーパー・クラスによって呼び出されます。サブクラスはこのメソッドを包括してもかまいませんが、オーバーライドしたり直接呼び出したりすることはできません。

オーバーライド:

initialize、クラス: BeanContextSupport

getBeanContextServicesPeer

public BeanContextServices getBeanContextServicesPeer()

このBeanContextServicesSupportに関連付けられているBeanContextServicesを取得します。

戻り値:

このオブジェクトが実装を提供するBeanContextのインスタンス。

createBCSChild

protected BeanContextSupport.BCSChild createBCSChild(Object targetChild,
                                                     Object peer)

サブクラスはこのメソッドをオーバーライドすることにより、セットに子を追加するadd()メソッドやほかのCollectionメソッドをオーバーライドすることなく、Childの独自のサブクラスを挿入することができます。

オーバーライド:

createBCSChild、クラス: BeanContextSupport

パラメータ:

targetChild - 代わりにChildを作成する子

peer - targetChildとピアがBeanContextProxyによって関連付けられている場合はそのピア

createBCSSServiceProvider

protected BeanContextServicesSupport.BCSSServiceProvider createBCSSServiceProvider(Class sc,
                                                                                   BeanContextServiceProvider bcsp)

サブクラスはこのメソッドをオーバーライドすることにより、インスタンス化するためにaddService()をオーバーライドすることなく、BCSSServiceProviderの新しいサブクラスを作成できます。

パラメータ:

sc - クラス

bcsp - サービス・プロバイダ

戻り値:

addService()をオーバーライドしないサービス・プロバイダ

addBeanContextServicesListener

public void addBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListenerを追加します

定義:

addBeanContextServicesListener、インタフェース: BeanContextServices

パラメータ:

bcsl - 追加するBeanContextServicesListener

例外:

NullPointerException - 引数がnullの場合

removeBeanContextServicesListener

public void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListenerを削除します

定義:

removeBeanContextServicesListener、インタフェース: BeanContextServices

パラメータ:

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

addService

public boolean addService(Class serviceClass,
                          BeanContextServiceProvider bcsp)

サービスを追加します。

定義:

addService、インタフェース: BeanContextServices

パラメータ:

serviceClass - サービス・クラス

bcsp - サービス・プロバイダ

戻り値:

サービスの追加が成功した場合はtrue、そうでない場合はfalse

addService

protected boolean addService(Class serviceClass,
                             BeanContextServiceProvider bcsp,
                             boolean fireEvent)

サービスを追加します。

パラメータ:

serviceClass - サービス・クラス

bcsp - サービス・プロバイダ

fireEvent - イベントをトリガーするかどうか

戻り値:

サービスが正常に追加された場合はtrue

revokeService

public void revokeService(Class serviceClass,
                          BeanContextServiceProvider bcsp,
                          boolean revokeCurrentServicesNow)

サービスを削除します。

定義:

revokeService、インタフェース: BeanContextServices

パラメータ:

serviceClass - サービス・クラス

bcsp - サービス・プロバイダ

revokeCurrentServicesNow - サービスを取り消すかどうか

hasService

public boolean hasService(Class serviceClass)

サービスを持ちます。そのサービスは委譲されることもあります。

定義:

hasService、インタフェース: BeanContextServices

パラメータ:

serviceClass - 該当するサービス

戻り値:

サービスが使用可能な場合はtrue

getService

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

サービスを取得します。そのサービスは委譲されることもあります。

定義:

getService、インタフェース: BeanContextServices

パラメータ:

child - このリクエストに関連付けられているBeanContextChild

requestor - サービスをリクエストするオブジェクト

serviceClass - リクエストされたサービスのクラス

serviceSelector - サービス依存パラメータ

bcsrl - そのサービスがあとで取消しになるべき場合に通知するBeanContextServiceRevokedListener

戻り値:

リクエストされた、このコンテキストの指定されたサービスへの参照、またはnull

例外:

TooManyListenersException - リスナーが多すぎる場合

releaseService

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

サービスを解放します。

定義:

releaseService、インタフェース: BeanContextServices

パラメータ:

child - BeanContextChild

requestor - リクエスタ

service - サービス

getCurrentServiceClasses

public Iterator getCurrentServiceClasses()

インタフェースからコピーされた説明: BeanContextServices

このコンテキストに現在使用可能なサービスを取得します。

定義:

getCurrentServiceClasses、インタフェース: BeanContextServices

戻り値:

現在登録されているすべてのサービス・クラスのイテレータ。

getCurrentServiceSelectors

public Iterator getCurrentServiceSelectors(Class serviceClass)

インタフェースからコピーされた説明: BeanContextServices

基本的なBeanContextServiceProviderのgetCurrentServiceSelectors()を呼び出すことによって、指定されたサービスのサービス依存サービス・パラメータ(Service Selectors)のリストを取得します。

定義:

getCurrentServiceSelectors、インタフェース: BeanContextServices

パラメータ:

serviceClass - 指定されたサービス

戻り値:

指定されたサービスで使用可能な、現在登録されているすべてのサービス・セレクタ(存在する場合)のイテレータ。

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcssae)

BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。サブクラスは、このメソッドをオーバーライドするか包括することで、独自の伝達セマンティックスを実装できます。

定義:

serviceAvailable、インタフェース: BeanContextServicesListener

オーバーライド:

serviceAvailable、クラス: BeanContextChildSupport

パラメータ:

bcssae - サービスが使用可能になった結果としてトリガーされたBeanContextServiceAvailableEvent

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcssre)

BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。サブクラスは、このメソッドをオーバーライドするか包括することで、独自の伝達セマンティックスを実装できます。

定義:

serviceRevoked、インタフェース: BeanContextServiceRevokedListener

オーバーライド:

serviceRevoked、クラス: BeanContextChildSupport

パラメータ:

bcssre - サービスの取消しの結果としてトリガーされたBeanContextServiceRevokedEvent

getChildBeanContextServicesListener

protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)

指定された子のBeanContextServicesListener (存在する場合)を取得します。

パラメータ:

child - 指定された子

戻り値:

指定された子のBeanContextServicesListener (存在する場合)

childJustRemovedHook

protected void childJustRemovedHook(Object child,
                                    BeanContextSupport.BCSChild bcsc)

子が正常に削除された後で、スーパー・クラスの子削除操作から呼び出されます。子が同期された状態で呼び出されます。このサブクラスはこのフックを使用して、子によって使用されているサービスを即座に取り消します(BeanContextChildの場合)。サブクラスは、自身の子の削除の副作用を実装するためにこのメソッドを包括できます。

オーバーライド:

childJustRemovedHook、クラス: BeanContextSupport

パラメータ:

child - 子

bcsc - BCSChild

releaseBeanContextResources

protected void releaseBeanContextResources()

入れ子になっているBeanContextから取得したリソースを解放するようBeanContextChildに通知するために、setBeanContextから呼び出されます。このメソッドは親から取得したサービスを取り消します。サブクラスは、独自のセマンティックスを実装するためにこのメソッドをエンベロープできます。

オーバーライド:

releaseBeanContextResources、クラス: BeanContextChildSupport

initializeBeanContextResources

protected void initializeBeanContextResources()

入れ子になっているBeanContextから取得したリソースを割り当てるようBeanContextChildに通知するために、setBeanContextから呼び出されます。サブクラスは、このメソッドを包括することで独自のセマンティックスを実装できます。

オーバーライド:

initializeBeanContextResources、クラス: BeanContextChildSupport

fireServiceAdded

protected final void fireServiceAdded(Class serviceClass)

新しいサービスを通知するBeanContextServiceEventをトリガーします。

パラメータ:

serviceClass - サービス・クラス

fireServiceAdded

protected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)

新しいサービスが利用可能になったことを示すBeanContextServiceAvailableEventをトリガーします。

パラメータ:

bcssae - BeanContextServiceAvailableEvent

fireServiceRevoked

protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)

サービスの取消しを通知するBeanContextServiceEventをトリガーします。

パラメータ:

bcsre - BeanContextServiceRevokedEvent

fireServiceRevoked

protected final void fireServiceRevoked(Class serviceClass,
                                        boolean revokeNow)

特定のサービスが利用できなくなったことを示すBeanContextServiceRevokedEventをトリガーします。

パラメータ:

serviceClass - サービス・クラス

revokeNow - イベントを今すぐ取り消すかどうか

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos)
                                throws IOException

BeanContextSupport writeObjectが子を直列化する前に、BeanContextSupport writeObjectによって呼び出されます。このクラスは、ここにあるどのSerializable BeanContextServiceProvidersも直列化します。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。

オーバーライド:

bcsPreSerializationHook、クラス: BeanContextSupport

パラメータ:

oos - 直列化中に使用するObjectOutputStream

例外:

IOException - 直列化に失敗した場合

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

BeanContextSupport readObjectが子を直列化する前に、BeanContextSupport readObjectによって呼び出されます。このクラスは、以前に直列化されたどのSerializable BeanContextServiceProvidersも直列化復元するので、子は直列化復元されるときにSerializable BeanContextServiceProvidersを使用できます。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。

オーバーライド:

bcsPreDeserializationHook、クラス: BeanContextSupport

パラメータ:

ois - 直列化復元中に使用するObjectInputStream

例外:

IOException - 直列化復元が失敗した場合

ClassNotFoundException - 必要なクラスが見つからない場合