jndi.html

Sun Java System Application Server Enterprise Edition 8.1 管理指南

关于自定义资源
</h2>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp201729"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201759" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201759">使用自定义资源</a></li></div>
<a name="wp201735"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201791" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201791">创建自定义资源</a></li></div>
<a name="wp201741"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201845" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201845">编辑自定义资源</a></li></div>
<a name="wp201747"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201889" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201889">删除自定义资源</a></li></div>
<a name="wp201753"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201933" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201933">列出自定义资源</a></li></div>
</ul></div>
<a name="wp201759"> </a><h3 class="pHeading2">
使用自定义资源
</h3>
<a name="wp201763"> </a><p class="pParagraph">
自定义资源访问本地 JNDI 系统信息库，外部资源访问外部 JNDI 系统信息库。这两种类型的资源都需要用户指定的工厂类元素、JNDI 名称属性等。在本节中，我们将讨论如何为 J2EE 资源配置 JNDI 连接工厂资源，以及如何访问这些资源。
</p>
<a name="wp201765"> </a><p class="pParagraph">
在 Application Server 中，您可以创建、删除和列出资源以及 list-jndi-entities。
</p>
<a name="wp201791"> </a><h3 class="pHeading2">
创建自定义资源
</h3>
<a name="wp201793"> </a><p class="pParagraph">
要创建自定义资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp201799"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Sun Java System Application Server 实例。</li></div>
<a name="wp201801"> </a><div class="pSmartList1"><li>打开“JNDI”标签，并单击“自定义资源”。任何已经创建的自定义资源会在右侧窗格中列出。要创建新的自定义资源，单击“新建”。打开“JNDI”选项卡，并单击“新建”。将显示一个页面，用于添加新的自定义资源。</li></div>
<a name="wp201803"> </a><div class="pSmartList1"><li>在“JNDI 名称”字段中，输入用于访问资源的名称。此名称将注册到 JNDI 命名服务中。</li></div>
<a name="wp201805"> </a><div class="pSmartList1"><li>在“资源类型”字段中，输入全限定的类型定义，如上面示例中所示。“资源类型”定义遵循的格式为 <code class="cCode">xxx.xxx</code>。</li></div>
<a name="wp201807"> </a><div class="pSmartList1"><li>在“工厂类”字段中，为要创建的自定义资源输入工厂类名称。该字段中的值是用户指定的工厂类的名称。此类实现了 <code class="cCode">javax.naming.spi.ObjectFactory</code> 接口。</li></div>
<a name="wp201809"> </a><div class="pSmartList1"><li>在“说明”字段中，为要创建的资源输入说明。此说明是字符串值，最多可以包含 250 个字符。</li></div>
<a name="wp201811"> </a><div class="pSmartList1"><li>在“其他属性”部分，添加属性名称和值。</li></div>
<a name="wp201813"> </a><div class="pSmartList1"><li>标记“已启用自定义资源”复选框，以启用自定义资源。</li></div>
<a name="wp201815"> </a><div class="pSmartList1"><li>单击“OK”保存自定义资源。</li></div>
</ol></div>
<a name="wp201817"> </a><p class="pParagraph">
如果已在群集或独立实例上部署自定义资源，则可以使用“目标”选项卡管理目标。此选项卡将在创建自定义资源之后显示。通过输入目标名称并单击“确定”来设置目标。
</p>
<a name="wp201819"> </a><p class="pParagraph">
等效的 asadmin 命令为：create-custom-resource。
</p>
<a name="wp201845"> </a><h3 class="pHeading2">
编辑自定义资源
</h3>
<a name="wp201849"> </a><p class="pParagraph">
要编辑自定义资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp201855"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Sun Java System Application Server 实例。</li></div>
<a name="wp201857"> </a><div class="pSmartList1"><li>打开“JNDI”并选择“自定义资源”。任何已经创建的自定义资源会在右侧窗格中列出。要编辑自定义资源，请在右侧窗格中单击文件名。 </li></div>
<a name="wp201859"> </a><div class="pSmartList1"><li>编辑“资源类型”字段、“工厂类”字段或“说明”字段。</li></div>
<a name="wp201861"> </a><div class="pSmartList1"><li>选中“启用自定义资源”复选框，将启用自定义资源。</li></div>
<a name="wp201863"> </a><div class="pSmartList1"><li>单击“保存”以保存对自定义资源的更改。</li></div>
</ol></div>
<a name="wp201889"> </a><h3 class="pHeading2">
删除自定义资源 
</h3>
<a name="wp201893"> </a><p class="pParagraph">
要删除自定义资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp201899"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，打开“JNDI”选项卡。</li></div>
<a name="wp201901"> </a><div class="pSmartList1"><li>单击“自定义资源”。任何已经创建的自定义资源会在右侧窗格中列出。要删除自定义资源，请单击要删除的资源名称旁边的框。 </li></div>
<a name="wp201903"> </a><div class="pSmartList1"><li>单击“删除”。此自定义资源即被删除。</li></div>
</ol></div>
<a name="wp201907"> </a><p class="pParagraph">
等效的 asadmin 命令为：delete-custom-resource。
</p>
<a name="wp201933"> </a><h3 class="pHeading2">
列出自定义资源
</h3>
<a name="wp201939"> </a><p class="pParagraph">
要列出自定义资源，请键入 <code class="cCode">asadmin ist-custom-resources</code> 命令。例如，要列出主机 plum 上的自定义资源，请键入以下命令：
</p>
<a name="wp201941"> </a><p class="pParagraph">
<code class="cCode">$asadmin list-custom-resource --</code><em class="cEmphasis">host plum</em><code class="cCode"> target6</code>
</p>
<a name="wp201943"> </a><p class="pParagraph">
要查看完整的上下文，请键入 <code class="cCode">asadmin help list-custom-resources</code>。 
</p>
<a name="wp201947"> </a><h2 class="pHeading1">
<hr />
关于外部 JNDI 系统信息库和资源
</h2>
<div class="pSmartList1"><ul class="pSmartList1">
<a name="wp201953"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201983" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201983">使用外部 JNDI 系统信息库和资源</a></li></div>
<a name="wp201959"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp201999" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp201999">创建外部资源</a></li></div>
<a name="wp201965"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp202053" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp202053">编辑外部资源</a></li></div>
<a name="wp201971"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp202091" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp202091">删除外部资源</a></li></div>
<a name="wp201977"> </a><div class="pSmartList1"><li><a  href="jndi.html#wp202129" tppabs="http://docs.sun.com/source/819-1553/jndi.html#wp202129">列出外部资源</a></li></div>
</ul></div>
<a name="wp201983"> </a><h3 class="pHeading2">
使用外部 JNDI 系统信息库和资源
</h3>
<a name="wp201987"> </a><p class="pParagraph">
通常，在 Sun Java System Application Server 上运行的应用程序需要访问存储在外部 JNDI 系统信息库中的资源。例如，一般的 Java 对象可能会以 Java 模式存储在 LDAP 服务器中。外部 JNDI 资源元素允许用户配置此类外部资源系统信息库。外部 JNDI 工厂必须实现 <code class="cCode">javax.naming.spi.InitialContextFactory</code> 接口。 
</p>
<a name="wp201989"> </a><p class="pParagraph">
使用外部 JNDI 资源的示例：
</p>
<a name="wp201991"> </a><code class="pCodeline">
&lt;resources&gt; <br />&lt;!-- external-jndi-resource 元素指定如何访问存储在外部<br />-- JNDI 系统信息库中的 J2EE 资源。下面的示例<br />-- 说明如何访问 LDAP 中存储的 Java 对象。 <br />-- factory-class 元素指定了访问资源工厂时所需的<br />-- JNDI InitialContext 工厂。属性元素<br />-- 与适用于外部 JNDI 上下文的环境相匹配，<br />-- jndi-lookup-name 引用 JNDI 名称，查找并获取<br />-- 指定的（在此示例中为 java）对象。 <br />--&gt; <br />&lt;external-jndi-resource jndi-name=&quot;test/myBean&quot;<br />jndi-lookup-name=&quot;cn=myBean&quot;<br />res-type=&quot;test.myBean&quot;<br />factory-class=&quot;com.sun.jndi.ldap.LdapCtxFactory&quot;&gt; 
</code>
<a name="wp201993"> </a><code class="pCodeline">
&lt;property name=&quot;PROVIDER-URL&quot; value=&quot;ldap://ldapserver:389/o=myObjects&quot; /&gt; <br />&lt;property name=&quot;SECURITY_AUTHENTICATION&quot; value=&quot;simple&quot; /&gt; <br />&lt;property name=&quot;SECURITY_PRINCIPAL&quot;, value=&quot;cn=joeSmith, o=Engineering&quot; /&gt; <br />&lt;property name=&quot;SECURITY_CREDENTIALS&quot; value=&quot;changeit&quot; /&gt; <br />&lt;/external-jndi-resource&gt; <br />&lt;/resources&gt; 
</code>
<a name="wp201999"> </a><h3 class="pHeading2">
创建外部资源
</h3>
<a name="wp202003"> </a><p class="pParagraph">
要创建外部资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp202009"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Sun Java System Application Server 实例。</li></div>
<a name="wp202011"> </a><div class="pSmartList1"><li>打开“JNDI”并选择“外部资源”。任何已经创建的外部资源会在右侧窗格中列出。要创建新的外部资源，单击“New”。 </li></div>
<a name="wp202013"> </a><div class="pSmartList1"><li>在“JNDI Name”字段中，输入要访问资源的名称。此名称将登记到 JNDI 命名服务中。</li></div>
<a name="wp202015"> </a><div class="pSmartList1"><li>在“资源类型”字段中，输入全限定的类型定义，如上面示例中所示。“资源类型”定义遵循的格式为 <code class="cCode">xxx.xxx</code>。</li></div>
<a name="wp202017"> </a><div class="pSmartList1"><li>在“JNDI Lookup”字段中，输入要在外部系统信息库中查找的 JNDI 值。例如，在创建一个与外部系统信息库连接的外部资源时，为了测试某个 Bean 类，“JNDI 查找”可能会如下所示：<code class="cCode">cn=</code><em class="cEmphasis">testmybean</em>。</li></div>
<a name="wp202019"> </a><div class="pSmartList1"><li>在“Factory Class”字段中，输入 JNDI 工厂类外部系统信息库（例如，<code class="cCode">com.sun.jndi.ldap</code>）。此类实现了 javax.naming.spi.<code class="cCode"> ObjectFactory</code> 接口。</li></div>
<a name="wp202021"> </a><div class="pSmartList1"><li>在“说明”字段中，为要创建的资源输入说明。此说明是字符串值，最多可以包含 250 个字符。</li></div>
<a name="wp202023"> </a><div class="pSmartList1"><li>在“其他属性”部分，添加属性名称和值。</li></div>
<a name="wp202025"> </a><div class="pSmartList1"><li>标记“已启用外部资源”复选框，以启用外部资源。</li></div>
<a name="wp202027"> </a><div class="pSmartList1"><li>单击“确定”以保存外部资源。</li></div>
</ol></div>
<a name="wp202029"> </a><p class="pParagraph">
如果已在群集或独立实例上部署外部资源，则可以使用“目标”选项卡管理目标。此选项卡将在创建外部资源之后显示。通过输入目标名称并单击“确定”来设置目标。
</p>
<a name="wp202033"> </a><p class="pParagraph">
等效的 asadmin 命令为：<code class="cCode">create-jndi-resource</code>。 
</p>
<a name="wp202053"> </a><h3 class="pHeading2">
编辑外部资源
</h3>
<a name="wp202057"> </a><p class="pParagraph">
要编辑外部资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp202063"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Sun Java System Application Server 实例。</li></div>
<a name="wp202065"> </a><div class="pSmartList1"><li>打开“JNDI”并选择“外部资源”。任何已经创建的外部资源会在右侧窗格中列出。要编辑外部资源，请在右侧窗格中单击文件名。 </li></div>
<a name="wp202067"> </a><div class="pSmartList1"><li>编辑“资源类型”字段、“JNDI 查找”字段、“工厂类”字段或“说明”字段。</li></div>
<a name="wp202069"> </a><div class="pSmartList1"><li>选中“已启用外部资源”复选框，将启用外部资源。</li></div>
<a name="wp202071"> </a><div class="pSmartList1"><li>单击“保存”以保存对外部资源的更改。</li></div>
</ol></div>
<a name="wp202091"> </a><h3 class="pHeading2">
删除外部资源
</h3>
<a name="wp202095"> </a><p class="pParagraph">
要删除外部资源，请执行以下步骤：
</p>
<div class="pSmartList1"><ol type="1" class="pSmartList1">
<a name="wp202101"> </a><div class="pSmartList1"><li>在管理控制台的左侧窗格中，打开“JNDI”选项卡。</li></div>
<a name="wp202103"> </a><div class="pSmartList1"><li>单击“外部资源”。任何已经创建的外部资源会在右侧窗格中列出。要删除外部资源，请单击要删除的资源名称旁边的框。 </li></div>
<a name="wp202105"> </a><div class="pSmartList1"><li>单击“删除”。此外部资源即被删除。</li></div>
</ol></div>
<a name="wp202109"> </a><p class="pParagraph">
等效的 asadmin 命令为 delete-jndi-resource。 
</p>
<a name="wp202129"> </a><h3 class="pHeading2">
列出外部资源 
</h3>
<a name="wp202133"> </a><p class="pParagraph">
要列出外部资源，请键入 <code class="cCode">asadmin list-jndi-resources</code> 命令并指定 JNDI 名称。例如，键入以下命令可以列出外部资源：
</p>
<a name="wp202135"> </a><p class="pParagraph">
<code class="cCode">$asadmin list-jndi-resources -- </code><em class="cEmphasis">target plum</em><code class="cCode"> jndi_name_test</code>
</p>
<a name="wp202137"> </a><p class="pParagraph">
要查看完整的上下文，请键入 <code class="cCode">asadmin help list-jndi-resources</code>。 
</p>
<a name="wp202139"> </a><p class="pParagraph">

