javax.annotation

Annotation Type Resource

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

资源注释标记应用程序需要的资源。 该注释可以应用于应用程序组件类，或者应用于组件类的字段或方法。 当注释应用于字段或方法时，容器将在初始化组件时将所请求资源的实例注入到应用程序组件中。 如果注释应用于组件类，则注释声明应用程序将在运行时查找的资源。

即使此注释未标记为继承，需要部署工具来检查任何组件类的所有超类，以便在所有超类中发现此注释的所有用途。 所有这些注释实例都指定应用程序组件所需的资源。 请注意，此注释可能会显示在专用字段和超类的方法上; 在这些情况下，容器也需要进行注射。

从以下版本开始：

常见注释1.0

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Resource.AuthenticationType	authenticationType 用于此资源的身份验证类型。
String	description 该资源的描述。
String	lookup 引用指向的资源的名称。
String	mappedName 该资源应映射到的产品特定名称。
String	name 资源的JNDI名称。
boolean	shareable 指示此资源是否可以在此组件与其他组件之间共享。
类<?>	type 资源的Java类型。

Element Detail

name

public abstract String name

资源的JNDI名称。 对于字段注释，默认值为字段名称。 对于方法注释，默认值为与该方法对应的JavaBeans属性名称。 对于类注释，没有默认值，必须指定。

Default:

“”

lookup

public abstract String lookup

引用指向的资源的名称。 它可以使用全局JNDI名称链接到任何兼容的资源。

从以下版本开始：

常见注释1.1

Default:

“”

type

public abstract 类<?> type

资源的Java类型。 对于字段注释，默认是字段的类型。 对于方法注释，默认值是JavaBeans属性的类型。 对于类注释，没有默认值，必须指定。

Default:

java.lang.Object.class

authenticationType

public abstract Resource.AuthenticationType authenticationType

用于此资源的身份验证类型。 可以为表示任何支持类型的连接工厂的资源指定这一点，不能为其他类型的资源指定。

Default:

javax.annotation.Resource.AuthenticationType.CONTAINER

shareable

public abstract boolean shareable

指示此资源是否可以在此组件与其他组件之间共享。 可以为表示任何支持类型的连接工厂的资源指定这一点，不能为其他类型的资源指定。

Default:

真正

mappedName

public abstract String mappedName

该资源应映射到的产品特定名称。 该资源的名称（由name元素定义或默认值）是使用该资源的应用程序组件本地的名称。 （它是JNDI java:comp/env命名空间中的一个名称。）许多应用程序服务器提供了一种将这些本地名称映射到应用程序服务器已知的资源名称的方法。 此映射名称通常是全局 JNDI名称，但可以是任何形式的名称。

应用程序服务器不需要支持任何特定形式或类型的映射名称，也不支持使用映射名称的功能。 映射名称取决于产品，通常依赖于安装。 不使用映射名称是可移植的。

Default:

“”

description

public abstract String description

该资源的描述。 该描述预期是部署应用程序的系统的默认语言。 该描述可以提供给部署者以帮助选择正确的资源。

Default:

“”