モジュール java.desktop

パッケージ 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	childrenハッシュ表内の子ごとの情報を含む保護されたネストされたクラス。
protected class	BeanContextServicesSupport.BCSSProxyServiceProvider	サブクラスは、このネストされたクラスをサブクラス化して、各BeanContextServiceProviderのプロキシを表すことができます。
protected static class	BeanContextServicesSupport.BCSSServiceProvider	サブクラスは、この入れ子構造のクラスをサブクラス化して、各BeanContextServicesProviderの動作を追加できます。

クラスjava.beans.beancontext.BeanContextSupportで宣言されたネストされたクラス/インタフェース

BeanContextSupport.BCSChild, BeanContextSupport.BCSIterator

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
protected ArrayList<BeanContextServicesListener>	bcsListeners	BeanContextServicesListenerオブジェクトのリスト。
protected BeanContextServicesSupport.BCSSProxyServiceProvider	proxy	BeanContextServiceProviderを委任します。
protected int	serializable	直列化可能なBeanContextServceProviderのインスタンス数。
protected HashMap<Object,BeanContextServicesSupport.BCSSServiceProvider>	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 final void	fireServiceAdded(BeanContextServiceAvailableEvent bcssae)	新しいサービスが使用可能になったことを示すBeanContextServiceAvailableEventを起動します。
protected final void	fireServiceAdded(Class<?> serviceClass)	新しいサービスを通知するBeanContextServiceEventを起動します。
protected final void	fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)	サービスが取り消されたことを通知するBeanContextServiceEventを起動します。
protected final void	fireServiceRevoked(Class<?> serviceClass, boolean revokeNow)	特定のサービスが使用できなくなったことを示すBeanContextServiceRevokedEventを起動します。
BeanContextServices	getBeanContextServicesPeer()	このBeanContextServicesSupportに関連付けられたBeanContextServicesを取得します。
protected static final BeanContextServicesListener	getChildBeanContextServicesListener(Object child)	指定された子のBeanContextServicesListener (もしあれば)を取得します。
Iterator<Object>	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, toArray

インタフェースjava.beans.DesignModeで宣言されたメソッド

isDesignTime, setDesignTime

インタフェースjava.lang.Iterableで宣言されたメソッド

forEach

インタフェースjava.beans.Visibilityで宣言されたメソッド

avoidingGui, dontUseGui, needsGui, okToUseGui

フィールド詳細

services

protected transient HashMap<Object,BeanContextServicesSupport.BCSSServiceProvider> services

protected transient HashMap servicesフィールドへのすべてのアクセスは、そのオブジェクトで同期する必要があります

serializable

protected transient int serializable

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

proxy

protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy

BeanContextServiceProviderを委任します。

bcsListeners

protected transient ArrayList<BeanContextServicesListener> 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<Object> 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 - the BeanContextServiceAvailableEvent

fireServiceRevoked

protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)

サービスが取り消されたことを通知するBeanContextServiceEventを起動します。

パラメータ:

bcsre - the 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 - 必要なクラスが見つからない場合