インターフェース ComponentDefinition

いくつかの構成コンテキストで提示される、BeanDefinitions および BeanReferences のセットの論理ビューを記述するインターフェース。

pluggable custom XML tags の導入により、単一の論理構成エンティティ (この場合は XML タグ) で複数の BeanDefinitions および RuntimeBeanReferences を作成できるようになり、エンドユーザーに、より簡潔な構成と大きな利便性を提供できるようになりました。そのため、各構成エンティティ (たとえば、XML タグ) が 1 つの BeanDefinition にマップされるとは想定できなくなりました。Spring アプリケーションの構成を視覚化またはサポートしたいツールベンダーやその他のユーザーにとって、エンドユーザーにとって具体的な意味を持つ方法で、BeanFactory の BeanDefinitions を構成データに結び付けるメカニズムが存在していることが重要です。そのため、NamespaceHandler 実装では、構成されている各論理エンティティの ComponentDefinition の形式でイベントを公開できます。その後、サードパーティが subscribe to these events を実行して、Bean メタデータのユーザー中心のビューを作成できます。

各 ComponentDefinition には、構成固有の source object があります。XML ベースの構成の場合、これは通常、ユーザー指定の構成情報を含む NodeSE です。これに加えて、ComponentDefinition に含まれる各 BeanDefinition には独自の source object があり、異なるより具体的な構成データのセットを指す場合があります。これを超えると、PropertyValues などの Bean メタデータの個々の部分にも、さらに詳細なレベルを提供するソースオブジェクトが含まれる場合があります。ソースオブジェクトの抽出は、必要に応じてカスタマイズできる SourceExtractor を介して処理されます。

重要な BeanReferences への直接アクセスは getBeanReferences() を介して提供されますが、ツールはすべての BeanDefinitions をインスペクションして、BeanReferences のフルセットを収集したい場合があります。実装は、論理エンティティ全体の構成を検証するために必要なすべての BeanReferences と、構成の完全なユーザー視覚化を提供するために必要なものを提供する必要があります。特定の BeanReferences は、検証または構成のユーザービューにとって重要ではないことが予想されるため、これらは省略できます。ツールは、付属の BeanDefinitions から供給された追加の BeanReferences を表示したい場合がありますが、これは一般的なケースとは見なされません。

ツールは、role identifier をチェックすることにより、含まれている BeanDefinitions の重要性を判別できます。このロールは基本的に、構成プロバイダーが BeanDefinition がエンドユーザーにとってどれほど重要であると信じているかについてのツールへのヒントです。ツールは、ロールに基づいてフィルタリングする代わりに、特定の ComponentDefinition のすべての BeanDefinitions を表示しないことが予想されます。ツールは、このフィルタリングユーザーを構成可能にすることを選択できます。INFRASTRUCTURE role identifier には特に注意が必要です。このロールで分類された BeanDefinitions は、エンドユーザーにとってまったく重要ではなく、内部実装上の理由でのみ必要です。