Syntaxe JSP de la balise tsx:dbconnect (obsolète)
Utilisez la balise <tsx:dbconnect> pour spécifier les informations nécessaires à l'établissement de la connexion à une base de données par l'intermédiaire de la technologie JDBC (Java™ DataBase Connectivity) ou ODBC (Open Database Connectivity).
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 syntaxe <tsx:dbconnect> n'établit pas la connexion. Utilisez la syntaxe <tsx:dbquery> et <tsx:dbmodify> pour référencer une balise <tsx:dbconnect> dans le même fichier JSP (JavaServer Pages) pour établir la connexion.
Lorsque le fichier JSP est compilé dans un servlet, le processeur Java ajoute le code Java de la syntaxe <tsx:dbconnect> à la méthode service() du servlet, ce qui signifie qu'une nouvelle connexion de base de données est créée pour chaque requête du fichier JSP.
Cette section décrit la syntaxe de la balise <tsx:dbconnect>.
<tsx:dbconnect id="id_connexion" userid="utilisateur_bdd" passwd="mot_passe_utilisateur" url="jdbc:sous-protocole:base_de_données" driver="nom_pilote_bdd" jndiname="JNDI_contexte/nom_logique"> </tsx:dbconnect >
où :
- id
Représente un identificateur indispensable. Sa portée est le fichier JSP. Cet identificateur est référencé par l'attribut de connexion d'une balise <tsx:dbquery>.
- userid
Représente un attribut optionnel spécifiant un ID utilisateur valide pour la base de données à laquelle vous souhaitez accéder. Lorsqu'il est précisé, cet attribut et sa valeur associée sont ajoutés à l'objet demande (request).
L'attribut userid est facultatif, mais l'ID de l'utilisateur doit être communiqué au fichier JSP d'une manière ou d'une autre. Pour obtenir une autre solution de codage de ces informations dans le fichier JSP, reportez-vous à la rubrique <tsx:userid> et <tsx:passwd>.
- passwd
Représente un attribut optionnel spécifiant le mot de passe associé à l'ID utilisateur identifié par l'attribut userid. (Cet attribut est obligatoire lorsque l'attribut userid est spécifié.) Lorsqu'il est précisé, cet attribut et sa valeur associée sont ajoutés à l'objet demande (request).
L'attribut passwd est facultatif, mais le mot de passe de l'utilisateur doit être communiqué au fichier JSP d'une manière ou d'une autre. Pour obtenir une autre solution de codage de cet attribut dans le fichier JSP, reportez-vous à la rubrique <tsx:userid> et <tsx:passwd>.
- url et driver
Ces attributs sont indispensables si vous souhaitez établir une connexion à une base de données. Vous devez fournir l'URL de la base de données et le nom du pilote utilisé.
Le serveur d'applications admet les connexions aux bases de données JDBC et ODBC.
- Pour une base de données JDBC, l'URL se compose des éléments suivants,
séparés les uns des autres par des signes deux-points :
jdbc, nom du sous-protocole, nom de la
base de données à laquelle on souhaite
accéder.
Par exemple, pour une connexion à la base de données Sample fournie avec
IBM® DB2 :
url="jdbc:db2:sample" driver="com.ibm.db2.jdbc.app.DB2Driver"
- Pour une base de données ODBC, utilisez le pilote de pont JDBC-ODBC de Sun inclus dans le SDK Java2
ou un pilote ODBC émanant d'un autre fournisseur.
L'attribut url indique l'emplacement de la base de données. L'attribut driver précise le nom du pilote à utiliser pour établir la connexion à la base de données.
Dans le cas d'une base de données ODBC, vous pouvez utiliser un pilote ODBC ou le pont JDBC-ODBC de Sun. Si vous souhaitez utiliser un pilote ODBC, reportez-vous à sa documentation pour savoir comment spécifier l'emplacement de la base de données avec l'attribut url et le nom du pilote.
Si vous utilisez le pont JDBC-ODBC, la syntaxe de l'attribut url est jdbc:odbc:nom_bdd. Voici un exemple :
url="jdbc:odbc:autos" driver="sun.jdbc.odbc.JdbcOdbcDriver"
Remarque : Pour permettre au serveur d'applications d'accéder à la base de données ODBC, ajoutez la source de données ODBC à la configuration DSN système via l'Administrateur de source de données ODBC. Pour accéder à cet outil, cliquez sur l'icône ODBC du panneau de configuration Windows NT.
- Pour une base de données JDBC, l'URL se compose des éléments suivants,
séparés les uns des autres par des signes deux-points :
jdbc, nom du sous-protocole, nom de la
base de données à laquelle on souhaite
accéder.
Par exemple, pour une connexion à la base de données Sample fournie avec
IBM® DB2 :
- jndiname
Représente un attribut optionnel identifiant un contexte valide dans le contexte de nommage JNDI (Java Naming and Directory Interface) du serveur d'applications et le nom logique de la source de données dans ce contexte. Le contexte est configuré par l'administrateur Web à l'aide d'un client d'administration, tel que la console d'administration WebSphere.
Si vous spécifiez l'attribut jndiname, le processeur JSP ignore les attributs de pilote et d'URL dans la balise <tsx:dbconnect>.
Un élément vide (tel que <url></url>) est valide.