Sun ONE logo      上一个      目录      索引      下一个     

Sun ONE Web Server 6.1 管理员指南

第 12 章
配置命名和资源

基于组件的 Java™ 2 Platform, Enterprise Edition (J2EE™) 技术为 Web 服务提供了一个可简化企业开发和部署的基础结构。

本章介绍 Sun ONE Web Server 提供的 J2EE 资源并讨论用于创建和管理这些资源的方法。

有关 Java 安全性和基于领域的验证的信息,请参见第 4 章“用于 Web 容器和 Web 应用程序的基于 J2EE 的安全性”

本章包括以下部分:


启用和禁用 Java

您可以全局(即基于每个 Sun ONE Web Serve 实例)启用或禁用 Java,也可以为特定的虚拟服务器类启用或禁用 Java。默认情况下,Sun ONE Web Server 中启用了 Java,且在 magnus.conf 文件中添加了以下行:

Init fn="load-modules" shlib="<server-root>/bin/https/lib/libj2eeplugin.so"

您也可以为特定的虚拟服务器启用 Java。执行此操作时,服务器将用所需的 J2EE 指令为该虚拟服务器类更新 obj.conf

有关 obj.confmagnus.conf 文件的详细信息,请参见《Sun ONE Web Server 6.1 Administrator's Configuration File Reference》和《Sun ONE Web Server 6.1 NSAPI Programmer's Guide》。

在某些情况下,您可能希望全局禁用 Java 或为特定的虚拟服务器类禁用 Java,例如,当整个服务器或该类仅提供静态内容时。

要启用或禁用 Java,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“Enable/Disable Servlets/JSP”。
  3. “Enable/Disable Servlets/JSP”界面
    “Enable/Disable Servlets/JSP”页面图示。

  4. 要全局启用或禁用 Java,请选中或取消选中“Enable/Disable Java Globally”。
  5. 或者

    要为特定虚拟服务器类启用或禁用 Java,请选中或取消选中与该虚拟服务器类相对应的“Enable/Disable Java”复选框。

  6. 单击“OK”。


配置 JVM 设置

与本产品以前的版本不同,Sun ONE Web Server 6.1 不再支持独立的 Java 运行时环境 (JRE)。相反,该服务器要求使用 JDK 1.4.1 或更高版本。安装服务器时,如果选择默认的 JDK 选项,Java 开发工具 (JDK) 1.4.1_03 将安装在 <server-root>/bin/https/jdk 目录下。

您可以为服务器实例配置 Java 虚拟机 (JVM) 设置。这些设置包括 Java 主页的位置、编译程序选项、调试选项和事件探查器信息。配置这些设置的原因之一是为了改善性能。有关性能的详细信息,请参见《Sun ONE Web Server 6.1 Performance Tuning, Sizing, and Scaling Guide》。

配置常规设置

要编辑 JDK 的位置和指定调试选项,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JVM General”。
  3. “JVM General”界面
    “JVM General”页面图示。

  4. 设置“Java Home”。
  5. “Java Home”是 Java 开发工具 (JDK) 安装目录的路径。Sun ONE Web Server 支持 Sun JDK 1.4.1_03。

  6. 选择是否启用调试并设置调试选项。
  7. 调试选项的列表位于以下位置:http://java.sun.com/products/jpda/doc/conninv.html#Invocation

  8. 单击“OK”。

配置路径设置

出于某种原因,您可能要配置 JVM 的路径设置。例如,您可能要为系统的类路径 (classpath) 选择一个后缀以覆盖系统的类(如 XML 分析器类),或者可能要忽略环境类路径以防止环境变量对生产环境产生不利的影响。

