インタフェースBeanContextServices

すべてのスーパー・インタフェース:
BeanContext, BeanContextChild, BeanContextServiceRevokedListener, BeanContextServicesListener, Collection, DesignMode, EventListener, Iterable, Visibility
既知のすべての実装クラス:
BeanContextServicesSupport
@Deprecated(since="23", forRemoval=true) public interface BeanContextServices extends BeanContext, BeanContextServicesListener
削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。

BeanContextServicesインタフェースは、BeanContextChildオブジェクトがジェネリック・サービスを受けられるようにするためのメカニズムをBeanContextに提供します。

  • フィールドのサマリー

    インタフェースで宣言されたフィールド BeanContext

    globalHierarchyLock
    修飾子と型
    フィールド
    説明
    static final Object
    globalHierarchyLock
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このグローバル・ロックは、BeanContextとBeanContextServicesの両方の実装者がBeanContext階層内での変更やサービス・リクエストなどを直列化するために使用します。

    インタフェースで宣言されたフィールド DesignMode

    PROPERTYNAME
    修飾子と型
    フィールド
    説明
    static final String
    PROPERTYNAME
    BeanContextやほかのPropertyChangeEventsのソースからトリガーされるpropertyNameの標準値です。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    addBeanContextServicesListener(BeanContextServicesListener bcsl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このBeanContextにBeanContextServicesListenerを追加します
    boolean
    addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このBeanContextにサービスを追加します。
    Iterator<?>
    getCurrentServiceClasses()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このコンテキストに現在使用可能なサービスを取得します。
    Iterator<?>
    getCurrentServiceSelectors(Class<?> serviceClass)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    基本的なBeanContextServiceProviderのgetCurrentServiceSelectors()を呼び出すことによって、指定されたサービスのサービス依存サービス・パラメータ(Service Selectors)のリストを取得します。
    Object
    getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    BeanContextChild、またはBeanContextChildに関連した任意のオブジェクトは、このメソッドを呼び出すことによって、入れ子になっているBeanContextServicesから現在登録されているサービスへの参照を取得できます。
    boolean
    hasService(Class<?> serviceClass)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたサービスが現在、このコンテキストから使用可能かどうかを報告します。
    void
    releaseService(BeanContextChild child, Object requestor, Object service)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    ベースとなるBeanContextServiceProviderに対してreleaseService()を呼び出すことにより、BeanContextChild (またはBeanContextChildに関連した任意のオブジェクト)の、指定されたサービスへの参照を解放します。
    void
    removeBeanContextServicesListener(BeanContextServicesListener bcsl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このBeanContextからBeanContextServicesListenerを削除します
    void
    revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    現在登録されているサービスをこのコンテキストから削除するために、BeanContextServiceProvidersは、このメソッドを呼び出して削除できます。

    インタフェースで宣言されたメソッド BeanContext

    addBeanContextMembershipListener, getResource, getResourceAsStream, instantiateChild, removeBeanContextMembershipListener
    修飾子と型
    メソッド
    説明
    void
    addBeanContextMembershipListener(BeanContextMembershipListener bcml)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    子のComponentが追加または削除されたときは必ずこのBeanContextからBeanContextMembershipEventsを受け取るために、指定されたBeanContextMembershipListenerを追加します。
    URL
    getResource(String name, BeanContextChild bcc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    java.lang.ClassLoader.getResource()と同様に、このメソッドを使用すると、子Componentと基礎となるClassLoaderの間の動作をBeanContext実装で置き換えることができます。
    InputStream
    getResourceAsStream(String name, BeanContextChild bcc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    java.lang.ClassLoader.getResourceAsStream()と同様に、このメソッドを使用すると、子Componentと基礎となるClassLoaderの間の動作をBeanContext実装で置き換えることができます。
    Object
    instantiateChild(String beanName)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このBeanContextの子として指定されたJavaBeanをインスタンス化します。
    void
    removeBeanContextMembershipListener(BeanContextMembershipListener bcml)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    子のComponentが追加または削除されたときにBeanContextMembershipEventをこれ以上受け取らないように、指定されたBeanContextMembershipListenerを削除します。

    インタフェースで宣言されたメソッド BeanContextChild

    addPropertyChangeListener, addVetoableChangeListener, getBeanContext, removePropertyChangeListener, removeVetoableChangeListener, setBeanContext
    修飾子と型
    メソッド
    説明
    void
    addPropertyChangeListener(String name, PropertyChangeListener pcl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたプロパティが変更になるたびにPropertyChangeEventを受け取るために、PropertyChangeListenerをこのBeanContextChildに追加します。
    void
    addVetoableChangeListener(String name, VetoableChangeListener vcl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたプロパティが変更になるたびにイベントを受け取るために、VetoableChangeListenerをこのBeanContextChildに追加します。
    BeanContext
    getBeanContext()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このBeanContextChildに関連付けられているBeanContextを取得します。
    void
    removePropertyChangeListener(String name, PropertyChangeListener pcl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    PropertyChangeListenerをこのBeanContextChildから削除して、指定されたプロパティが変更になったときにPropertyChangeEventsを受け取らないようにします。
    void
    removeVetoableChangeListener(String name, VetoableChangeListener vcl)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    VetoableChangeListenerをこのBeanContextChildから削除して、指定されたプロパティが変更になったときにイベントを受け取らないようにします。
    void
    setBeanContext(BeanContext bc)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    このインタフェースを実装するオブジェクトです。次のパラメータを使ってjava.beans.PropertyChangeEventをトリガーします。propertyName "beanContext"、oldValue (以前入れ子になっていたBeanContextインスタンス、またはnull)、newValue (現在入れ子になっているBeanContextインスタンス、またはnull)。

    インタフェースで宣言されたメソッド BeanContextServiceRevokedListener

    serviceRevoked
    修飾子と型
    メソッド
    説明
    void
    serviceRevoked(BeanContextServiceRevokedEvent bcsre)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたサービスが取り消されました。このサービスのgetService要求は満たされなくなります。

    インタフェースで宣言されたメソッド BeanContextServicesListener

    serviceAvailable
    修飾子と型
    メソッド
    説明
    void
    serviceAvailable(BeanContextServiceAvailableEvent bcsae)
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    指定されたサービスが登録されました。このサービスに対するgetService要求を行うことができます。

    インタフェースCollectionで宣言されたメソッド

    add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray, toArray
    修飾子と型
    メソッド
    説明
    boolean
    add(Object e)
    指定された要素がこのコレクションに格納されていることを保証します(オプションの操作)。
    boolean
    addAll(Collection c)
    指定されたコレクションのすべての要素をこのコレクションに追加します(オプションの操作)。
    void
    clear()
    このコレクションからすべての要素を削除します(オプションの操作)。
    boolean
    contains(Object o)
    このコレクションに指定した要素が含まれている場合は、trueを返します。
    boolean
    containsAll(Collection c)
    指定したコレクションのすべての要素がこのコレクションに含まれている場合、trueを返します。
    boolean
    equals(Object o)
    指定されたオブジェクトとこのコレクションが等しいかどうかを比較します。
    int
    hashCode()
    コレクションのハッシュ・コード値を返します。
    boolean
    isEmpty()
    このコレクションに要素がない場合にtrueを返します。
    Iterator
    iterator()
    コレクションの要素のイテレータを返します。
    default Stream
    parallelStream()
    このコレクションをソースとして、潜在的に並列のStreamを返します。
    boolean
    remove(Object o)
    指定された要素のインスタンスがこのコレクションにあれば、そのインスタンスをコレクションから1つ削除します(オプションの操作)。
    boolean
    removeAll(Collection c)
    指定されたコレクションにも格納されているこのコレクションのすべての要素を削除します(オプションの操作)。
    default boolean
    removeIf(Predicate filter)
    指定された述語(オプションの操作)を満たす、このコレクションのすべての要素を削除します。
    boolean
    retainAll(Collection c)
    このコレクションにおいて、指定されたコレクションに格納されている要素だけを保持します(オプションの操作)。
    int
    size()
    このコレクション中の要素の数を返します。
    default Spliterator
    spliterator()
    このコレクション内の要素に対するSpliteratorを作成します。
    default Stream
    stream()
    このコレクションをソースとして使用して、逐次的なStreamを返します。
    Object[]
    toArray()
    このコレクションの要素がすべて格納されている配列を返します。
    default <T> Object[]
    toArray(IntFunction generator)
    指定されたgenerator関数を使用してこのコレクションのすべての要素を含む配列を返し、返された配列を割り当てます。
    <T> Object[]
    toArray(Object[] a)
    このコレクション内のすべての要素を保持する配列を返します。返される配列の実行時の型は、指定された配列の型です。

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

    isDesignTime, setDesignTime
    修飾子と型
    メソッド
    説明
    boolean
    isDesignTime()
    trueはJavaBeansが設計時モードで動作することを示し、falseは実行時の動作を示します。
    void
    setDesignTime(boolean designTime)
    designTimeプロパティの値を設定します。

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

    forEach
    修飾子と型
    メソッド
    説明
    default void
    forEach(Consumer action)
    Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。

    インタフェース可視性で宣言されたメソッド

    avoidingGui, dontUseGui, needsGui, okToUseGui
    修飾子と型
    メソッド
    説明
    boolean
    avoidingGui()
    このBeanがGUIの使用を避けているかどうか判断します。
    void
    dontUseGui()
    GUIを使わないようにBeanに指示します。
    boolean
    needsGui()
    このBeanがGUIを必要とするかどうかを判定します。
    void
    okToUseGui()
    GUIが使えることをBeanに指示します。

  • メソッドの詳細

    • addService

      boolean addService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このBeanContextにサービスを追加します。 BeanContextServiceProviderは、このメソッドを呼び出して、このコンテキストに特定のサービスを登録します。 そのサービスが以前に追加されていない場合、BeanContextServicesはこのサービスをBeanContextServiceProviderと関連付け、現在登録されているすべてのBeanContextServicesListenersにBeanContextServiceAvailableEventをトリガーします。 続いてメソッドはtrueを返し、サービスの追加が完了したことを示します。 指定されたサービスがすでに追加されている場合、このメソッドは単にfalseを返します。
      パラメータ:
      serviceClass - 追加するサービス
      serviceProvider - そのサービスに関連付けられているBeanContextServiceProvider
      戻り値:
      サービスの追加が成功した場合はtrue、そうでない場合はfalse

    • revokeService

      void revokeService(Class<?> serviceClass, BeanContextServiceProvider serviceProvider, boolean revokeCurrentServicesNow)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      現在登録されているサービスをこのコンテキストから削除するために、BeanContextServiceProvidersは、このメソッドを呼び出して削除できます。 サービスの呼出しの際、BeanContextServicesは、現在登録されているBeanContextServiceRevokedListenersおよびBeanContextServicesListenersのリストに、BeanContextServiceRevokedEventをトリガーします。
      パラメータ:
      serviceClass - このBeanContextServicesから取り消すサービス
      serviceProvider - この取り消される特定のサービスに関連付けられているBeanContextServiceProvider
      revokeCurrentServicesNow - trueという値は、BeanContextServiceProviderまたはBeanContextServicesが、指定されたサービスへの現在未処理の参照すべてに対してサービスをただちに終了しようとしている例外状況を示します。

    • hasService

      boolean hasService(Class<?> serviceClass)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      指定されたサービスが現在、このコンテキストから使用可能かどうかを報告します。
      パラメータ:
      serviceClass - 該当するサービス
      戻り値:
      サービスが使用可能な場合はtrue

    • getService

      Object getService(BeanContextChild child, Object requestor, Class<?> serviceClass, Object serviceSelector, BeanContextServiceRevokedListener bcsrl) throws TooManyListenersException
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      BeanContextChild、またはBeanContextChildに関連した任意のオブジェクトは、このメソッドを呼び出すことによって、入れ子になっているBeanContextServicesから現在登録されているサービスへの参照を取得できます。 呼び出されると、このメソッドは、基本的なBeanContextServiceProviderのgetService()メソッドを呼び出すことによってサービスを取得します。
      パラメータ:
      child - このリクエストに関連付けられているBeanContextChild
      requestor - サービスをリクエストするオブジェクト
      serviceClass - リクエストされたサービスのクラス
      serviceSelector - サービス依存パラメータ
      bcsrl - そのサービスがあとで取消しになるべき場合に通知するBeanContextServiceRevokedListener
      戻り値:
      リクエストされた、このコンテキストの指定されたサービスへの参照、またはnull
      スロー:
      TooManyListenersException - リスナーが多すぎる場合

    • releaseService

      void releaseService(BeanContextChild child, Object requestor, Object service)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      ベースとなるBeanContextServiceProviderに対してreleaseService()を呼び出すことにより、BeanContextChild (またはBeanContextChildに関連した任意のオブジェクト)の、指定されたサービスへの参照を解放します。
      パラメータ:
      child - BeanContextChild
      requestor - リクエスタ
      service - サービス

    • getCurrentServiceClasses

      Iterator<?> getCurrentServiceClasses()
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このコンテキストに現在使用可能なサービスを取得します。
      戻り値:
      現在使用可能なサービスで構成されるIterator

    • getCurrentServiceSelectors

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

    • addBeanContextServicesListener

      void addBeanContextServicesListener(BeanContextServicesListener bcsl)
      削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
      このBeanContextにBeanContextServicesListenerを追加します
      パラメータ:
      bcsl - 追加するBeanContextServicesListener

    • removeBeanContextServicesListener

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