javax.annotation

Annotation Type Resource

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

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

尽管这个注释没有标记遗传，部署工具都需要检查所有的超类的任何组件类发现在所有父类的所有这些注释使用。所有这些注释实例都指定应用程序组件所需的资源。注意，这个注释可以出现在父类的私有字段和方法；容器需要进行注射在这些情况下，以及。

从以下版本开始：

常见的注释1

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:

“”