要在管理界面中配置 JVM 的路径设置,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JVM Path Settings”。
  3. 为系统的类路径选择后缀。
  4. 选择是否忽略环境类路径。
  5. 如果不忽略类路径,系统将读取 CLASSPATH 环境变量并将其附加到 Sun ONE Web Server 类路径。CLASSPATH 环境变量添加到 classpathsuffix 的后面,即最后端。

    对于开发环境,应当使用类路径。对于生产环境,应当忽略类路径以防止环境变量产生不利的影响。

  6. 设置本地库路径的前缀和后缀。
  7. 本地库路径是自动生成的以下各项的合成,即 Web 服务器安装的本地共享库的相对路径、标准 JRE 本地库路径、shell 环境设置(UNIX 上的 LD_LIBRARY_PATH)以及在 profiler 元素中指定的任何路径。由于这是一个合成的路径,因此不会明确显示在服务器配置中。

  8. 单击“OK”。

配置 JVM 选项

要在管理界面中设置 JVM 命令行选项,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JVM Options”并进行所需的更改。
  3. 关于特定 JVM 选项的信息,请参见:

    http://java.sun.com/docs/hotspot/VMOptions.html

  4. 单击“OK”。

配置 JVM 事件探查器

您可以使用事件探查器在 Sun ONE Web Server 上执行远程事件探查,以查找服务器端性能方面的瓶颈。

要在管理界面中配置 JVM 事件探查器,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JVM Profiler”。
  3. 指定类路径、本地库路径以及是否启用事件探查器。
  4. 添加、删除或编辑事件探查器的 JVM 选项并单击“OK”。

有关事件探查器的详细信息,请参见《Sun ONE Web Server 6.1 Programmer's Guide》。


关于 J2EE 命名服务和资源

Web 应用程序可以访问多种资源,例如资源管理器、数据源(如 SQL 数据源)、邮件会话和 URL 连接工厂。J2EE 平台通过 Java 命名和目录接口 (JNDI) 服务将这些资源提供给应用程序。

使用 Sun ONE Web Server,您可以创建和管理以下 J2EE 资源:

JDBC 数据源

JDBC 数据源是一种 J2EE 资源,可以使用 Sun ONE Web Server 进行创建和管理。

JDBC API 是用于与关系数据库系统进行连接的 API。JDBC API 包含两部分:

JDBC 数据源对象是用 Java 编程语言实现的数据源。从本质上讲,数据源是一种存储数据的设备。数据源可能像大型公司的综合数据库一样复杂,也可能像仅包含行和列的文件一样简单。JDBC 数据源是一种 J2EE 资源,可以使用 Sun ONE Web Server 进行创建和管理。

JDBC API 使用标准的 SQL 数据库访问接口为 Java 提供了一组类,可以确保对多种关系数据库的统一访问。

事实上,使用 JDBC 可以将 SQL 语句发送到任何数据库管理系统 (DBMS)。它可以用作关系 DBMS 和对象 DBMS 的接口。

有关创建自定义资源的信息,请参见创建 JDBC 资源

JDBC 连接池

JDBC 连接池是一个到数据库的 JDBC 连接的命名组。这些连接是在启动 Sun ONE Web Server 时在连接池中首次进行连接请求时创建的。

JDBC 连接池定义了用于创建连接池的属性。每个连接池都使用 JDBC 驱动程序在服务器启动时创建一个到物理数据库的连接。

基于 JDBC 的应用程序或资源从池中提取并使用某个连接;之后,如果不再需要该连接,将通过关闭连接将其返回连接池。如果两个或多个 JDBC 资源指向同一个池定义,它们将在运行时使用相同的连接池。

有关如何创建新 JDBC 连接池的信息,请参见创建新的 JDBC 连接池

Java 邮件会话

JMS 目标是一种 J2EE 资源,可以使用 Sun ONE Web Server 进行创建和管理。

许多 Internet 应用程序都需要具有发送电子邮件通知的能力,因此,J2EE 平台提供了 JavaMail API 以及一个使应用程序组件可以发送 Internet 邮件的 JavaMail 服务提供者。JavaMail API 包含两部分:

JMS 邮件会话是一种 J2EE 资源,可以使用 Sun ONE Web Server 进行创建和管理。


注意

Sun ONE Web Server 没有为创建 Java 邮件会话提供 Administration Server 界面。您可以使用命令行界面执行此操作。有关如何使用命令行实用程序创建邮件资源的详细信息,请参见创建邮件资源


自定义资源

