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

Vous devez créer un projet Web 2.5, Web 3.0 ou Web 3.1 pour pouvoir créer et configurer des références de ressource. Sélectionnez Générer un descripteur de déploiement dans l'assistant de création de projet.

Procédure

  1. Développez le projet Web et sélectionnez WebContent > WEB-INF > web.xml.
  2. 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.
  3. Dans la zone Application Web, sélectionnez Ajouter, puis Référence de ressource et cliquez sur OK :
    Ajout de référence de ressource
  4. Dans la section Détails, indiquez les détails de vos références de ressources :
    1. Dans la zone Nom, indiquez un nom pour votre référence de ressource.
    2. Dans la zone Type, indiquez la référence de ressource.
    3. Dans la zone Authentification, sélectionnez Application ou Conteneur pour l'authentification de votre référence de ressource.
    4. 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.
    5. Dans la zone Description, indiquez une description de cette référence de ressource.
  5. 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>
  6. Pour modifier la référence de ressource, utilisez la vue Conception ou Source de la page du descripteur de déploiement.
  7. 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 :
    1. 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.
    2. Cliquez avec le bouton droit de la souris sur le fichier ibm-web-bnd.xml et sélectionnez Ouvrir avec > Editeur de liaisons Web.
    3. Ajoutez une référence de resswource :
      1. Dans la vue Conception, cliquez sur Ajouter.
      2. Dans la fenêtre Ajouter un élément, sélectionnez Référence de ressource. Cliquez sur OK.
      3. Dans la zone Nom, indiquez le nom de votre référence de ressource, par exemple : SAMPLE.
      4. Dans la zone Nom de la liaison, indiquez le nom de votre référence de ressource, par exemple : jdbc/SAMPLE.
    4. Dans la vue Conception, mettez en évidence la référence de ressource et cliquez sur Ajouter > Alias d'authentification.
    5. 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).
      Ajouter une liaison JNDI
    6. Enregistrez ce fichier.
    7. 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>
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcreateconfigresref.html