component 要素

コンポーネント全体は、<component> 要素で囲まれます。 1 つのコンポーネントのバージョンはすべて、同じ名前とパスを持つ必要があります。 この要素の構成可能属性は、component 置換変数を参照できます。

component 要素属性

1 非派生コンポーネントにしか認められません。

component access 属性

<component> 要素の「access」属性は、コンポーネントのアクセス可能性を指定するもので、値は PATH と PUBLIC に限定されます。 デフォルトは PUBLIC です。

access が PATH の場合、そのコンポーネントを参照できるのはそのコンポーネントと同じパス内に存在するほかのコンポーネントだけです。 クライアントが当該コンポーネントを直接インストールすることはできず、入れ子になった参照を使用してほかのコンポーネントに当該コンポーネントを含めるしかありません。 access 属性が PUBLIC の場合、このような制限は適用されません。

component modifier 属性

<component> 要素の「modifier」属性は、コンポーネントの優先指定要件を指定します。

ABSTRACT の場合、コンポーネントはインストールできず、 ほかのコンポーネントを拡張するためのベースコンポーネントとしてのみ機能します。 抽象的な子要素を宣言できるのは抽象コンポーネントだけです。

FINAL の場合、コンポーネントをほかのコンポーネントで拡張することはできません。

省略された場合は、コンポーネントの拡張とインストールが行えます。

component platform 属性

<component> 要素の「platform」属性は、当該コンポーネントのインストール先として有効な物理的対象と見なされるホストを含むホストセットの名前を指定します。 この属性を指定しないと、サポートされているプラットフォーム上に存在する RA を含むすべてのホストが有効な物理的対象と見なされます。 この属性を指定する場合は、当該コンポーネントをインストールするプランの物理的対象が、指定されたホストセットに含まれるホストのサブセットでなければなりません。 指定されたホストセットに含まれないホストが物理的対象に存在する場合、これはプラン実行時エラーです。 既存のホストセットに対応しない名前を指定するのも、プラン実行時エラーです。 ここで説明しているプラン実行時エラーは、プリフライトエラーとして報告されます。

component limitToHostSet 属性

<component> 要素の「limitToHostSet」属性は、このプランの有効な対象と見なされるホストを含むホストセットの名前を指定します。 この属性を指定しないと、すべてのホストが有効な対象と見なされます。 この属性を指定する場合、クライアントが指定する対象は、指定されたホストセットに含まれるホストのサブセットでなければなりません。 指定されたホストセットに含まれないホストが対象内に存在する場合、プラン実行時エラーです。 既存のホストセットに対応しない名前を指定するのも、プラン実行時エラーです。 ここで説明するプラン実行時エラーは、プリフライトエラーとして報告されます。

platform 属性と limitToHostSet 属性では、2 つの大きな違いがあります。 1 つ目の違いは、platform は事前定義されたプラットフォームホストセットの 1 つを指定するのに対し、limitToHostSet はユーザー定義のホストセットを指定することです。 したがって、カスタムホストセットに基づいてインストールを制限することを望む場合、クライアントは「imitToHostSet」を使用する必要があります。 2 つ目の違いは、コンポーネントの対象を仮想ホストにした場合、limitToHostSet のテストはその仮想ホストに照らして行われるのに対し、platform のテストはその仮想ホストのルート物理ホストに照らして行われることです。 したがって、limitToHostSet を設定し platform は設定しないという方法をとることで、異なる物理プラットフォーム上に存在する特定の仮想ホスト (複数) にコンポーネントをインストールできます (WebLogic アプリケーションはこの方法を採用)。 platform を設定し limitToHostSet は設定しないようにすると、指定するプラットフォームを持つ物理ホストをルート (親) とする任意のホスト上にコンポーネントをインストールできます。 platform、limitToHostSet とも設定すると、両方の範囲を制約できます。

component 属性の継承

installPath と limitToHostSet を除き、component 属性は継承されません。

installPath 属性は継承され、派生コンポーネントにより無効にはなりません。 しかし、ベースコンポーネントはコンポーネント変数を使用してその値を指定でき、これらの変数の値を無効にできます。

limitToHostSet 属性も継承され、ベースコンポーネントが limitToHostSet を指定しなかった場合だけ派生コンポーネントで無効にできます。 limitToHostSet 値は、クライアントによって管理される可変のエンティティを指定します。このため、ホストセットの関係をプラットフォームと同じように論じることはできません。

platform 属性は継承されません。 しかし、派生コンポーネントの platform 値はベースコンポーネントの platform 値同様一般的ではありません。 派生コンポーネントで platform を指定しない場合は、ベースコンポーネントでも指定しないようにするか、あるいは「any」として指定する必要があります。

component 子要素

1 非派生コンポーネントで必要です。