自定义资源可访问本地 JNDI 系统信息库。server.xml 中定义的 customresource 元素提供了一种方法,可用于指定服务器范围的自定义资源对象工厂。这种对象工厂可实现 javax.naming.spi.ObjectFactory 接口。此元素将以下各项关联起来,即一个要在服务器范围的名称空间中使用的 JNDI 名称(像其它 Sun ONE Web Server 资源一样通过 jndiname 子元素指定的)、类型、资源工厂类的名称以及一组用于实例化相同属性的标准属性。

您需要确保该资源参考的环境参考已链接到所配置的服务器范围的资源(这些资源是使用 server.xml 中的 customresource externaljndiresource 标记定义的)。应用程序组件的动态重新部署是一个有关 JNDI 命名环境的问题。Sun ONE Web Server 将发布所有应用程序的特定参考并将所有新参考重新绑定到新安装的应用程序的命名上下文中。

有关创建自定义资源的信息,请参见创建自定义资源

外部 JNDI 资源

通常,Sun ONE Web Server 上运行的应用程序需要访问存储在外部 JNDI 系统信息库中的资源。例如,一般的 Java 对象可能会以 Java 模式存储在 LDAP 服务器中。虽然使用自定义资源可以访问本地 JNDI 系统信息库,但是要访问外部 JNDI 信息库,必须使用外部 JNDI 资源。外部 JNDI 工厂必须实现 javax.naming.spi.InitialContextFactory 接口。

有关创建外部 JNDI 资源的信息,请参见创建外部 JNDI 资源


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

本节介绍 Java 命名和目录接口 (JNDI)。它是一种应用程序编程接口 (API),用于访问不同类型的命名服务和目录服务。J2EE 组件通过调用 JNDI 查找方法来找到对象。

本节包括以下主题:

J2EE 命名服务

JNDI 名称是一种便于用户使用的对象名称。这些名称通过 J2EE 服务器提供的命名和目录服务绑定到其对象。由于 J2EE 组件通过 JNDI API 访问此服务,因而我们通常将某个对象的便于用户使用的名称称为该对象的 JNDI 名称。例如,Oracle 数据库的 JNDI 名称可以是 jdbc/Oracle。当它启动时,Sun ONE Web Server 将从配置文件中读取信息并自动将 JNDI 数据库名称添加到名称空间。

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

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

每个应用程序组件都定义了其自己的环境条目集合。一个应用程序组件在同一容器内的所有实例将共享相同的环境条目。应用程序组件实例不能在运行时修改环境。

命名参考和绑定信息

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

资源的 JNDI 名称与资源参考的名称是不同的。使用此命名方法,您需要在进行部署之前先映射这两个名称,但此方法也会将组件与资源分离开。由于这种分离,使得如果组件以后需要访问其它资源,将不必在代码中更改名称。这一灵活性使您可以更容易地由以前存在的组件来汇编 J2EE 应用程序。

下表列出了 Sun ONE Web Server 使用的 J2EE 资源的所推荐的 JNDI 查找及其关联参考。

表 1
JNDI 查找及其关联参考

JNDI 查找名称

关联参考

java:comp/env

应用程序环境条目

java:comp/env/jdbc

JDBC 数据源资源

java:comp/env/mail

JavaMail 会话连接工厂

java:comp/env/url

URL 连接工厂

J2EE 标准部署描述符中的命名参考

命名参考是一种字符串,应用程序使用这种字符串在指定的命名上下文中查找对象。每个 Web 应用程序都有一个命名上下文,并且其参考在标准组件部署描述符中进行了配置。本节介绍了 Sun ONE Web Server 中使用的标准部署描述符功能。本节包括以下主题:

应用程序环境条目

环境条目是使用 <env-entry> 定义的,可用于为 J2EE Web 应用程序指定部署时间参数。请注意,虽然可以使用 <context-param> 来定义 servlet 上下文初始化参数,但 <env-entry> 是首选方法,因为应用程序部署者是通过明确指定此类应用程序参数的名称、类型和值来对其进行配置的。

以下样例说明了 J2EE 标准部署描述符中指定的 <env-entry> 的语法

