tsx:dbconnect 标记 JavaServer Pages 语法(不推荐使用)
使用 <tsx:dbconnect> 标记指定通过 Java™ 数据库连接 (JDBC) 或开放式数据库连接标准 (ODBC) 技术连接到数据库所需的信息。
在 WebSphere® Application Server V6.0 中,不推荐使用 JavaServer Pages (JSP) 引擎中对 tsx 标记的支持。在不使用 tsx 标记的情况下,应该使用来自 JavaServer Pages 标准标记库 (JSTL) 的等价标记。
<tsx:dbconnect> 语法本身不建立连接。而是使用 <tsx:dbquery> 和 <tsx:dbmodify> 语法引用同一 JavaServer Pages (JSP) 文件中的 <tsx:dbconnect> 标记以建立此连接。
当 JSP 文件编译到 Servlet 时,Java 处理程序将 <tsx:dbconnect> 语法的 Java 编码添加到 Servlet service() 方法,这表明将为 JSP 文件的每个请求创建新的数据库连接。
本部分描述 <tsx:dbconnect> 标记的语法。
<tsx:dbconnect id="connection_id" userid="db_user" passwd="user_password" url="jdbc:subprotocol:database" driver="database_driver_name" jndiname="JNDI_context/logical_name"> </tsx:dbconnect>
其中:
- id
表示必需标识。其作用域为 JSP 文件。此标识由 <tsx:dbquery> 标记的 connetion 属性引用。
- userid
表示一种可选属性,其指定您要访问的数据库的有效用户标识。指定此属性以将此属性及其值添加到请求对象中。
尽管 userid 属性是可选的,但您必须提供用户标识。请参阅 <tsx:userid> 和 <tsx:passwd>,以了解硬编码 JSP 文件中的此信息的备用方法。
- passwd
表示一种可选属性,其指定 userid 属性的用户密码。(如果指定了 userid 属性,那么该属性是必选的。)如果您指定此属性,那么此属性及其值就会添加到请求对象中。
尽管 passwd 属性是可选的,但您必须提供密码。请参阅 <tsx:userid> 和 <tsx:passwd>,以了解硬编码 JSP 文件中的此属性的备用方法。
- url 和 driver
表示您要建立数据库连接时的必需属性。您必须提供 URL 和驱动程序。
应用程序服务器支持与 JDBC 数据库和 ODBC 数据库的连接。
- 对于 JDBC 数据库,URL 由下列用冒号分隔的元素组成:jdbc、子协议名和要访问的数据库名称。连接到 IBM® DB2® 包含的 Sample 数据库的示例为:
url="jdbc:db2:sample" driver="com.ibm.db2.jdbc.app.DB2Driver"
- 对于 ODBC 数据库,使用包含在其 Java2 软件开发者工具箱 (SDK) 中的 Sun JDBC-to-ODBC 桥驱动程序或另一个供应商的 ODBC 驱动程序。
url 属性指定了数据库的位置。driver 属性指定用于建立数据库连接的驱动程序名称。
如果数据库是 ODBC 数据库,您可以使用 ODBC 驱动程序或 Sun JDBC-to-ODBC 桥。如果您要使用 ODBC 驱动程序,请参阅驱动程序文档,以了解关于使用 url 属性指定数据库位置以及驱动程序名的指示信息。
如果您使用网桥,那么 url 语法是 jdbc:odbc:database。示例如下:
url="jdbc:odbc:autos" driver="sun.jdbc.odbc.JdbcOdbcDriver"
注意:要使应用程序服务器能够访问 ODBC 数据库,请用 ODBC 数据源管理器将 ODBC 数据源添加到系统 DSN 配置中。要访问“ODBC 管理器”,请单击 Windows NT“控制面板”上的 ODBC 图标。
- 对于 JDBC 数据库,URL 由下列用冒号分隔的元素组成:jdbc、子协议名和要访问的数据库名称。连接到 IBM® DB2® 包含的 Sample 数据库的示例为:
- jndiname
表示一种可选属性,它标识应用程序服务器 Java 命名和目录接口 (JNDI) 命名上下文中的有效上下文和该上下文中数据源的逻辑名。Web 管理员使用管理客户机(例如 WebSphere 管理控制台)配置上下文。
如果您指定 jndiname 属性,那么 JSP 处理程序忽略 <tsx:dbconnect> 标记上的 driver 属性和 url 属性。
空元素(例如 <url></url>)是有效的。