モジュール java.desktop
パッケージ java.beans.beancontext

クラスBeanContextServicesSupport

    • コンストラクタの詳細

      • 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()をオーバーライドしないサービス・プロバイダ

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