Sintaxis JSP (JavaServer Pages) de tsx:dbconnect
Utilice el distintivo <tsx:dbconnect> para especificar la información necesaria para realizar una conexión con una base de datos a través de la tecnología JDBC (Java™ DataBase Connectivity) u ODBC (Open Database Connectivity).
El soporte de los distintivos tsx siguientes en el motor de JSP (JavaServer Pages) está en desuso en WebSphere Application Server Versión 6.0. En lugar de utilizar los distintivos tsx, utilice distintivos equivalentes de JSTL (JavaServer Pages Standard Tag Library).
La sintaxis <tsx:dbconnect> no establece la conexión. Utilice la sintaxis <tsx:dbquery> y <tsx:dbmodify> en lugar de hacer referencia a un distintivo <tsx:dbconnect> en el mismo archivo JSP (JavaServer Pages) para establecer la conexión.
Al compilar el archivo JSP en un servlet, el procesador Java Java añade la codificación Java para la sintaxis de <tsx:dbconnect> al método service() del servlet, lo cual significa que se crea una nueva conexión de base de datos cada vez para cada solicitud del archivo JSP.
Esta sección describe la sintaxis del distintivo <tsx:dbconnect>.
<tsx:dbconnect id="id_conexión" userid="db_user" passwd="contraseña_usuario" url="jdbc:subprotocol:basedatos" driver="nombre_controlador_basedatos" jndiname="JNDI_contexto/nombre_lógico"> </tsx:dbconnect >
donde:
- id
Es un identificador necesario. El ámbito es el archivo JSP. El atributo de conexión de un distintivo <tsx:dbquery> hace referencia a este identificador.
- userid
Representa un atributo opcional que especifica un ID de usuario válido para la base de datos a la que se va a acceder. Si se especifica, este atributo y su valor se añaden al objeto de la solicitud.
Aunque el atributo del ID de usuario es opcional, se debe proporcionar el ID de usuario. Consulte <tsx:userid> y <tsx:passwd> para obtener una alternativa a la codificación de esta información en el archivo JSP.
- passwd
Un atributo opcional que especifica la contraseña de usuario para el atributo de ID de usuario. (Este atributo no es opcional si se especifica el atributo de ID de usuario). Si se especifica, este atributo y su valor se añaden al objeto de la solicitud.
Aunque el atributo del ID de usuario es opcional, se debe proporcionar la contraseña. Consulte <tsx:userid> y <tsx:passwd> para obtener una alternativa a la codificación de esta información en el archivo JSP.
- url y driver
Es un atributo necesario si desea establecer una conexión de base de datos. Debe proporcionar el URL y el controlador.
El servidor de aplicaciones da soporte a la conexión con las bases de datos JDBC y las bases de datos ODBC.
- En una base de datos JDBC, el URL se compone de los siguientes
elementos separados por el carácter de dos puntos: jdbc, el nombre del
subprotocolo y el nombre de la base de datos a la que se va a acceder.
Un ejemplo de una conexión a la base de
datos Sample que se incluye con IBM® DB2 es el siguiente:
url="jdbc:db2:sample" driver="com.ibm.db2.jdbc.app.DB2Driver"
- En una base de datos ODBC, utilice el controlador del puente de JDBC
a ODBC de Sun que se incluye en el SDK (Software Developers Kit) de
Java2 o en el controlador ODBC de otro proveedor.
El atributo del url especifica la ubicación de la base de datos. El atributo driver especifica el nombre del controlador que se va a utilizar para establecer la conexión de la base de datos.
Si la base de datos es una base de datos ODBC, puede utilizar un controlador ODBC o el puente JDBC a ODBC. Si desea utilizar un controlador ODBC, consulte la documentación del mismo para obtener más instrucciones acerca de cómo especificar la ubicación de la base de datos con el atributo de url y el nombre del controlador.
En el caso del puente, la sintaxis del url es jdbc:odbc:basedatos. A continuación se muestra un ejemplo:
url="jdbc:odbc:autos" driver="sun.jdbc.odbc.JdbcOdbcDriver"
Nota: para permitir que el servidor de aplicaciones acceda a la base de datos ODBC, utilice el administrador de origen de datos ODBC para añadir el origen de datos ODBC a la configuración DSN del sistema. Para acceder al Administrador ODBC, pulse el icono Fuentes de datos ODBC del Panel de control de Windows NT.
- En una base de datos JDBC, el URL se compone de los siguientes
elementos separados por el carácter de dos puntos: jdbc, el nombre del
subprotocolo y el nombre de la base de datos a la que se va a acceder.
Un ejemplo de una conexión a la base de
datos Sample que se incluye con IBM® DB2 es el siguiente:
- jndiname
Un atributo opcional que identifica un contexto válido en el contexto de denominación JNDI (Java Naming and Directory Interface) del servidor de aplicaciones y el nombre lógico del origen de datos en dicho contexto. El administrador web configura el contexto a través de un cliente de administración como, por ejemplo, la consola administrativa de WebSphere.
Si especifica el atributo jndiname, el procesador JSP ignora los atributos del url y del controlador en el distintivo <tsx:dbconnect>.
Es válido cualquier elemento vacío (como <url></url>).