4.1 智能配置

Identity Manager Driver for JDBC 可以识别支持的第三方 JDBC 驱动程序集和数据库集。 同时,该驱动程序可以动态和自动配置大多数驱动程序兼容性参数。 这些功能降低了终端用户了解和显式设置这些参数的必要性。

这些功能是通过以下四种类型的 XML 描述符文件实现的,这些文件描述 Driver for JDBC 的第三方 JDBC 驱动程序或数据库。

为描述符文件保留的文件名

该驱动程序附带的描述符文件名以下划线字符 ( _ ) 开头。 保留这样的文件名是为了确保该驱动程序附带的描述符文件不与自定义的描述符文件冲突。 显然,自定义的描述符文件名不能以下划线字符开头。

导入描述符文件

导入描述符文件允许多个非导入描述符文件共享内容。 此功能可以缩减非导入描述符文件的大小,最大限度地降低内容重复的必要性,以及提高可维护性。 导入文件不能在不同的主要类型之间导入。 也就是说,JDBC 驱动程序描述符无法导入数据库导入,而数据库描述符无法导入 JDBC 驱动程序导入。

此外,自定义的非导入描述符无法导入保留的描述符导入。 例如,如果名称为 custom.xml 的自定义第三方 JDBC 驱动程序描述符文件尝试导入名称为 _reserved.xml 的保留第三方 JDBC 驱动程序描述符,则会产生错误。 这些限制可以实现以下目的:

描述符文件位置

描述符文件必须位于 jar 文件中,该文件的名称以前缀《jdbc》(不区分大小写的)开头,并驻留在运行时类路径中。

下表说明描述符在描述符 jar 文件中的放置位置:

Table 4-1 描述符的放置位置

描述符类型

目录路径

第三方 JDBC 驱动程序

com/novell/nds/dirxml/driver/jdbc/db/descriptor/driver

第三方 JDBC 驱动程序导入

com/novell/nds/dirxml/driver/jdbc/db/descriptor/driver/import

数据库

com/novell/nds/dirxml/driver/jdbc/db/descriptor/db

数据库导入

com/novell/nds/dirxml/driver/jdbc/db/descriptor/db/import

保留的描述符文件位于 JDBCConfig.jar 文件中。 要确保更新 Driver for JDBC 时不覆盖这些保留的文件,请在另一个 jar 文件中放置自定义的描述符。

优先权

通过管理控制台(如 iManager)显式指定的参数始终优先于通过描述符文件指定的参数。 只有当参数不是通过管理控制台设置时描述符文件参数才会生效。

在不可导入的描述符文件中指定的参数和其它信息始终优先于在描述符导入文件中指定的这些内容。 如果在描述符文件中复制参数或其它信息,则该参数或信息的第一个实例优先于后面的实例。

导入文件的优先权取决于导入顺序。 导入列表中声明较早的导入文件优先于声明较晚的导入文件。

自定义描述符最佳做法

描述符文件 DTD

以下附录包含所有描述符文件类型的 DTD。 这些 DTD可以帮助您构造自定义描述符文件。

Table 4-2 如何查找描述符 DTD

描述符类型

附录

第三方 JDBC 驱动程序

Section F.0, 第三方 JDBC 驱动程序描述符 DTD

第三方 JDBC 驱动程序导入

Section G.0, 第三方 JDBC 驱动程序描述符导入 DTD

数据库

Section H.0, 数据库描述符 DTD

数据库导入

Section I.0, 数据库描述符导入 DTD