Création et configuration des références de ressources pour Web 2.5 et Web 3.0

Vous pouvez créer et configurer des références de ressources pour les projets Web 2.5 et Web 3.0 à l'aide du descripteur de déploiement.

Pourquoi et quand exécuter cette tâche

Vous devez créer un projet Web à l'aide de Web 2.5 et Web 3.0 avant de créer et configurer des références de ressources. 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 :
    Ajouter une 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>
Icône indiquant le type de rubrique Rubrique de tâche
Dispositions pour les centres de documentation | Commentaires en retour

Icône d'horodatage Dernière mise à jour: May 29, 2014 10:11

Nom de fichier : tcreateconfigresref.html