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

第 6 章 JNDI 资源

关于 Java 命名和目录接口 (JNDI)

本节将讨论 Java 命名和目录接口 (JNDI)。JNDI 是用于访问不同种类的命名和目录服务的应用程序编程接口 (API)。J2EE 组件通过调用 JNDI 查找方法来定位对象。

本节包括以下主题：

JNDI 名称和资源

JNDI 是 Java 命名和 API 目录接口的首字母缩略词。通过对此 API 进行调用，应用程序可以定位资源和其他程序对象。资源是提供到系统（如数据库服务器和消息传送系统）的连接的程序对象。（JDBC 资源有时被称为数据源。）每个资源对象都是由唯一的友好名称所标识，称为 JNDI 名称。Application Server 附带的命名和目录服务将资源对象及其 JNDI 名称绑定在一起。要创建新资源，需要将新的名称-对象绑定输入到 JNDI 中。

J2EE 命名服务

JNDI 名称是便于用户使用的对象名称。这些名称通过 J2EE 服务器提供的命名和目录服务绑定到其对象。由于 J2EE 组件通过 JNDI API 访问此服务，因此对象通常使用其 JNDI 名称。例如，PointBase 数据库的 JNDI 名称为 jdbc/Pointbase。Application Server 启动时，将从配置文件读取信息，并自动将 JNDI 数据库名称添加到名称空间。

J2EE 应用程序客户机、企业 Bean 以及 Web 组件都需要具有权限，才能访问 JNDI 命名环境。

应用程序组件的命名环境是一种机制，使用它可以在部署或汇编期间自定义应用程序组件的商业逻辑。使用应用程序组件的环境即可对应用程序组件进行自定义，而无需访问或更改应用程序组件的源代码。

J2EE 容器实现 J2EE 应用程序组件的环境，并将该环境作为 JNDI 命名上下文提供给 J2EE 应用程序组件实例。J2EE 应用程序组件的环境的使用方式如下：

应用程序组件的商业方法使用 JNDI 接口访问该环境。应用程序组件提供商在部署描述符中声明应用程序组件需要其运行时环境提供的所有环境项。
容器实现存储应用程序组件环境的 JNDI 命名上下文。容器还提供了部署者可以用于创建和管理每个应用程序组件的环境的工具。
部署者使用容器提供的工具，可以初始化应用程序组件的部署描述符中声明的环境项。部署者可以设置和修改环境条目的值。
容器使环境命名上下文在运行时可用于应用程序组件实例。应用程序组件的实例使用 JNDI 接口获取环境项的值。

每个应用程序组件定义了其本身的环境项集合。一个应用程序组件在同一容器内的所有实例共享相同的环境项。不允许应用程序组件实例在运行时修改环境。

命名引用和绑定信息

资源引用是部署描述符中的一种元素，用于标识该资源的组件的编码名称。更具体地说，编码名称引用资源的连接工厂。在下节给出的示例中，资源引用名称为 jdbc/SavingsAccountDB。

资源的 JNDI 名称和资源引用名称是不同的。使用此命名方法，您需要在进行部署之前先映射这两个名称，但此方法也用于将组件与资源分离开。由于具有此分离功能，因此如果组件在以后需要访问其他资源，则无需更改名称。这一灵活性使您可以更加容易地从先前存在的组件汇编 J2EE 应用程序。

下表列出了用于 Application Server 所使用的 J2EE 资源的 JNDI 查找及其关联的引用。

表 6–1 JNDI 查找及其关联的引用


JNDI 查找名称	关联的引用
`java:comp/env`	应用程序环境项
`java:comp/env/jdbc`	JDBC 数据源资源管理器连接工厂
`java:comp/env/ejb`	EJB 引用
`java:comp/UserTransaction`	UserTransaction 引用
`java:comp/env/mail`	JavaMail 会话连接工厂
`java:comp/env/url`	URL 连接工厂
`java:comp/env/jms`	JMS 连接工厂和目标
`java:comp/ORB`	应用程序组件之间共享的 ORB 实例

关于自定义资源

使用自定义资源

自定义资源访问本地 JNDI 系统信息库，外部资源访问外部 JNDI 系统信息库。这两种类型的资源都需要用户指定的工厂类元素、JNDI 名称属性等。在本节中，我们将讨论如何为 J2EE 资源配置 JNDI 连接工厂资源，以及如何访问这些资源。

在 Application Server 中，您可以创建、删除和列出资源以及 list-jndi-entities。

创建自定义资源

在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Application Server 实例。

打开“JNDI”标签，并单击“自定义资源”。

任何已经创建的自定义资源会在右侧窗格中列出。要创建新的自定义资源，单击“新建”。打开“JNDI”选项卡，并单击“新建”。将显示一个页面，用于添加新的自定义资源。

在“JNDI 名称”字段中，输入用于访问资源的名称。

此名称将注册到 JNDI 命名服务中。

在“资源类型”字段中，输入全限定的类型定义，如上面示例中所示。

“资源类型”定义遵循的格式为 xxx.xxx。

在“工厂类”字段中，为要创建的自定义资源输入工厂类名称。

该字段中的值是用户指定的工厂类的名称。此类实现了 javax.naming.spi.ObjectFactory 接口。

在“说明”字段中，为要创建的资源输入说明。

此说明是字符串值，最多可以包含 250 个字符。

在“其他属性”部分，添加属性名称和值。

选中“启用自定义资源”复选框，将启用自定义资源。