</p>

<!-- end chapter content -->




<!-- footer -->
<!-- navigation -->
<br />
<br />
  <table width="100%" border="0" cellspacing="4" summary="Footer navigation table">
    <tr><td>
    <p class="pNavigation">
    <a href="javamail.html" tppabs="http://docs.sun.com/source/819-1553/javamail.html">上一页</a>
    &#160;&#160;&#160;&#160;
 
    <a href="index.html" tppabs="http://docs.sun.com/source/819-1553/index.html">目录</a>
    &#160;&#160;&#160;&#160;

    <a href="connector.html" tppabs="http://docs.sun.com/source/819-1553/connector.html">下一页</a>
    &#160;&#160;&#160;&#160;
    </p>
    </td></tr>
  </table>
<!-- end navigation -->

<hr size="1" noshade="-1" />

<!-- copyright -->
<p class="pFooter">
 
<!-- start copyright -->
<span class="footer">
<a href="copyright.html" tppabs="http://docs.sun.com/source/819-1553/copyright.html" class="footer">版权所有</a> 2004 - 2005 <a href="javascript:if(confirm('http://sun.com/  \n\n该文件无法用 Teleport Ultra 下载, 因为 它是一个域或路径外部被设置为它的启始地址的地址。  \n\n你想在服务器上打开它?'))window.location='http://sun.com/'" tppabs="http://sun.com/" class="footer">Sun Microsystems, Inc.</a> 保留所有权利。
</span>
<!--  end copyright  -->

</p>
<!-- end copyright -->

<!-- <p class="pFooter" align="right">Last Updated <b>$Update;</b></p> -->
<!-- end footer -->

</blockquote>

</body>
</html>