<env-entry>

<description> Send pincode by mail </description>

<env-entry-name> mailPincode </env-entry-name>

<env-entry-value> false </env-entry-value>

<env-entry-type> java.lang.Boolean </env-entry-type>

</env-entry>

<env-entry-type> 标记为条目指定了一个全限定的类名称。下面的代码段使用 JNDI 从 Servlet 或 JSP 查找 <env-entry>

Context initContext = new InitialContext();

Boolean mailPincode = (Boolean)

initContext.lookup("java:comp/env/mailPincode");

// 用户可以在子上下文中使用相对名称

Context envContext = initContext.lookup("java:comp/env");

Boolean mailPincode = (Boolean)

envContext.lookup("mailPincode");

资源参考

工厂是一种用于根据需要创建其它对象的对象。资源工厂可以创建资源对象,例如,数据库连接或消息服务连接。它们是使用标准部署描述符中的 <resource-ref> 元素配置的。

以下示例说明了工厂的使用:

示例

对 JDBC 连接工厂(返回 javax.sql.DataSource 类型的对象)的参考的声明:

<resource-ref>

<description> Primary database </description>

<res-ref-name> jdbc/primaryDB </res-ref-name>

<res-type> javax.sql.DataSource </res-type>

<res-auth>Container</res-auth>

</resource-ref>

<res-type> 是该资源工厂的全限定类名称。可以指定 Container Application 作为 <res-auth> 变量的值。

如果指定 Container,Web 容器会在将资源工厂绑定到 JNDI 查找注册表之前处理验证。如果指定 Application,Servlet 必须以编程方式处理验证。不同类型的资源工厂将在描述了资源类型的单独的子上下文中进行查找,如下所示:

下面的代码段通过用容器处理验证,从应用程序组件获取 JDBC 连接:

InitialContext initContext = new InitialContext();

DataSource source =

(DataSource) initContext.lookup("java:comp/env/jdbc/primaryDB");

Connection conn = source.getConnection();

请注意,为确保这些资源参考正常工作,res-ref-name 必须在运行时映射到有效的资源工厂。

资源环境参考

资源环境参考提供了一种可以通过 JNDI 查找访问与资源相关联的管理对象的方法。标准部署描述符中定义的 <resource-env-ref> 元素使应用程序可以声明资源要求

<resource-env-ref> <resource-ref> 元素之间的主要区别在于前者没有特定的资源验证要求,但这两种元素都必须通过资源工厂描述符进行备份。

示例

<resource-env-ref>

<description> My Topic </description>

<res-env-ref-name> jdbc/MyTopic </res-ref-name>

<res-env-ref-type> javax.jdbc.Topic </res-type>

</resource-env-ref>

下面的代码段将访问一个 JMS Topic 对象:

InitialContext initContext = new InitialContext();

javax.jms.Topic myTopic = (javax.jdbc.Topic) initContext.lookup("java:comp/env/jdbc/MyTopic");

初始命名上下文

Sun ONE Web Server 中的命名支持主要基于 J2EE 1.3,同时还添加了一些增强功能。当应用程序组件通过 InitialContext() 创建初始上下文时,Sun ONE Web Server 将返回一个充当 Web 应用程序命名环境的句柄的对象。此对象又为 java:comp/env 名称空间提供了子上下文。每个 Web 应用程序将获取自己的名称空间,也就是说,java:comp/env namespace 是针对每个 Web 应用程序的,并且一个 Web 应用程序的名称空间中绑定的对象不与其它 Web 应用程序中绑定的对象发生冲突。

JNDI 连接工厂

对于 J2EE Web 应用程序,web.xml 文件中的部署描述符是占位符,用于定义对应用程序环境条目或资源管理器(如 SQL 数据源)连接工厂的参考。应用程序使用 J2EE 容器提供的 JNDI InitialNamingContext 查找这些参考。这样,仅通过更改部署描述符(而不必访问或修改应用程序的源代码)即可将应用程序移植到不同的 Web 服务器环境中。

