Création de configuration de références de ressource pour les projets Web 2.5, Web 3.0 et Web 3.1
Vous pouvez créer et configurer à l'aide du descripteur de déploiement des références de ressource pour les projets Web 2.5, Web 3.0 et Web 3.1.
Pourquoi et quand exécuter cette tâche
Procédure
- Développez le projet Web et sélectionnez WebContent > WEB-INF > web.xml.
- Cliquez avec le bouton droit de la souris sur web.xml et sélectionnez Ouvrir avec > Editeur de descripteur de déploiement d'application Web.
- Dans la zone Application Web, sélectionnez Ajouter, puis Référence de ressource et cliquez sur OK :

- Dans la section Détails, indiquez les détails de vos références de ressources :
- Dans la zone Nom, indiquez un nom pour votre référence de ressource.
- Dans la zone Type, indiquez la référence de ressource.
- Dans la zone Authentification, sélectionnez Application ou Conteneur pour l'authentification de votre référence de ressource.
- Dans la zone Portée de partage, sélectionnez Partageable ou Non partageable pour la portée de partage de votre référence de ressource.
- Dans la zone Description, indiquez une description de cette référence de ressource.
- Pour afficher le code source web.xml, sélectionnez Source:
<?xml version="1.0" encoding="UTF-8"?> <web-app id="WebApp_ID" version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> <servlet> <description> </description> <display-name> TestServlet</display-name> <servlet-name>TestServlet</servlet-name> <servlet-class>test.TestServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>TestServlet</servlet-name> <url-pattern> /TestServlet</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.html</welcome-file> <welcome-file>index.htm</welcome-file> <welcome-file>index.jsp</welcome-file> <welcome-file>default.html</welcome-file> <welcome-file>default.htm</welcome-file> <welcome-file>default.jsp</welcome-file> </welcome-file-list> <resource-ref> <res-ref-name>SAMPLE</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> <res-sharing-scope>Shareable</res-sharing-scope> </resource-ref> </web-app> - Pour modifier la référence de ressource, utilisez la vue Conception ou Source de la page du descripteur de déploiement.
- Pour lier cette référence de ressource à une source de données sur le serveur, avec le nom JNDI jdbc/SAMPLE par le biais d'un alias d'authentification JAAS appelé USER_AUTH, modifiez le fichier ibm-web-bnd.xml et ajoutez les définitions suivantes :
- Si le fichier ibm-web-bnd.xml n'existe pas, créez-le en cliquant avec le bouton droit de la souris sur le projet ou en sélectionnant Outils Java EE > Générer un descripteur de déploiement de liaisons WebSphere.
- Cliquez avec le bouton droit de la souris sur le fichier ibm-web-bnd.xml et sélectionnez Ouvrir avec > Editeur de liaisons Web.
- Ajoutez une référence de resswource :
- Dans la vue Conception, cliquez sur Ajouter.
- Dans la fenêtre Ajouter un élément, sélectionnez Référence de ressource. Cliquez sur OK.
- Dans la zone Nom, indiquez le nom de votre référence de ressource, par exemple : SAMPLE.
- Dans la zone Nom de la liaison, indiquez le nom de votre référence de ressource, par exemple : jdbc/SAMPLE.
- Dans la vue Conception, mettez en évidence la référence de ressource et cliquez sur Ajouter > Alias d'authentification.
- Dans la section Détails et la zone Nom, indiquez un nom pour l'alias d'authentification (par exemple utilisez l'alias d'authentification JAAS appelé USER_AUTH).

- Enregistrez ce fichier.
- Pour afficher le code source ibm-web-bnd.xml, sélectionnez Source :
<?xml version="1.0" encoding="UTF-8"?> <web-bnd xmlns="http://websphere.ibm.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://websphere.ibm.com/xml/ns/javaee http://websphere.ibm.com/xml/ns/javaee/ibm-web-bnd_1_0.xsd" version="1.0"> <virtual-host name="default_host" /> <resource-ref name="SAMPLE" binding-name="jdbc/SAMPLE"> <authentication-alias name="USER_AUTH" /> </resource-ref> </web-bnd>
Rubrique parent : Création de modules Web