| インターフェース | 説明 |
|---|---|
| AfterBeanDiscovery | Bean 検出プロセスが完全に完了し、検出された Bean に関連する定義エラーがないことを検証し、検出された Bean の Bean および ObserverMethod オブジェクトを登録したが、デプロイの問題を検出する前に、コンテナーによって起動される 2 番目のイベントのイベント型。 |
| AfterDeploymentValidation | コンテナーがデプロイの問題がないことを検証した後で、コンテキストを作成するか、リクエストを処理する前にコンテナーによって発生した 3 番目のイベントのイベント型。 |
| AfterTypeDiscovery | このイベント型は、型の検出が完了した後にコンテナーによってスローされます。 |
| Annotated | アノテーションを付けることができる Java プログラム要素を表します。 |
| AnnotatedCallable<X> | Java 型の呼び出し可能なメンバーを表します。 |
| AnnotatedConstructor<X> | Java クラスのコンストラクターを表します。 |
| AnnotatedField<X> | Java クラスのフィールドを表します。 |
| AnnotatedMember<X> | Java 型のメンバーを表します。 |
| AnnotatedMethod<X> | Java 型のメソッドを表します。 |
| AnnotatedParameter<X> | メソッドまたはコンストラクターのパラメーターを表します。 |
| AnnotatedType<X> | Java クラスまたはインターフェースを表します。 |
| Bean<T> | 有効な Bean を表します。 |
| BeanAttributes<T> | BeanAttributes インターフェースは、Bean の基本的な属性を公開します。 |
| BeanManager | ポータブル拡張機能がコンテナーと直接やり取りできるようにします。 |
| BeforeBeanDiscovery | このイベント型は、Bean ディスカバリプロセスが開始する前にコンテナーによってスローされます。 |
| BeforeShutdown | コンテナーがリクエストの処理を完了し、すべてのコンテキストを破棄した後に発生する最後のイベントの型。 |
| CDIProvider | 現在のコンテナーへのアクセスを提供するために CDI プロバイダーによって実装されたインターフェース |
| Decorator<T> | 有効なデコレータを表します。 |
| EventContext<T> | 発生したイベントのコンテキストを表します。 |
| EventMetadata | 監視対象のイベントペイロードに関するメタデータへのアクセスを提供します。 |
| Extension | 拡張機能によって実装されるサービスインターフェース。 |
| InjectionPoint | インジェクションポイントに関するメタデータへのアクセスを提供します。 |
| InjectionTarget<T> | 型のインスタンスに対して依存関係の挿入とライフサイクルコールバックを実行するための操作を提供します。 |
| InjectionTargetFactory<T> | InjectionTargetFactory は、特定の Bean の InjectionTarget を作成できます。 |
| InterceptionFactory<T> | InterceptionFactory を使用すると、メソッド呼び出しがメソッドインターセプターによってインターセプトされ、提供されたインスタンスに転送されるラッパーインスタンスを作成できます。 |
| Interceptor<T> | 有効なインターセプターを表します。 |
| ObserverMethod<T> | |
| PassivationCapable | Bean または Contextual のカスタム実装がパッシベーション対応であることを示します。 |
| Prioritized | このインターフェースを使用すると、一部の SPI 実装でプログラムによって優先順位を変更できます。 |
| ProcessAnnotatedType<X> | コンテナーは、宣言されたアノテーションを読み取る前に、Bean アーカイブで検出した Java クラスまたはインターフェースごとに、この型のイベントを発生させます。 |
| ProcessBean<X> | コンテナーは、 Bean オブジェクトを登録する前に、Bean アーカイブにデプロイされた有効な Bean、インターセプター、デコレーターごとにこの型のイベントを発生させます。 |
| ProcessBeanAttributes<T> | コンテナーは、 Bean オブジェクトを登録する前に、Bean アーカイブにデプロイされた有効な Bean、インターセプタ、デコレータごとにこの型のイベントを発生させます。 |
| ProcessInjectionPoint<T,X> | コンテナーは、実行時にコンテナーによってインスタンス化される可能性のあるインジェクションをサポートするすべての Jakarta EE コンポーネントクラスのすべてのインジェクションポイントに対してこの型のイベントを発生させます。これには、 javax.annotation.ManagedBean、Jakarta Enterprise Bean セッション、またはメッセージ駆動型 Bean、有効化 Bean、有効化インターセプターを使用して宣言されたすべてのマネージド Bean が含まれます。または有効なデコレータ。 |
| ProcessInjectionTarget<X> | コンテナーは、実行時にコンテナーによってインスタンス化される可能性のあるインジェクションをサポートするすべての Jakarta EE コンポーネントクラスに対してこの型のイベントを起動します。これには、 javax.annotation.ManagedBean、Jakarta Enterprise Bean セッションまたはメッセージ駆動型 Bean を使用して宣言されたすべてのマネージド Bean、有効な Bean、有効なインターセプター、有効なデコレーターが含まれます。 |
| ProcessManagedBean<X> | コンテナーは、 Bean オブジェクトを登録する前に、有効になっている管理対象の Bean ごとにこの型のイベントを発生させます。 |
| ProcessObserverMethod<T,X> | コンテナーは、 ObserverMethod オブジェクトを登録する前に、有効な Bean ごとのオブザーバーメソッドごとにこの型のイベントを発生させます。 |
| ProcessProducer<T,X> | コンテナーは、リソースを含む、有効になっている Bean ごとに、プロデューサーメソッドまたはフィールドごとにこの型のイベントを発生させます。 |
| ProcessProducerField<T,X> | コンテナーは、 Bean オブジェクトを登録する前に、有効なプロデューサーフィールドごとにこの型のイベントを発生させます。 |
| ProcessProducerMethod<T,X> | コンテナーは、 Bean オブジェクトを登録する前に、有効なプロデューサーメソッドごとにこの型のイベントを発生させます。 |
| ProcessSessionBean<X> | コンテナーは、 Bean オブジェクトを登録する前に、有効なセッション Bean ごとにこの型のイベントを発生させます。 |
| ProcessSyntheticAnnotatedType<X> | コンテナーは、 BeforeBeanDiscovery.addAnnotatedType(AnnotatedType)、BeforeBeanDiscovery.addAnnotatedType(AnnotatedType, String)、AfterTypeDiscovery.addAnnotatedType(AnnotatedType, String) によって追加された Java クラスまたはインターフェースごとに、この型のイベントを発生させます。 |
| ProcessSyntheticBean<X> | コンテナーは、 Bean オブジェクトを登録する前に、AfterBeanDiscovery.addBean() または AfterBeanDiscovery.addBean(Bean) によって追加されたカスタム Bean 実装ごとにこの型のイベントを発生させます。 |
| ProcessSyntheticObserverMethod<T,X> | コンテナーは、 ObserverMethod オブジェクトを登録する前に、AfterBeanDiscovery.addObserverMethod(ObserverMethod) または AfterBeanDiscovery.addObserverMethod() によって追加された ObserverMethod のカスタム実装ごとにこの型のイベントを発生させます。 |
| Producer<T> | 型のインスタンスを生成するための一般的な操作を提供します。 |
| ProducerFactory<X> | ProducerFactory は、特定の Bean の Producer を作成できます。 |
| クラス | 説明 |
|---|---|
| CDI<T> | 現在のコンテナーへのアクセスを提供します。 |
| Unmanaged<T> | フレームワークおよびライブラリインテグレーターが使用するライフサイクルコールバックのアンマネージインスタンスを挿入および呼び出すためのヘルパークラス。 |
| Unmanaged.UnmanagedInstance<T> | 非コンテキストインスタンスを表します。 |
| 列挙型 | 説明 |
|---|---|
| InterceptionType | ライフサイクルコールバックの種類、Jakarta Enterprise Bean タイムアウトメソッド、またはビジネスメソッドインターセプトを識別します。 |
| SessionBeanType | Jakarta Enterprise Bean セッション Bean の種類を識別します。 |
| 例外 | 説明 |
|---|---|
| DefinitionException | 定義エラーが発生した場合にスローされます。 |
| DeploymentException | デプロイ問題が発生したときにスローされます。 |
| アノテーション型 | 説明 |
|---|---|
| WithAnnotations | WithAnnotations は、ProcessAnnotatedType のイベントパラメーター型を持つ任意のポータブル拡張オブザーバメソッドに適用して、配信されるイベントをフィルタリングできます。 |
ポータブル拡張統合 SPI。
ポータブル拡張機能は、次の方法でコンテナーと統合できます。
ポータブル拡張機能は、プログラムによる API 呼び出しを介してコンテナーと直接やり取りすることがあります。インターフェース BeanManager は、Bean のコンテキスト参照を取得するための操作と、ポータブル拡張機能を使用するための他の多くの操作を提供します。
アプリケーションの初期化プロセス中に、コンテナーは一連のイベントを起動し、ポータブル拡張機能をコンテナーの初期化プロセスと統合できるようにします。これらのイベントのオブザーバーメソッドは、META-INF/services で宣言された拡張機能に属している必要があります。
ライフサイクルイベントには、BeforeBeanDiscovery、AfterBeanDiscovery、AfterDeploymentValidation および BeforeShutdown が含まれます。
インターフェース Bean、Decorator、Interceptor および ObserverMethod は、コンテナーが Bean、インターセプター、デコレーターまたはオブザーバーメソッドのインスタンスを管理するために必要なすべてのものを定義します。
Bean のインスタンスは、有効な Bean ごとに存在します。ポータブル拡張機能は、Bean を実装し、コンテナーに Bean を登録するイベント AfterBeanDiscovery イベントを監視することにより、新しい種類の Bean のサポートを追加できます。ObserverMethod のインスタンスは、有効になっているすべての Bean のすべてのオブザーバーメソッドに対して存在します。ポータブル拡張機能は、ObserverMethod を実装し、コンテナーにインスタンスを登録することによってオブザーバーを追加できます。
ポータブル拡張機能は、コンテナーライフサイクルイベント型 ProcessBean またはそのサブ型の 1 つを監視することによって有効な Bean の存在を通知されるか、イベント型 ProcessObserverMethod を監視することによって有効な Bean のオブザーバーメソッドの存在を通知されます。
ポータブル拡張機能は、XML による構成などの代替メタデータソースを提供する場合があります。
Annotated とそのサブ型を使用すると、移植可能な拡張機能で、Bean クラスに存在するアノテーションをオーバーライドするメタデータを指定できます。ポータブル拡張機能は、インターフェースの実装を担当し、それによってメタデータをコンテナーに公開します。コンテナーは、Java リフレクション API を直接呼び出すのではなく、 Annotated とそのサブインターフェースの操作を使用して、プログラム要素の型とアノテーションを検出する必要があります。
ポータブル拡張機能は、イベント ProcessAnnotatedType を監視し、AnnotatedType をラップすることによって、そのメタデータをコンテナーに提供します。
インターフェース Producer および InjectionTarget は、インスタンス化と破棄、依存性注入、ライフサイクルコールバックを含む、(コンテキストまたは非コンテキスト)コンテナー管理オブジェクトの基本的なライフサイクルを抽象化します。
InjectionTarget のインスタンスは BeanManager から取得でき、ポータブル拡張機能がその制御下にあるオブジェクトに対してこれらのコンテナーサービスをリクエストできるようになります。
さらに、ポータブル拡張機能では、イベント ProcessInjectionTarget または ProcessProducer を監視することにより、コンテナーで使用される InjectionTarget または Producer の実装を独自の実装に置き換えることができます。
Copyright © 2019 Eclipse Foundation.
Use is subject to license terms.