连接工厂是一种对象,可生成使 J2EE 组件能够访问资源的连接对象。数据库的连接工厂是一种 javax.sql.DataSource 对象,它可创建 java.sql.Connection 对象。

在 Sun ONE Web Server 中,您可以配置访问以下资源和资源工厂的方式:

所有 Sun ONE Web Server 资源工厂都在 server.xml 中的 <resources> </resources> 标记中指定,且具有使用 jndiname 属性指定的 JNDI 名称(jdbconnectionpool 除外,它不具有 jndiname)。此属性用于在服务器范围内的名称空间中注册工厂。部署者可以使用 sun-web.xml 中的 resource-ref 元素将用户指定的、特定应用程序的资源参考名称(在 resource-ref resource-env-ref 元素中声明)映射到这些服务器范围内的资源工厂。这样有助于在部署时决定给定的应用程序使用哪些 JDBC 资源(和其它资源工厂)。

自定义资源访问本地 JNDI 系统信息库,外部资源访问外部 JNDI 系统信息库。这两种资源类型都需要用户指定的工厂类元素、JNDI 名称属性等。

本节将介绍如何创建各种 J2EE 资源以及如何访问这些资源。


创建基于 Java 的资源

本节介绍如何使用管理界面创建基于 J2EE 的不同资源:

创建新的 JDBC 连接池

可以通过以下方式创建新的 JDBC 连接池:

使用管理界面

要使用管理界面创建新的 JDBC 连接池,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Connection Pools”。
  3. 单击“New”。
  4. “JDBC Connection Pools”界面
    “JDBC Connection Pools”页面图示。

  5. 从“Database Vendor”下拉列表中选择要连接的数据库类型。如果未列出您的 DBMS,请选择“Other”。
  6. “New JDBC Connection Pool”界面
    “New JDBC Connection Pool”页面图示(其中选定了一个数据库供应商)。

  7. 单击“Next”。
  8. 将显示“Add New JDBC Connection Pool”页面。

  9. 指定新连接池的属性并单击“OK”。
  10. 下面列出了必须指定的连接池属性:

    General

    • Pool Name。输入新连接池的名称。
    • DataSource Classname。实现数据源的供应商的特定类名称。如果在“New JDBC Connection Pool”页面的“Database Vendor”列表中选择了“Other”,则必须输入要使用的数据源的供应商特定类名称。请注意,此类必须实现 javax.sql.DataSource
    • Properties

      指定标准的和专用的 JDBC 连接池属性;其中的许多属性都是可选的。默认情况下将提供所有标准属性的名称。您需要查阅数据库供应商的文档,以确定必需的标准属性和供应商的特定属性。

      Pool Settings

    • Steady Pool Size。指定连接池应当维护的最小连接数。连接提供给请求的线程之后,该连接将从池中删除,从而减小了当前的池大小。稳定池大小还要参考服务器启动时要添加到池中的连接数。
    • Max Pool Size。指定该池在任意指定时间所允许的最大连接数。
    • Pool Resize Quantity。当池向稳定池大小方向收缩时,将按批量调整大小。此值用于确定该批量的大小。将此值设置过大会延迟连接的回收,而设置过小会导致效率太低。请注意,池容量每次只增加一个连接,因此该字段不会导致池容量的增加。
    • Idle Timeout (secs)。连接在池中可保持空闲状态的最长时间(秒)。超过此时间后,池实现可以关闭此连接。
    • Max Wait Time (milli secs)。达到连接超时前呼叫者等待的时间。默认的等待时间为 long,即呼叫者可以等待很长时间。如果此值设置为 0,在存在可用的连接之前呼叫者将被拒绝。
    • Connection Validation

    • Connection Validation Required。如果选中此字段,则连接在传递到应用程序之前将被验证。这样,如果由于网络出现故障或数据库服务器崩溃造成数据库不可用,Web 服务器将自动重新建立数据库连接。连接验证将引起额外负担,并且会导致性能稍有下降。
    • Validation Method。指定 Web 服务器可用于验证数据库连接的方法。请从以下值中选择:
      • auto-commit。在此模式下,将执行查询语句并将其作为单个事务提交。如果禁用 auto-commit,查询语句将并入可通过提交或回滚机制终止的事务中。
      • meta-data。在此模式下,连接的数据库可提供元信息,说明其表及存储过程等。元数据对象的每个实例都具有与其相关联的特定查询。元数据对象将执行该查询并高速缓存其结果。
      • table。此方法要求 Web 服务器基于用户指定的表执行查询。
    • Table Name。如果从“Validation Method”下拉列表中选择了验证选项“table”,则在此处指定表名称。
    • Fail All Connections。指定在确定某个连接已失败时是否使池中的所有连接都失败并重新建立这些连接。如果未选中此复选框,则仅在使用连接时才单独重新建立连接。
    • Transaction Isolation

      事务使用的隔离级别确定了应用程序对其他用户的事务所做更改的敏感程度,进而确定了事务必须保持多长时间的锁定以避免受到这些更改的影响。

    • Transaction Isolation。允许您为此连接选择事务隔离级别。请从以下值中选择:
      • read-uncommitted。也称为脏读取 (dirty read),此事务级别使事务可以读取数据页面上的任何当前数据,无论该数据是否被提交。
      • read-committed。此选项将在数据上放置共享锁定,这样,将不会读取其它事务已经更改但尚未提交的任何数据。因为不会读取尚未提交的数据,所以如果以 read-committed 隔离方式运行的事务再次查询数据,则该数据可能已更改,或者可能会出现满足原始查询条件的其它数据。
      • repeatable-read。此选项可确保在查询中使用的所有数据上放置锁定。在您提交或回滚事务之前,其他用户将无法修改您的事务访问的数据。
      • serializable。此选项将锁定数据的范围,这样,当再次执行查询时,在第一次和第二次查询之间的时间间隔内,数据不会更改,也不会出现其它数据行。
    • Guarantee Isolation Level。此选项可确保从池中获取的任何连接都将具有相同的隔离级别。例如,如果上次使用连接时其隔离级别以编程的方式被更改(例如,con.setTransactionIsolation),则此机制会将该连接的隔离级别更改回指定的隔离级别。

