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<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
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 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(クラス<?> 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<Object>
getCurrentServiceClasses()
このコンテキストに現在使用可能なサービスを取得します。Iterator<?>
getCurrentServiceSelectors(クラス<?> serviceClass)
基本的なBeanContextServiceProviderのgetCurrentServiceSelectors()を呼び出すことによって、指定されたサービスのサービス依存サービス・パラメータ(Service Selectors)のリストを取得します。Object
getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)
サービスを取得します。そのサービスは委譲されることもあります。boolean
hasService(クラス<?> 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
-
フィールド詳細
-
services
protected transient HashMap<Object,BeanContextServicesSupport.BCSSServiceProvider> servicesprotected transient HashMap services
フィールドへのすべてのアクセスは、そのオブジェクトで同期する必要があります -
serializable
protected transient int serializable直列化可能なBeanContextServceProvider
のインスタンスの数。 -
proxy
protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxyBeanContextServiceProvider
の委譲。 -
bcsListeners
protected transient ArrayList<BeanContextServicesListener> bcsListenersBeanContextServicesListener
オブジェクトのリスト。
-
-
コンストラクタの詳細
-
BeanContextServicesSupport
public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dTime, boolean visible)BeanContextServicesSupportのインスタンスを生成します。
- パラメータ:
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnulllcle
- このBeanContextの現在のロケール。dTime
- 初期状態、設計モードの場合はtrue、実行時の場合はfalse。visible
- 初期状態での可視性。
-
BeanContextServicesSupport
public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dtime)指定されたロケールを使って設計モードでインスタンスを生成します。- パラメータ:
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnulllcle
- このBeanContextの現在のロケール。dtime
- 初期状態、設計モードの場合はtrue、実行時の場合はfalse。
-
BeanContextServicesSupport
public BeanContextServicesSupport(BeanContextServices peer, Locale lcle)指定されたロケールを使ってインスタンスを生成します。- パラメータ:
peer
- 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnulllcle
- この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(クラス<?> 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
インタフェースからコピーされた説明:BeanContextServices
このコンテキストに現在使用可能なサービスを取得します。- 定義:
getCurrentServiceClasses
、インタフェース:BeanContextServices
- 戻り値:
- 現在登録されているすべてのサービス・クラスのイテレータ。
-
getCurrentServiceSelectors
インタフェースからコピーされた説明: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 IOExceptionBeanContextSupport writeObjectが子を直列化する前に、BeanContextSupport writeObjectによって呼び出されます。このクラスは、ここにあるどのSerializable BeanContextServiceProvidersも直列化します。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。- オーバーライド:
bcsPreSerializationHook
、クラス:BeanContextSupport
- パラメータ:
oos
- 直列化中に使用するObjectOutputStream
- 例外:
IOException
- 直列化に失敗した場合
-
bcsPreDeserializationHook
protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundExceptionBeanContextSupport readObjectが子を直列化する前に、BeanContextSupport readObjectによって呼び出されます。このクラスは、以前に直列化されたどのSerializable BeanContextServiceProvidersも直列化復元するので、子は直列化復元されるときにSerializable BeanContextServiceProvidersを使用できます。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。- オーバーライド:
bcsPreDeserializationHook
、クラス:BeanContextSupport
- パラメータ:
ois
- 直列化復元中に使用するObjectInputStream
- 例外:
IOException
- 直列化復元が失敗した場合ClassNotFoundException
- 必要なクラスが見つからない場合
-