Sintaxis JSP (JavaServer Pages) del distintivo dbquery (en desuso)
Utilice el distintivo <tsx:dbquery> para establecer una conexión con una base de datos, enviar consultas a la base de datos y devolver el conjunto de resultados.
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).
El distintivo <tsx:dbquery> efectúa lo siguiente:
- Hace referencia a un distintivo <tsx:dbconnect> del mismo archivo JSP (JavaServer Pages) y utiliza la información que éste proporciona para determinar el controlador y el URL de la base de datos. También puede obtener el ID de usuario y la contraseña del distintivo <tsx:dbconnect>, si estos valores se proporcionan en el distintivo <tsx:dbconnect>.
- Establece una nueva conexión
- Recupera y almacena en memoria caché los datos del objeto de resultados.
- Cierra la conexión y libera el recurso de conexión.
Esta sección describe la sintaxis del distintivo <tsx:dbquery>.
<%-- Los mandatos SELECT y la sintaxis de JSP (opcional) se pueden situar dentro de tsx:dbquery. --%> <%-- Ninguna otra sintaxis, incluidos los comentarios de HTML, es válida. --%> <tsx:dbquery id="id_consulta" connection="id_conexión" limit="valor" > </tsx:dbquery>
donde:
- id
Es el identificador de esta consulta. El ámbito es el archivo JSP. Utilice el id para hacer referencia a la consulta. Por ejemplo, desde el distintivo <tsx:getProperty>, utilice id para visualizar los resultados de la consulta.
El id es una referencia tsx al bean y se puede utilizar para recuperar el bean del contenido de la página. Por ejemplo, si el id se denomina mySingleDBBean, en lugar de utilizar:- if (mySingleDBBean.getValue("UISEAM",0).startsWith("N"))
- com.ibm.ws.webcontainer.jsp.tsx.db.QueryResults bean = (com.ibm.ws.webcontainer.jsp.tsx.db.QueryResults)pageContext. findAttribute("mySingleDBBean"); if (bean.getValue("UISEAM",0).startsWith("N")). . .
Select FNAME, LNAME AS FirstName, LastName from Employee where FNAME='Jim'
- connection
Representa el identificador de un distintivo <tsx:dbconnect> en este archivo JSP. El distintivo <tsx:dbconnect> proporciona el URL de la base de datos, el nombre del controlador y, opcionalmente, el ID de usuario y la contraseña para la conexión.
- limit
Un atributo opcional que restringe el número máximo de registros que devuelve una consulta. Si no se especifica el atributo, no se utiliza ningún límite. En tal caso, el límite efectivo lo determina el número de registros y la posibilidad de almacenamiento en memoria caché del sistema.
- Mandato SELECT y sintaxis de JSP
El único mandato SQL válido, SELECT. El distintivo <tsx:dbquery> debe devolver un conjunto de resultados. Consulte la documentación de la base de datos para obtener más información acerca del mandato SELECT. En otras secciones de este documento se proporciona una descripción de la sintaxis de JSP para los datos variables y el código Java™ incorporado.