使用命令行界面

有关如何使用命令行界面创建新的 JDBC 连接池的信息,请参见附录 A“命令行实用程序”中的创建 JDBC 连接池

创建 JDBC 资源

JDBC 资源也称为数据源,通过它可以使用 getConnection() 创建到数据库的连接。可以通过以下方式之一创建 JDBC 资源:

使用管理界面

要使用管理界面创建 JDBC 资源,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Resources”。
  3. 单击“New”按钮。
  4. 输入以下信息:
    • JNDI Name(必需)。输入应用程序组件访问 JDBC 资源所必须使用的 JNDI 名称。
    • Pool Name(必需)。从列表中选择此 JDBC 资源使用的连接池的名称(或 ID)。有关详细信息,请参见创建新的 JDBC 连接池
  5. 要启用 JDBC 资源,请从“Data Source Enabled”下拉列表中选择“On”。
  6. 如果禁用某个 JDBC 资源,则任何应用程序组件都不能与之连接,但其配置仍保留在服务器实例中。

  7. 单击“OK”。
  8. 单击“Apply Changes”。

使用命令行界面

有关如何使用命令行界面创建新的 JDBC 资源的信息,请参见附录 A“命令行实用程序”中的创建 JDBC 资源

创建自定义资源

您可以通过以下任一方式创建自定义资源:

使用管理界面

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“Custom Resources”。
  3. 单击“New”按钮。
  4. 输入以下信息:
    • JNDI Name(必需)。输入应用程序组件访问自定义资源所必须使用的 JNDI 名称。
    • Resource Type(必需)。输入自定义资源的全限定类型。
    • Factory Class(必需)。输入用户编写的工厂类的全限定名称,它实现 javax.naming.spi.ObjectFactory
    • Custom Resource Enabled(可选)。选择“On”在运行时启用自定义资源。
  5. 单击“OK”。
  6. 单击“Apply Changes”。

使用命令行界面

