クラス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
@Deprecated(since="23", forRemoval=true) public class BeanContextServicesSupport extends BeanContextSupport implements BeanContextServices
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

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

導入されたバージョン:
1.2
関連項目:

  • フィールド詳細

    • services

      protected transient HashMap<Object,BeanContextServicesSupport.BCSSServiceProvider> services
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      protected transient HashMap servicesフィールドへのすべてのアクセスは、そのオブジェクトで同期する必要があります

    • serializable

      protected transient int serializable
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      直列化可能なBeanContextServceProviderのインスタンス数。

    • proxy

      protected transient BeanContextServicesSupport.BCSSProxyServiceProvider proxy
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServiceProviderを委任します。

    • bcsListeners

      protected transient ArrayList<BeanContextServicesListener> bcsListeners
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServicesListenerオブジェクトのリスト。

  • コンストラクタの詳細

    • BeanContextServicesSupport

      public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dTime, boolean visible)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

      パラメータ:
      peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull
      lcle - このBeanContextの現在のロケール。
      dTime - 初期状態、設計モードの場合はtrue、実行時の場合はfalse。
      visible - 初期状態での可視性。

    • BeanContextServicesSupport

      public BeanContextServicesSupport(BeanContextServices peer, Locale lcle, boolean dtime)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたロケールを使って設計モードでインスタンスを生成します。
      パラメータ:
      peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull
      lcle - このBeanContextの現在のロケール。
      dtime - 初期状態、設計モードの場合はtrue、実行時の場合はfalse。

    • BeanContextServicesSupport

      public BeanContextServicesSupport(BeanContextServices peer, Locale lcle)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたロケールを使ってインスタンスを生成します。
      パラメータ:
      peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull
      lcle - このBeanContextの現在のロケール。

    • BeanContextServicesSupport

      public BeanContextServicesSupport(BeanContextServices peer)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ピアを使ってインスタンスを生成します。
      パラメータ:
      peer - 実装の提供先となるピアBeanContext、このオブジェクトが自身のピアである場合はnull

    • BeanContextServicesSupport

      public BeanContextServicesSupport()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ほかのオブジェクトの委譲でないインスタンスを生成します。

  • メソッドの詳細

    • initialize

      public void initialize()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サブクラスの一時的な状態を初期化するために、作成時および直列化復元時にBeanContextSupportのスーパー・クラスによって呼び出されます。サブクラスはこのメソッドを包括してもかまいませんが、オーバーライドしたり直接呼び出したりすることはできません。
      オーバーライド:
      initialize、クラスBeanContextSupport

    • getBeanContextServicesPeer

      public BeanContextServices getBeanContextServicesPeer()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このBeanContextServicesSupportに関連付けられたBeanContextServicesを取得します。
      戻り値:
      このオブジェクトのBeanContextインスタンスが実装を提供しています。

    • createBCSChild

      protected BeanContextSupport.BCSChild createBCSChild(Object targetChild, Object peer)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

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

      オーバーライド:
      createBCSChild、クラスBeanContextSupport
      パラメータ:
      targetChild - 代わりにChildを作成する子
      peer - targetChildとピアがBeanContextProxyによって関連付けられている場合はそのピア
      戻り値:
      コレクション・メソッドをオーバーライドしない、子のサブ型固有のサブクラス

    • createBCSSServiceProvider

      protected BeanContextServicesSupport.BCSSServiceProvider createBCSSServiceProvider(Class<?> sc, BeanContextServiceProvider bcsp)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サブクラスはこのメソッドをオーバーライドすることにより、インスタンス化するためにaddService()をオーバーライドすることなく、BCSSServiceProviderの新しいサブクラスを作成できます。
      パラメータ:
      sc - クラス
      bcsp - サービス・プロバイダ
      戻り値:
      addService()をオーバーライドしないサービス・プロバイダ

    • addBeanContextServicesListener

      public void addBeanContextServicesListener(BeanContextServicesListener bcsl)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServicesListenerを追加します
      定義:
      addBeanContextServicesListener、インタフェースBeanContextServices
      パラメータ:
      bcsl - 追加するBeanContextServicesListener
      例外:
      NullPointerException - 引数がnullの場合

    • removeBeanContextServicesListener

      public void removeBeanContextServicesListener(BeanContextServicesListener bcsl)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServicesListenerを削除します
      定義:
      removeBeanContextServicesListener、インタフェースBeanContextServices
      パラメータ:
      bcsl - このコンテキストから削除するBeanContextServicesListener

    • addService

      public boolean addService(Class<?> serviceClass, BeanContextServiceProvider bcsp)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを追加します。
      定義:
      addService、インタフェースBeanContextServices
      パラメータ:
      serviceClass - サービス・クラス
      bcsp - サービス・プロバイダ
      戻り値:
      サービスの追加が成功した場合はtrue、そうでない場合はfalse

    • addService

      protected boolean addService(Class<?> serviceClass, BeanContextServiceProvider bcsp, boolean fireEvent)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを追加します。
      パラメータ:
      serviceClass - サービス・クラス
      bcsp - サービス・プロバイダ
      fireEvent - イベントをトリガーするかどうか
      戻り値:
      サービスが正常に追加された場合はtrue

    • revokeService

      public void revokeService(Class<?> serviceClass, BeanContextServiceProvider bcsp, boolean revokeCurrentServicesNow)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを削除します。
      定義:
      revokeService、インタフェースBeanContextServices
      パラメータ:
      serviceClass - サービス・クラス
      bcsp - サービス・プロバイダ
      revokeCurrentServicesNow - サービスを取り消すかどうか

    • hasService

      public boolean hasService(Class<?> serviceClass)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを持ちます。そのサービスは委譲されることもあります。
      定義:
      hasService、インタフェースBeanContextServices
      パラメータ:
      serviceClass - 該当するサービス
      戻り値:
      サービスが使用可能な場合はtrue

    • getService

      public Object getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを取得します。そのサービスは委譲されることもあります。
      定義:
      getService、インタフェースBeanContextServices
      パラメータ:
      child - このリクエストに関連付けられているBeanContextChild
      requestor - サービスをリクエストするオブジェクト
      serviceClass - リクエストされたサービスのクラス
      serviceSelector - サービス依存パラメータ
      bcsrl - そのサービスがあとで取消しになるべき場合に通知するBeanContextServiceRevokedListener
      戻り値:
      リクエストされた、このコンテキストの指定されたサービスへの参照、またはnull
      例外:
      TooManyListenersException - リスナーが多すぎる場合

    • releaseService

      public void releaseService(BeanContextChild child, Object requestor, Object service)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスを解放します。
      定義:
      releaseService、インタフェースBeanContextServices
      パラメータ:
      child - BeanContextChild
      requestor - リクエスタ
      service - サービス

    • getCurrentServiceClasses

      public Iterator<Object> getCurrentServiceClasses()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      インタフェースからコピーされた説明: BeanContextServices
      このコンテキストに現在使用可能なサービスを取得します。
      定義:
      getCurrentServiceClasses、インタフェースBeanContextServices
      戻り値:
      現在登録されているすべてのサービス・クラスのイテレータ。

    • getCurrentServiceSelectors

      public Iterator<?> getCurrentServiceSelectors(Class<?> serviceClass)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      インタフェースからコピーされた説明: BeanContextServices
      基本的なBeanContextServiceProviderのgetCurrentServiceSelectors()を呼び出すことによって、指定されたサービスのサービス依存サービス・パラメータ(Service Selectors)のリストを取得します。
      定義:
      getCurrentServiceSelectors、インタフェースBeanContextServices
      パラメータ:
      serviceClass - 指定されたサービス
      戻り値:
      指定されたサービスで使用可能な、現在登録されているすべてのサービス・セレクタ(存在する場合)のイテレータ。

    • serviceAvailable

      public void serviceAvailable(BeanContextServiceAvailableEvent bcssae)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。サブクラスは、このメソッドをオーバーライドするか包括することで、独自の伝達セマンティックスを実装できます。
      定義:
      serviceAvailable、インタフェースBeanContextServicesListener
      オーバーライド:
      serviceAvailable、クラスBeanContextChildSupport
      パラメータ:
      bcssae - サービスが使用可能になった結果としてトリガーされたBeanContextServiceAvailableEvent

    • serviceRevoked

      public void serviceRevoked(BeanContextServiceRevokedEvent bcssre)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextServicesListenerのコールバックです。このBeanContextServiceがまだこのサービスを実装していない場合は、現在登録されているすべてのリスナーおよびBeanContextServicesの子にイベントを送ります。サブクラスは、このメソッドをオーバーライドするか包括することで、独自の伝達セマンティックスを実装できます。
      定義:
      serviceRevoked、インタフェースBeanContextServiceRevokedListener
      オーバーライド:
      serviceRevoked、クラスBeanContextChildSupport
      パラメータ:
      bcssre - サービスの取消しの結果としてトリガーされたBeanContextServiceRevokedEvent

    • getChildBeanContextServicesListener

      protected static final BeanContextServicesListener getChildBeanContextServicesListener(Object child)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定された子のBeanContextServicesListener (もしあれば)を取得します。
      パラメータ:
      child - 指定された子
      戻り値:
      指定された子のBeanContextServicesListener (存在する場合)

    • childJustRemovedHook

      protected void childJustRemovedHook(Object child, BeanContextSupport.BCSChild bcsc)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      子が正常に削除された後で、スーパー・クラスの子削除操作から呼び出されます。子が同期された状態で呼び出されます。 このサブクラスはこのフックを使用して、子によって使用されているサービスを即座に取り消します(BeanContextChildの場合)。サブクラスは、自身の子の削除の副作用を実装するためにこのメソッドを包括できます。
      オーバーライド:
      childJustRemovedHook、クラスBeanContextSupport
      パラメータ:
      child - 子
      bcsc - BCSChild

    • releaseBeanContextResources

      protected void releaseBeanContextResources()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      入れ子になっているBeanContextから取得したリソースを解放するようBeanContextChildに通知するために、setBeanContextから呼び出されます。 このメソッドは親から取得したサービスを取り消します。サブクラスは、独自のセマンティックスを実装するためにこのメソッドをエンベロープできます。
      オーバーライド:
      releaseBeanContextResources、クラスBeanContextChildSupport

    • initializeBeanContextResources

      protected void initializeBeanContextResources()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      入れ子になっているBeanContextから取得したリソースを割り当てるようBeanContextChildに通知するために、setBeanContextから呼び出されます。サブクラスは、このメソッドを包括することで独自のセマンティックスを実装できます。
      オーバーライド:
      initializeBeanContextResources、クラスBeanContextChildSupport

    • fireServiceAdded

      protected final void fireServiceAdded(Class<?> serviceClass)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      新しいサービスを通知するBeanContextServiceEventを起動します。
      パラメータ:
      serviceClass - サービス・クラス

    • fireServiceAdded

      protected final void fireServiceAdded(BeanContextServiceAvailableEvent bcssae)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      新しいサービスが使用可能になったことを示すBeanContextServiceAvailableEventを起動します。
      パラメータ:
      bcssae - the BeanContextServiceAvailableEvent

    • fireServiceRevoked

      protected final void fireServiceRevoked(BeanContextServiceRevokedEvent bcsre)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      サービスが取り消されたことを通知するBeanContextServiceEventを起動します。
      パラメータ:
      bcsre - the BeanContextServiceRevokedEvent

    • fireServiceRevoked

      protected final void fireServiceRevoked(Class<?> serviceClass, boolean revokeNow)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      特定のサービスが使用できなくなったことを示すBeanContextServiceRevokedEventを起動します。
      パラメータ:
      serviceClass - サービス・クラス
      revokeNow - イベントを今すぐ取り消すかどうか

    • bcsPreSerializationHook

      protected void bcsPreSerializationHook(ObjectOutputStream oos) throws IOException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextSupport writeObjectが子を直列化する前に、BeanContextSupport writeObjectによって呼び出されます。このクラスは、ここにあるどのSerializable BeanContextServiceProvidersも直列化します。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。
      オーバーライド:
      bcsPreSerializationHook、クラスBeanContextSupport
      パラメータ:
      oos - 直列化中に使用するObjectOutputStream
      例外:
      IOException - 直列化に失敗した場合

    • bcsPreDeserializationHook

      protected void bcsPreDeserializationHook(ObjectInputStream ois) throws IOException, ClassNotFoundException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextSupport readObjectが子を直列化する前に、BeanContextSupport readObjectによって呼び出されます。このクラスは、以前に直列化されたどのSerializable BeanContextServiceProvidersも直列化復元するので、子は直列化復元されるときにSerializable BeanContextServiceProvidersを使用できます。サブクラスは、このメソッドを包括して、子の直列化より前に行う必要のある自身の直列化処理を挿入できます。
      オーバーライド:
      bcsPreDeserializationHook、クラスBeanContextSupport
      パラメータ:
      ois - 直列化復元中に使用するObjectInputStream
      例外:
      IOException - 直列化復元が失敗した場合
      ClassNotFoundException - 必要なクラスが見つからない場合