Création d'un projet Web dynamique

Pour développer une couche présentation Web pour votre application Java, vous pouvez créer un projet Web dynamique.

Avant de commencer

Vous devez avoir installé les outils du développeur pour le profil Liberty. Pour plus d'informations, voir Installation du profil Liberty.

Pourquoi et quand exécuter cette tâche

La prise en charge des projets Web dynamiques est assurée par les outils du développeur Web. Cependant, pour développer et compiler des servlets et des pages JSP, vous devez ajouter la bibliothèque correcte à vos projets. Cette bibliothèque est fournie avec CICS Explorer SDK. Vous pouvez également utiliser CICS Explorer SDK pour déployer le projet Web dynamique avec le reste de l'application Java et l'exécuter dans CICS.

Procédure

  1. Créez un projet Web dynamique :
    1. Cliquez sur Fichier > Nouveau > Projet L'assistant Nouveau projet s'ouvre.
    2. Développez le dossier Web et cliquez sur Projet Web dynamique. Les autres types de projet Web ne peuvent pas s'exécuter dans CICS.
    3. Complétez les champs dans l'assistant et cliquez sur Terminer pour créer le projet.
  2. Mettez à jour le chemin de génération :
    1. Cliquez avec le bouton droit de la souris sur le projet Web dynamique et cliquez sur Chemin de génération > Configurer le chemin de génération. La boîte de dialogue Propriétés s'ouvre pour le projet.
    2. Dans le chemin de génération Java, cliquez sur l'onglet Bibliothèques.
    3. Cliquez sur Ajouter une bibliothèque et sélectionnez Profil Liberty dans CICS.
    4. Cliquez sur Suivant > Terminer pour terminer l'ajout de la bibliothèque. Cliquez sur OK pour enregistrer vos modifications.
  3. Facultatif : Pour créer une application qui utilise la sécurité CICS, créez un fichier web.xml. Vous pouvez créer un fichier XML qui utilise le modèle CICS SDK pour Servlet et JSP web.xml, ou générer le fichier web.xml à partir du projet. Pour créer un fichier XML à partir du modèle, cliquez sur NouveauFichier XML et suivez l'assistant. Pour générer le fichier, procédez comme suit :
    1. Cliquez avec le bouton droit de la souris sur le descripteur de déploiement dans le projet et sélectionnez Générer le talon de descripteur de déploiement.Cette option génère le fichier web.xml.
    2. Ouvrez le fichier web.xml en développant WebContent > WEB-INF et en cliquant deux fois sur le fichier.
    3. Pour déléguer la sécurité à CICS, ajoutez une définition de sécurité. Utilisez le raccourci-clavier Ctrl+Space et continuez de cliquer jusqu'à avoir répertorié les modèles XML. Sélectionnez Contrainte de sécurité CICS SDK pour Servlet et JSP. Le modèle crée une définition de sécurité que vous pouvez éditer pour votre application :
      <security-constraint>
         <display-name>Contrainte de sécurité d'application</display-name>
         <web-resource-collection>
            <web-resource-name>application</web-resource-name>
            <description>Zone de protection pour mon application Web</description>
            <url-pattern>/*</url-pattern>
         </web-resource-collection>
         <auth-constraint>
           <description>Tous les utilisateurs authentifiés de mon application</description>
           <role-name>cicsAllAuthenticated</role-name>
         </auth-constraint>
      </security-constraint>
      <user-data-constraint>
         <transport-guarantee>CONFIDENTIAL</transport-guarantee>
      </user-data-constraint>
      L'élément <display-name> indique un nom abrégé de l'application Web qui peut être affiché par les outils. L'élément <web-resource-name> indique l'application. Vous pouvez attribuer les valeurs de votre choix à ces éléments et descriptions. Indiquez /* dans l'élément <url-pattern> pour protéger toutes les URL de l'application.

      L'élément <user-data-constraint> force l'application à utiliser un port HTTPS. Si vous ne souhaitez pas utiliser SSL, supprimez la section <user-data-constraint>.

Résultats

Vous avez créé un projet Web dynamique et ajouté les bibliothèques servlet à votre chemin de génération pour développer un projet Web.

Que faire ensuite

Développez votre couche présentation Web et ajoutez-la à un projet de regroupement CICS pour le déploiement. Pour plus d'informations, voir Ajout d'un projet à un projet de regroupement CICS.

Vous pouvez éventuellement ajouter des ressources URIMAP et TRANSACTION pour votre application Web dans le projet de regroupement. La ressource URIMAP mappe les requêtes entrantes pour l'application Web dans une transaction CICS. Les utilisateurs d'application sont autorisés à utiliser l'application basée sur la transaction en cours d'exécution. Pour plus d'informations, voir Création d'une transaction et d'une carte d'identificateur URI.