java.beans.beancontext
クラス BeanContextServicesSupport

java.lang.Object
  |
  +--java.beans.beancontext.BeanContextChildSupport
        |
        +--java.beans.beancontext.BeanContextSupport
              |
              +--java.beans.beancontext.BeanContextServicesSupport

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

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

public class BeanContextServicesSupport

extends BeanContextSupport

implements BeanContextServices

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

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

導入されたバージョン:

1.2

関連項目:

直列化された形式

入れ子クラスの概要

protected class	BeanContextServicesSupport.BCSSChild protected nested class containing per child information, an instance of which is associated with each child in the "children" hashtable.
protected class	BeanContextServicesSupport.BCSSProxyServiceProvider a nested subclass used to represent a proxy for serviceClasses delegated to an enclosing BeanContext.
protected static class	BeanContextServicesSupport.BCSSServiceProvider サブクラスは、各 BeanContextServicesProvider に動作を追加するために、この入れ子にされたクラスをサブクラス化することができます。

クラス java.beans.beancontext.BeanContextSupport から継承した入れ子クラス

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 read オブジェクトによる子の直列化復元の前に呼び出されます。
protected void	bcsPreSerializationHook(ObjectOutputStream oos) 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 の現在の Locale

visible - 初期状態での可視性

BeanContextServicesSupport

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

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

パラメータ:

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

lcle - この BeanContext の現在の Locale

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

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer,
                                  Locale lcle)

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

パラメータ:

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

lcle - この BeanContext の現在の Locale

BeanContextServicesSupport

public BeanContextServicesSupport(BeanContextServices peer)

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

パラメータ:

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

BeanContextServicesSupport

public BeanContextServicesSupport()

ほかのオブジェクトのデリゲートでないインスタンスを生成します。

メソッドの詳細

initialize

public void initialize()

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

オーバーライド:

クラス BeanContextSupport 内の initialize

getBeanContextServicesPeer

public BeanContextServices getBeanContextServicesPeer()

この BeanContextServicesSupport に関連した BeanContextServices を取得します。

戻り値:

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

createBCSChild

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

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

オーバーライド:

クラス BeanContextSupport 内の createBCSChild

パラメータ:

targetChild - Child を作成する子

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

createBCSSServiceProvider

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

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

addBeanContextServicesListener

public void addBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListener を追加します。

定義:

インタフェース BeanContextServices 内の addBeanContextServicesListener

パラメータ:

bcsl - 追加する BeanContextServicesListener

removeBeanContextServicesListener

public void removeBeanContextServicesListener(BeanContextServicesListener bcsl)

BeanContextServicesListener を削除します。

定義:

インタフェース BeanContextServices 内の removeBeanContextServicesListener

パラメータ:

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

addService

public boolean addService(Class serviceClass,
                          BeanContextServiceProvider bcsp)

サービスを追加します。

定義:

インタフェース BeanContextServices 内の addService

パラメータ:

bcsp - サービスに関連した BeanContextServiceProvider

addService

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

サービスを追加します。

revokeService

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

サービスを削除します。

定義:

インタフェース BeanContextServices 内の revokeService

パラメータ:

serviceClass - この BeanContextServices から呼び出すサービス

bcsp - 無効になるこの特定のサービスに関連した BeanContextServiceProvider

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

hasService

public boolean hasService(Class serviceClass)

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

定義:

インタフェース BeanContextServices 内の hasService

パラメータ:

serviceClass - 該当するサービス

戻り値:

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

getService

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

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

定義:

インタフェース BeanContextServices 内の getService

パラメータ:

child - この要求に関連した BeanContextChild

requestor - サービスを要求するオブジェクト

serviceClass - 要求されたサービスのクラス

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

bcsrl - サービスを後で無効にする必要がある場合に通知する BeanContextServiceRevokedListener

戻り値:

要求された、このコンテキストの指定された Service への参照、または null

例外:

TooManyListenersException

releaseService

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

サービスを解放します。

定義:

インタフェース BeanContextServices 内の releaseService

パラメータ:

child - BeanContextChild

requestor - 要求者

service - サービス

getCurrentServiceClasses

public Iterator getCurrentServiceClasses()

インタフェース BeanContextServices の記述:

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

定義:

インタフェース BeanContextServices 内の getCurrentServiceClasses

戻り値:

現在登録されているすべてのサービスクラスの反復子

getCurrentServiceSelectors

public Iterator getCurrentServiceSelectors(Class serviceClass)

インタフェース BeanContextServices の記述:

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

定義:

インタフェース BeanContextServices 内の getCurrentServiceSelectors

パラメータ:

serviceClass - 指定されたサービス

戻り値:

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

serviceAvailable

public void serviceAvailable(BeanContextServiceAvailableEvent bcssae)

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

定義:

インタフェース BeanContextServicesListener 内の serviceAvailable

オーバーライド:

クラス BeanContextChildSupport 内の serviceAvailable

パラメータ:

bcssae - BeanContextServiceAvailableEvent

serviceRevoked

public void serviceRevoked(BeanContextServiceRevokedEvent bcssre)

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

定義:

インタフェース BeanContextServiceRevokedListener 内の serviceRevoked

オーバーライド:

クラス BeanContextChildSupport 内の serviceRevoked

パラメータ:

bcssre - このリスナーによって受信された BeanContextServiceRevokedEvent

getChildBeanContextServicesListener

protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)

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

パラメータ:

child - 指定された子

戻り値:

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

childJustRemovedHook

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

子の削除に成功したあと、スーパークラス削除操作から、同期した子とともに呼び出されます。このサブクラスは、BeanContextChild である場合、このフックを使って、この子が使用するすべてのサービスをただちに呼び出します。サブクラスは、子の削除による固有の副作用を実装するため、このメソッドを包括することができます。

オーバーライド:

クラス BeanContextSupport 内の childJustRemovedHook

releaseBeanContextResources

protected void releaseBeanContextResources()

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

オーバーライド:

クラス BeanContextChildSupport 内の releaseBeanContextResources

initializeBeanContextResources

protected void initializeBeanContextResources()

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

オーバーライド:

クラス BeanContextChildSupport 内の initializeBeanContextResources

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 による子の直列化の前に呼び出されます。このクラスは、すべての直列化可能な BeanContextServiceProvider を直列化します。サブクラスはこのメソッドを包み込み、子の直列化の前に行わなければならない直列化処理を挿入できます。

オーバーライド:

クラス BeanContextSupport 内の bcsPreSerializationHook

IOException

bcsPreDeserializationHook

protected void bcsPreDeserializationHook(ObjectInputStream ois)
                                  throws IOException,
                                         ClassNotFoundException

BeanContextSupport read オブジェクトによる子の直列化復元の前に呼び出されます。このクラスは以前に直列化された直列化可能なすべての BeanContextServiceProvider を直列化復元し、子に提供します。サブクラスは子のメソッドを包み込み、子の直列化の前に行わなければならない直列化処理を挿入できます。

オーバーライド:

クラス BeanContextSupport 内の bcsPreDeserializationHook

IOException

ClassNotFoundException