javax.annotation
註釋型別 Resource

@Target(value={TYPE,FIELD,METHOD})
@Retention(value=RUNTIME)
public @interface Resource

Resource 註釋標記應用程序所需的資源。此註釋可以應用於應用程序元件類別，或者該元件類別的欄位或方法。如果將該註釋應用於一個欄位或方法，那麼初始化應用程序元件時容器將把所請求資源的一個實例注入其中。如果將該註釋應用於元件類別，則該註釋將宣告一個應用程序在運行時將尋找的資源。

即使此註釋沒有被標記為 Inherited，部署工具仍然需要檢查任意元件類別的所有父級類別，以發現這些父級類別中所有使用此註釋的地方。所有此類別註釋實例都指定了應用程序元件所需的資源。注意，此註釋可能出現在父級類別的 private 欄位和方法上；在這種情況下容器也需要執行注入操作。

從以下版本開始：

Common Annotations 1.0

可選元素摘要

Resource.AuthenticationType	authenticationType 用於此資源的驗證型別。
String	description 此資源的描述。
String	mappedName 此資源應該映射到的特定於產品的名稱。
String	name 資源的 JNDI 名稱。
boolean	shareable 指示是否能在此元件與其他元件之間共享此資源。
Class	type 資源的 Java 型別。

name

public abstract String name

資源的 JNDI 名稱。對於欄位註釋，預設值為欄位名稱。對於方法註釋，預設值為與該方法對應的 JavaBean 屬性名稱。對於類別註釋，沒有預設值，必須指定此項。

預設值：

""

type

public abstract Class type

資源的 Java 型別。對於欄位註釋，預設值為欄位的型別。對於方法註釋，預設值為 JavaBean 屬性的型別。對於類別註釋，沒有預設值，必須指定此項。

預設值：

java.lang.Object.class

authenticationType

public abstract Resource.AuthenticationType authenticationType

用於此資源的驗證型別。可以為表示任何受支持型別的連接處理器的資源指定此方法，不得為其他型別的資源指定。

預設值：

javax.annotation.Resource.AuthenticationType.CONTAINER

shareable

public abstract boolean shareable

指示是否能在此元件與其他元件之間共享此資源。可以為表示任何受支持型別的連接處理器的資源指定此方法，不得為其他型別的資源指定。

預設值：

true

mappedName

public abstract String mappedName

此資源應該映射到的特定於產品的名稱。此資源的名稱（由 name 元素定義或為預設值）是使用該資源的應用程序元件的本地名稱。（它的名稱位於 JNDI java:comp/env 名稱空間中。）許多應用程序伺服器都提供一種方式將這些本地名稱映射到應用程序伺服器已知的資源名稱。此映射的名稱通常是全體 JNDI 名稱，但也可以是任何形式的名稱。

應用程序伺服器不需要支持任何特殊形式或型別的映射名稱，也不需要具有使用映射名稱的能力。映射的名稱與產品有關，並且通常與安裝有關。任何對映射名稱的使用都不可移植。

預設值：

""

description

public abstract String description

此資源的描述。描述應該使用部署應用程序的系統的預設語言。該描述能夠呈現給部署者以說明他們選擇正確的資源。

預設值：

""