<resourceRef> 要素は <component> 要素の子であり、当該コンポーネントによって管理されるリソースを指定します。 この要素は、<componentRefList> 要素と併用はできません。 この要素およびその子の構成可能属性は、component 置換変数を参照できます。
リソースは、暗黙の PUBLIC アクセスモードとなります。
コンポーネントが単純コンポーネントから派生する場合、あるいは <resourceRef> 要素を含む非派生コンポーネントである場合、そのコンポーネントは単純コンポーネントと見なされます。 派生コンポーネントが単純コンポーネントから派生している場合、その派生コンポーネントに含めることができるのは <resourceRef> 要素だけです。
名前 |
型 |
必須 |
構成可能 |
説明 |
---|---|---|---|---|
modifier |
modifierEnum |
いいえ |
不可 |
リソースの修飾子 (詳細は下記) |
<resourceRef> 要素の「modifier」属性は、リソースの優先指定要件を指定します。
ABSTRACT の場合、resourceRef <resource> 要素は省略されます。このため、この要素は非抽象派生コンポーネントによって指定する必要があります。 ResourceRefs を抽象と宣言できるのは、コンポーネントも抽象と宣言されている場合だけです。 非抽象 resourceRefs は、<resource> 要素を宣言する必要があります。
FINAL の場合、派生コンポーネントで resourceRef を無効にすることはできません。
指定しない場合、派生コンポーネントは resourceRef を無効にするかどうかを選択できます。
名前 |
数 |
説明 |
---|---|---|
installSpec |
1 1 |
リソースのインストール方法を指定する |
resource |
1 2 |
関連付けられたリソースを特定する |
1 非派生コンポーネントにしか認められません。 2 抽象的なリソースには含めることができません。
デフォルトでは、派生コンポーネントはそのベースコンポーネントの <resourceRef> 要素を継承します。
派生コンポーネントは、<resourceRef> 要素を宣言し直すことによって、継承された非最終 <resourceRef> 要素の修飾子と <resource> 要素を無効にできます。 <resourceRef> 要素が無効にされる際に、<installSpec> 要素は除外されます。これはそのコンテンツが無効にされないためです。 <resource> 要素が指定されるのは、優先する <resourceRef> が抽象でない場合だけです。
<resourceRef> が無効にされる際に、ベースコンポーネント内の使用も含め、リソースの使用 (<deployResource>、 <addResource> など) はすべて無効にされた値に解決処理されます。
派生コンポーネントが非抽象と宣言された場合で、ベースコンポーネントの <resourceRef> 要素が抽象のとき、その派生コンポーネントは <resourceRef> 要素を無効にする必要があります。