单击“确定”保存自定义资源。

如果已在群集或独立实例上部署自定义资源，则可以使用“目标”选项卡管理目标。此选项卡将在创建自定义资源之后显示。通过输入目标名称并单击“确定”来设置目标。

等效的 asadmin 命令

create-custom-resource

编辑自定义资源

在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Application Server 实例。

打开“JNDI”并选择“自定义资源”。

任何已经创建的自定义资源会在右侧窗格中列出。

单击右侧窗格中的文件名。

编辑“资源类型”字段、“工厂类”字段或“说明”字段。

选中“启用自定义资源”复选框，将启用自定义资源。

单击“保存”以保存对自定义资源的更改。

删除自定义资源

在管理控制台的左侧窗格中，打开 "JNDI" 选项卡。

单击“自定义资源”。

任何已经创建的自定义资源会在右侧窗格中列出。

单击要删除的资源名称旁边的框。

单击“删除”。此自定义资源即被删除。

等效的 asadmin 命令

delete-custom-resource

列出自定义资源

要列出自定义资源，请键入 asadmin list-custom-resources 命令。例如，要列出主机 plum 上的自定义资源，请键入以下命令：

$asadmin list-custom-resources --host plum target6

要查看完整的上下文，请键入 asadmin help list-custom-resources。

关于外部 JNDI 系统信息库和资源

使用外部 JNDI 系统信息库和资源

通常，在 Application Server 上运行的应用程序需要访问存储在外部 JNDI 系统信息库中的资源。例如，一般的 Java 对象可能会以 Java 模式存储在 LDAP 服务器中。外部 JNDI 资源元素允许用户配置此类外部资源系统信息库。外部 JNDI 工厂必须实现 javax.naming.spi.InitialContextFactory 接口。

使用外部 JNDI 资源的示例：

<resources>
 <!-- external-jndi-resource element specifies how to access J2EE resources
 -- stored in an external JNDI repository. The following example
 -- illustrates how to access a java object stored in LDAP.
 -- factory-class element specifies the JNDI InitialContext factory that
 -- needs to be used to access the resource factory. property element
 -- corresponds to the environment applicable to the external JNDI context
 -- and jndi-lookup-name refers to the JNDI name to lookup to fetch the
 -- designated (in this case the java) object.
 -->
  <external-jndi-resource jndi-name="test/myBean"
      jndi-lookup-name="cn=myBean"
      res-type="test.myBean"
      factory-class="com.sun.jndi.ldap.LdapCtxFactory">
    <property name="PROVIDER-URL" value="ldap://ldapserver:389/o=myObjects" />
    <property name="SECURITY_AUTHENTICATION" value="simple" />
    <property name="SECURITY_PRINCIPAL", value="cn=joeSmith, o=Engineering" />
    <property name="SECURITY_CREDENTIALS" value="changeit" />
  </external-jndi-resource>
</resources>

创建外部资源

在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Application Server 实例。

打开“JNDI”并选择“外部资源”。

任何已经创建的外部资源会在右侧窗格中列出。

要创建新的外部资源，单击“New”。

在“JNDI Name”字段中，输入要访问资源的名称。

此名称将登记到 JNDI 命名服务中。

在“资源类型”字段中，输入全限定的类型定义，如上面示例中所示。

“资源类型”定义遵循的格式为 xxx.xxx。

在“NDI 查找”字段中，输入要在外部系统信息库中查找的 JNDI 值。

例如，在创建一个与外部系统信息库连接的外部资源时，为了测试某个 Bean 类，“JNDI 查找”可能会如下所示：cn=testmybean。

在“工厂类”字段中，输入 JNDI 工厂类外部系统信息库（例如 com.sun.jndi.ldap）。

此类实现了 javax.naming.spi.ObjectFactory 接口。

在“说明”字段中，为要创建的资源输入说明。

此说明是字符串值，最多可以包含 250 个字符。

在“其他属性”部分，添加属性名称和值。

选中“已启用外部资源”复选框，将启用外部资源。

单击“确定”以保存外部资源。

如果已在群集或独立实例上部署外部资源，则可以使用“目标”选项卡管理目标。此选项卡将在创建外部资源之后显示。通过输入目标名称并单击“确定”来设置目标。

等效的 asadmin 命令

create-jndi-resource

编辑外部资源

在管理控制台的左侧窗格中，为要修改的 JNDI 配置打开 Application Server 实例。

打开“JNDI”并选择“外部资源”。

任何已经创建的外部资源会在右侧窗格中列出。

要编辑外部资源，请在右侧窗格中单击文件名。

编辑“资源类型”字段、“JNDI 查找”字段、“工厂类”字段或“说明”字段。

选中“已启用外部资源”复选框，将启用外部资源。

单击“保存”以保存对外部资源的更改。

删除外部资源

在管理控制台的左侧窗格中，打开 "JNDI" 选项卡。

单击“外部资源”。

任何已经创建的外部资源会在右侧窗格中列出。

单击要删除的资源名称旁边的框。

单击“删除”。此外部资源即被删除。

等效的 asadmin 命令

delete-jndi-resource

列出外部资源

要列出外部资源，请键入 asadmin list-jndi-resources 命令并指定 JNDI 名称。例如，键入以下命令可以列出外部资源：

$asadmin list-jndi-resources --user adminuser --host plum jndi_name_test

要查看完整的上下文，请键入 asadmin help list-jndi-resources。