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

インタフェース 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 の新しいサブクラスを生成することができます。

addBeanContextServicesListener

public void addBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListener を追加します。

定義:

addBeanContextServicesListener、インタフェース: BeanContextServices

パラメータ:

bcsl - 追加する BeanContextServicesListener

例外:

NullPointerException

removeBeanContextServicesListener

public void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListener を削除します。

定義:

removeBeanContextServicesListener、インタフェース: BeanContextServices

パラメータ:

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

addService

public boolean addService(Class serviceClass,
                 BeanContextServiceProvider bcsp)

サービスを追加します。

定義:

addService、インタフェース: BeanContextServices

パラメータ:

serviceClass - 追加するサービス

bcsp - そのサービスに関連付けられている BeanContextServiceProvider

addService

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

サービスを追加します。

revokeService

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

サービスを削除します。

定義:

revokeService、インタフェース: BeanContextServices

パラメータ:

serviceClass - この BeanContextServices から取り消すサービス

bcsp - この取り消される特定のサービスに関連付けられている BeanContextServiceProvider

revokeCurrentServicesNow - true という値は、BeanContextServiceProvider または BeanContextServices が、指定されたサービスへの現在未処理の参照すべてに対してサービスをただちに終了しようとしている例外状況を示します。

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

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 をトリガーします。

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 をトリガーします。

bcsPreSerializationHook

protected void bcsPreSerializationHook(ObjectOutputStream oos)
                                throws IOException

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

オーバーライド:

bcsPreSerializationHook、クラス: BeanContextSupport

例外:

IOException

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

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

オーバーライド:

bcsPreDeserializationHook、クラス: BeanContextSupport

例外:

IOException

ClassNotFoundException