Syntaxe JSP de la balise dbquery (obsolète)
Utilisez la balise <tsx:dbquery> pour établir une connexion à une base de données, soumettre des requêtes à cette dernière et renvoyer l'ensemble de résultats.
La prise en charge des balises tsx dans le moteur JSP (JavaServer Pages) est dépréciée dans WebSphere Application Server Version 6.0. Remplacez les balises tsx par des balises équivalentes JSTL (JavaServer Pages Standard Tag Library).
La requête <tsx:dbquery> effectue les opérations suivantes :
- Elle référence une balise <tsx:dbconnect> dans le même fichier JavaServer Pages (JSP) et utilise les informations fournies par la balise pour déterminer le pilote et l'URL de base de données. Vous pouvez aussi obtenir l'ID utilisateur et le mot de passe à partir de la balise <tsx:dbconnect> si ces valeurs sont spécifiées dans la balise <tsx:dbconnect>.
- Elle établit une nouvelle connexion.
- Elle extrait les données de l'objet résultat et les place en cache.
- Elle ferme la connexion et libère la ressource de connexion.
Cette section décrit la syntaxe de la balise <tsx:dbquery>.
<%-- Les commandes SELECT et la syntaxe JSP (facultative) peuvent être placées dans la balise tsx:dbquery. --%> <%-- Toute autre syntaxe, y compris les commentaires HTML, n'est pas valide. --%> <tsx:dbquery id="id_requête" connection="id_connexion" limit="valeur" > </tsx:dbquery>
où :
- id
Représente l'identificateur de la requête. Sa portée est le fichier JSP. Utilisez id pour référencer la requête. Par exemple, à partir de la balise <tsx:getProperty>, utilisez id pour afficher les résultats de la requête.
L'id est une référence tsx au bean et peut être utilisé pour extraire le bean du contexte de la page. Par exemple, si l'ID est nommé mySingleDBBean, au lieu d'utiliser :- 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 Prénom, Nom from Employee where FNAME='Jim'
- connection
Représente l'identificateur d'une balise <tsx:dbconnect> dans ce fichier JSP. La balise <tsx:dbconnect> fournit l'URL de base de données, le nom du pilote et, de façon facultative, l'ID utilisateur et le mot de passe permettant d'établir la connexion.
- limit
Représente un attribut facultatif imposant une limite au nombre d'enregistrements renvoyés par une requête. Lorsque cet attribut n'est pas précisé, aucune limite n'est appliquée hormis celle déterminée par le nombre d'enregistrements et par les possibilités de mise en cache du système.
- Commande SELECT et syntaxe JSP
SELECT est la seule commande SQL valide. La balise <tsx:dbquery> doit renvoyer un ensemble de résultats. Pour plus d'informations sur cette commande, reportez-vous à la documentation relative à votre base de données. Dans les autres articles de la présente section vous trouverez la description de la syntaxe JSP pour les données variables et l'insertion de code Java™ en ligne.