Resource (Jakarta EE 8 Specification API)

```
@TargetSE(valueSE={TYPESE,FIELDSE,METHODSE})
 @RetentionSE(valueSE=RUNTIMESE)
 @RepeatableSE(valueSE=Resources.class)
public @interface Resource
```
Resource アノテーションは、アプリケーションが必要とするリソースをマークします。このアノテーションは、アプリケーションコンポーネントクラス、またはコンポーネントクラスのフィールドまたはメソッドに適用できます。アノテーションがフィールドまたはメソッドに適用されると、コンテナーは、コンポーネントが初期化されるときに、リクエストされたリソースのインスタンスをアプリケーションコンポーネントに挿入します。アノテーションがコンポーネントクラスに適用される場合、アノテーションは、アプリケーションが実行時に検索するリソースを宣言します。
このアノテーションは Inherited とマークされていませんが、デプロイツールは、コンポーネントクラスのすべてのスーパークラスを調べて、すべてのスーパークラスでこのアノテーションのすべての使用箇所を見つける必要があります。このようなすべてのアノテーションインスタンスは、アプリケーションコンポーネントに必要なリソースを指定します。このアノテーションは、スーパークラスのプライベートフィールドとメソッドに表示される場合があることに注意してください。これらの場合にも、コンテナーは注入を行う必要があります。
導入:
1.6、共通のアノテーション 1.0

オプション要素のサマリー

オプション要素
修飾子と型	オプションの要素と説明
`Resource.AuthenticationType`	`authenticationType` このリソースに使用する認証型。
`StringSE`	`description` このリソースの説明。
`StringSE`	`lookup` 参照が指すリソースの名前。
`StringSE`	`mappedName` このリソースをマップする必要がある製品固有の名前。
`StringSE`	`name` リソースの JNDI 名。
`boolean`	`shareable` このリソースをこのコンポーネントと他のコンポーネントの間で共有できるかどうかを示します。
`ClassSE<?>`	`type` リソースの Java 型。

- 要素の詳細
  - name
```
public abstract StringSE name
```
    リソースの JNDI 名。フィールドアノテーションの場合、デフォルトはフィールド名です。メソッドアノテーションの場合、デフォルトはメソッドに対応する JavaBeans プロパティ名です。クラスアノテーションの場合、デフォルトはなく、これを指定する必要があります。
    デフォルト:
    ""
- - lookup
```
public abstract StringSE lookup
```
    参照が指すリソースの名前。グローバル JNDI 名を使用して、互換性のあるリソースにリンクできます。
    導入:
    1.7、共通のアノテーション 1.1
    デフォルト:
    ""
- - type
```
public abstract ClassSE<?> type
```
    リソースの Java 型。フィールドアノテーションの場合、デフォルトはフィールドの型です。メソッドアノテーションの場合、デフォルトは JavaBeans プロパティの型です。クラスアノテーションの場合、デフォルトはなく、これを指定する必要があります。
    デフォルト:
    java.lang.Object.class
- - authenticationType
```
public abstract Resource.AuthenticationType authenticationType
```
    このリソースに使用する認証型。これは、サポートされている任意の型の接続ファクトリを表すリソースに指定できます。他の型のリソースには指定しないでください。
    デフォルト:
    javax.annotation.Resource.AuthenticationType.CONTAINER
- - shareable
```
public abstract boolean shareable
```
    このリソースをこのコンポーネントと他のコンポーネントの間で共有できるかどうかを示します。これは、サポートされている任意の型の接続ファクトリを表すリソースに指定できます。他の型のリソースには指定しないでください。
    デフォルト:
    true
- - mappedName
```
public abstract StringSE mappedName
```
    このリソースをマップする必要がある製品固有の名前。mappedName 要素は、リソース参照をアプリケーションサーバーに認識されているリソースの名前にマッピングするために提供されます。マップされた名前は任意の形式にすることができます。
    アプリケーションサーバーは、特定の形式または型のマップ名をサポートする必要はなく、マップ名を使用する機能も必要ありません。マップされた名前は製品に依存し、多くの場合インストールに依存します。マップされた名前を使用することはできません。
    デフォルト:
    ""
- - description
```
public abstract StringSE description
```
    このリソースの説明。説明は、アプリケーションがデプロイされているシステムのデフォルト言語であることが想定されています。説明は、適切なリソースの選択に役立つようにデプロイヤーに提示できます。
    デフォルト:
    ""

アノテーション型 Resource

オプション要素のサマリー

要素の詳細

name

lookup

type

authenticationType

shareable

mappedName

description