257 lines
10 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.annotation
</div>
<h2 class="title" title="Annotation Type Resource">Annotation Type Resource</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre><a href="../../java/lang/annotation/Target.html" title="annotation in java.lang.annotation">@Target</a>(<a href="../../java/lang/annotation/Target.html#value--">value</a>={<a href="../../java/lang/annotation/ElementType.html#TYPE">TYPE</a>,<a href="../../java/lang/annotation/ElementType.html#FIELD">字段</a>,<a href="../../java/lang/annotation/ElementType.html#METHOD">METHOD</a>})
<a href="../../java/lang/annotation/Retention.html" title="annotation in java.lang.annotation">@Retention</a>(<a href="../../java/lang/annotation/Retention.html#value--">value</a>=<a href="../../java/lang/annotation/RetentionPolicy.html#RUNTIME">RUNTIME</a>)
public @interface <span class="memberNameLabel">Resource</span></pre>
<div class="block">
<span>资源注释标记应用程序需要的资源。</span>
<span>该注释可以应用于应用程序组件类,或者应用于组件类的字段或方法。</span>
<span>当注释应用于字段或方法时,容器将在初始化组件时将所请求资源的实例注入到应用程序组件中。</span>
<span>如果注释应用于组件类,则注释声明应用程序将在运行时查找的资源。</span>
<p> <span>即使此注释未标记为继承,需要部署工具来检查任何组件类的所有超类,以便在所有超类中发现此注释的所有用途。</span> <span>所有这些注释实例都指定应用程序组件所需的资源。</span> <span>请注意,此注释可能会显示在专用字段和超类的方法上;</span> <span>在这些情况下,容器也需要进行注射。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
常见注释1.0
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== ANNOTATION TYPE OPTIONAL MEMBER SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.optional.element.summary">
<!-- --> </a> <h3>Optional Element Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Optional Element Summary table, listing optional elements, and an explanation">
<caption>
<span>Optional Elements</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Optional Element and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../javax/annotation/Resource.AuthenticationType.html" title="enum in javax.annotation">Resource.AuthenticationType</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#authenticationType--">authenticationType</a></span></code>
<div class="block">
用于此资源的身份验证类型。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#description--">description</a></span></code>
<div class="block">
该资源的描述。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#lookup--">lookup</a></span></code>
<div class="block">
引用指向的资源的名称。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#mappedName--">mappedName</a></span></code>
<div class="block">
该资源应映射到的产品特定名称。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#name--">name</a></span></code>
<div class="block">
资源的JNDI名称。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#shareable--">shareable</a></span></code>
<div class="block">
指示此资源是否可以在此组件与其他组件之间共享。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/annotation/Resource.html#type--">type</a></span></code>
<div class="block">
资源的Java类型。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ ANNOTATION TYPE MEMBER DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.element.detail">
<!-- --> </a> <h3>Element Detail</h3> <a name="name--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>name</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a> name</pre>
<div class="block">
<span>资源的JNDI名称。</span>
<span>对于字段注释,默认值为字段名称。</span>
<span>对于方法注释默认值为与该方法对应的JavaBeans属性名称。</span>
<span>对于类注释,没有默认值,必须指定。</span>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
“”
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="lookup--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>lookup</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a> lookup</pre>
<div class="block">
<span>引用指向的资源的名称。</span>
<span>它可以使用全局JNDI名称链接到任何兼容的资源。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
常见注释1.1
</dd>
</dl>
<dl>
<dt>
Default:
</dt>
<dd>
“”
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="type--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>type</h4> <pre>public abstract <a href="../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt; type</pre>
<div class="block">
<span>资源的Java类型。</span>
<span>对于字段注释,默认是字段的类型。</span>
<span>对于方法注释默认值是JavaBeans属性的类型。</span>
<span>对于类注释,没有默认值,必须指定。</span>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
java.lang.Object.class
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="authenticationType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>authenticationType</h4> <pre>public abstract <a href="../../javax/annotation/Resource.AuthenticationType.html" title="enum in javax.annotation">Resource.AuthenticationType</a> authenticationType</pre>
<div class="block">
<span>用于此资源的身份验证类型。</span>
<span>可以为表示任何支持类型的连接工厂的资源指定这一点,不能为其他类型的资源指定。</span>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
javax.annotation.Resource.AuthenticationType.CONTAINER
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="shareable--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>shareable</h4> <pre>public abstract boolean shareable</pre>
<div class="block">
<span>指示此资源是否可以在此组件与其他组件之间共享。</span>
<span>可以为表示任何支持类型的连接工厂的资源指定这一点,不能为其他类型的资源指定。</span>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
真正
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="mappedName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>mappedName</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a> mappedName</pre>
<div class="block">
<span>该资源应映射到的产品特定名称。</span>
<span>该资源的名称(由<code>name</code>元素定义或默认值)是使用该资源的应用程序组件本地的名称。</span>
<span>它是JNDI <code>java:comp/env</code>命名空间中的一个名称。)许多应用程序服务器提供了一种将这些本地名称映射到应用程序服务器已知的资源名称的方法。</span>
<span>此映射名称通常是<i>全局</i> JNDI名称但可以是任何形式的名称。</span>
<p> <span>应用程序服务器不需要支持任何特定形式或类型的映射名称,也不支持使用映射名称的功能。</span> <span>映射名称取决于产品,通常依赖于安装。</span> <span>不使用映射名称是可移植的。</span> </p>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
“”
</dd>
</dl> </li>
</ul> </li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="description--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>description</h4> <pre>public abstract <a href="../../java/lang/String.html" title="class in java.lang">String</a> description</pre>
<div class="block">
<span>该资源的描述。</span>
<span>该描述预期是部署应用程序的系统的默认语言。</span>
<span>该描述可以提供给部署者以帮助选择正确的资源。</span>
</div>
<dl>
<dt>
Default:
</dt>
<dd>
“”
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>