有关如何使用命令行界面创建新的自定义资源的信息,请参见附录 A“命令行实用程序”中的创建自定义资源

创建外部 JNDI 资源

您可以通过以下方式创建外部资源:

使用管理界面

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“External JNDI Resources”。
  3. 单击“New”按钮。
  4. 输入以下信息:
    • JNDI Name(必需)。输入应用程序组件访问自定义资源所必须使用的 JNDI 名称。
    • Resource Type(必需)。输入自定义资源的全限定类型。
    • Factory Class(必需)。输入用户编写的工厂类的全限定名称,它实现 javax.naming.spi.ObjectFactory
    • JNDI Lookup(必需)。输入要在外部系统信息库中查找的 JNDI 值。例如,当您创建一个与外部系统信息库连接的外部资源时,为测试某个邮件类,“JNDI Lookup”可能会读取 cn=testmail
    • External Resource Enabled(可选)。选择“On”在运行时启用外部资源。
  5. 单击“OK”。
  6. 单击“Apply Changes”。

使用命令行界面

有关如何使用命令行界面创建新的自定义资源的信息,请参见附录 A“命令行实用程序”中的创建外部 JNDI 资源


修改基于 Java 的资源

本节介绍如何使用管理界面修改您创建的基于 Java 的资源的属性:

修改 JDBC 连接池

要修改 JDBC 连接池的属性,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Connection Pools”链接。
  3. 单击代表您要编辑的 JDBC 连接池的链接。
  4. 根据需要修改设置。
  5. 单击“OK”。

修改 JDBC 资源

要修改 JDBC 资源的属性,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Resources”链接。
  3. 单击代表您要编辑的 JDBC 资源的链接。
  4. 根据需要修改设置。
  5. 单击“OK”。

修改自定义资源

要修改自定义资源的属性,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“Custom Resources”链接。
  3. 单击代表您要编辑的自定义资源的链接。
  4. 根据需要修改设置。
  5. 单击“OK”。

修改外部 JNDI 资源

要修改外部 JNDI 资源的属性,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“External JNDI Resources”链接。
  3. 单击代表您要编辑的外部 JNDI 资源的链接。
  4. 根据需要修改设置。
  5. 单击“OK”。


删除基于 Java 的资源

本节介绍如何使用管理界面删除基于 Java 的资源:

删除 JDBC 连接池

您可以使用以下方法之一删除 JDBC 连接池:

使用 Administration Server

要使用 Administration Server 删除 JDBC 连接池,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Connection Pools”链接。
  3. 选中与要删除的 JDBC 连接池相对应的复选框。
  4. 单击“OK”。
使用命令行实用程序

有关可以使用的命令行选项的语法信息,请参见命令行实用程序

删除 JDBC 资源

您可以使用以下方法之一删除 JDBC 资源:

使用 Administration Server

要使用 Administration Server 删除 JDBC 资源,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“JDBC Resources”链接。
  3. 选中与要删除的 JDBC 资源相对应的复选框。
  4. 单击“OK”。
使用命令行实用程序

有关可以使用的命令行选项的语法信息,请参见命令行实用程序

删除自定义资源

您可以使用以下方法之一删除自定义资源:

使用 Administration Server

要使用 Administration Server 删除自定义资源,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“Custom Resources”链接。
  3. 选中与要删除的自定义资源相对应的复选框。
  4. 单击“OK”。
使用命令行实用程序

有关可以使用的命令行选项的语法信息,请参见命令行实用程序

删除外部 JNDI 资源

您可以使用以下方法之一删除外部 JNDI 资源:

使用 Administration Server

要使用 Administration Server 删除外部 JNDI 资源,请执行以下步骤:

  1. 访问 Server Manager 并选择“Java”选项卡。
  2. 单击“External JNDI Resources”链接。
  3. 选中与要删除的外部 JNDI 资源相对应的复选框。
  4. 单击“OK”。
使用命令行实用程序

有关可以使用的命令行选项的语法信息,请参见命令行实用程序



上一个      目录      索引      下一个     


版权所有 2003 Sun Microsystems, Inc.。保留所有权利。