< Précédent | Suivant >

Leçon 1 : Créer un serveur et un projet web

Dans cette leçon, vous allez créer un serveur et un projet Web à utiliser avec les services Web.

Créer un serveur compatible JAX-WS

Avant de créer le service Web, veillez à ce qu'un serveur WebSphere® Application Server v8.0 soit configuré et démarré. Par défaut, un serveur est créé lors de l'installation de WebSphere Application Server. Il est visible dans la vue Serveurs. Toutefois, si vous voulez créer un serveur, procédez comme suit :
  1. Dans le menu Fichier, sélectionnez Nouveau > Autre > Serveur > Serveur > Suivant.
  2. Sélectionnez WebSphere Application Server v8.0 comme type de serveur. Cliquez sur Suivant.
  3. Si cet environnement d'exécution n'a pas été créé dans votre espace de travail, vous serez invité à sélectionner le répertoire d'installation pour le serveur. Cliquez sur Next.
  4. Acceptez le port et le nom de serveur définis par défaut. Pour ce tutoriel, le nom du serveur par défaut sera server1. Cliquez sur Terminer.
  5. Attendez le démarrage du serveur. Une fois que ce dernier a démarré, la vue de console affiche le message Serveur serveur1 prêt pour l'e-business. Si le serveur ne démarre pas automatiquement, sélectionnez-le dans la vue Serveurs et cliquez sur l'icône de démarrage : icône de démarrage du serveur.

Créer un projet Web pour le service Web

Les assistants de services Web peuvent créer un projet Web pour le service Web et activer automatiquement les facettes. Cependant, dans ce tutoriel, vous allez créer le projet manuellement.
  1. Dans la perspective Java EE, cliquez avec le bouton droit de la souris sur votre projet d'application d'entreprise, puis sélectionnez Nouveau > Projet Web pour l'assistant de projet Web.
  2. Dans la zone Nom, tapez un nom pour votre projet Web. Pour ce tutoriel, utilisez jwsAddressBook.
  3. Dans la section Modèles de projet, sélectionnez le type de modèle Web que vous souhaitez utiliser : Pour ce tutoriel, sélectionnez Simple.
    Option Description
    Dojo Toolkit Configure le projet pour le doter de capacités Dojo. Les ressources Dojo peuvent être situées dans le projet lui-même, dans un projet à part ou à en un point distant accessible par HTTP.
    JavaServer Faces Permet au projet d'être déployé avec des capacités JSF. La configuration est effectuée soit pour la technologie JSP, soit pour la technologie Facelets.
    Services REST Un projet configuré pour des services REST basés sur JAX-RS
    Simple Crée un projet Web élémentaire.
  4. Dans la section Modèle de programmation, sélectionnez le modèle que vous souhaitez utiliser : Pour ce tutoriel, sélectionnez Java EE.
    • Côté client uniquement (HTML, JavaScript,...)
    • Java EE
    • OSGi
  5. Cliquez sur Suivant pour configurer votre nouveau projet Web.
  6. Dans la page Déploiement, depuis la liste des options de configuration disponibles, cliquez sur Déploiement pour ouvrir la page Configuration du déploiement.
    • Dans la zone Environnement d'exécution cible, sélectionnez la version 7 ou 8 de WebSphere Application Server que vous avez installée dans le tutoriel.
    • Dans la zone Version de module Web, acceptez la version par défaut (qui est sélectionnée automatiquement en fonction du serveur WebSphere Application Server que vous avez sélectionné).
    • Dans la zone Appartenance EAR, sélectionnez Ajouter un projet à un fichier EAR et assurez-vous que jwsAddressBookEAR est le nom du projet EAR.
    • Dans la section Déploiement, sélectionnez Changer les fonctions. Sur la page Facettes du projet, sélectionnez JAX-RS (Services Web REST), version 1.1 et cliquez sur OK.
  7. Dans la liste des options de configuration disponibles, cliquez sur Java pour ouvrir la page de configuration Java.
    • Dans la zone Dossiers source dans le chemin de génération, vous pouvez soit accepter le répertoire par défaut src, soit cliquer sur Ajouter un dossier, Editer... ou Supprimer pour indiquer un dossier pour vos fichiers source.
    • Dans la zone Dossier de sortie par défaut :, indiquez un dossier pour vos fichiers de sortie ou acceptez la valeur par défaut (WebContent\WEB-INF\classes).
      Important: Si vous sélectionnez un fichier autre que WebContent\WEB-INF\classes pour votre dossier de sortie par défaut, la vue Incidents affiche un avertissement :
      Avertissement de racine unique
      Par défaut, les problèmes de racine unique génèrent un avertissement. Pour modifier ce paramètre, utilisez la page Filtres de validation pour le valideur de structure de projet :
      1. Cliquez sur Fenêtre > Préférences > Validation > Validation de la structure du projet, puis sur le bouton ... pour Paramètres.
      2. Dans la page Filtres de validation pour le valideur de structure de projet, indiquez le niveau de gravité par défaut. Les niveaux de sécurité disponibles sont Erreur, Avertissement et Ignorer.
  8. Dans la liste des options de configuration disponibles, cliquez sur Module Web. Dans la page Configuration de module Web :
    • Dans la zone Racine du contexte, tapez le nom de la racine de votre projet Web ou acceptez la valeur par défaut (c'est-à-dire le nom de votre projet Web).
    • Dans la zone Répertoire de contenu, entrez le nom de votre répertoire de contenu ou acceptez la valeur par défaut (WebContent).
    • Si vous voulez créer un descripteur de déploiement, sélectionnez Générer un descripteur de déploiement web.xml. Vous pouvez aussi ajouter un descripteur de déploiement à votre module Web ultérieurement. Vous devez utiliser un fichier web.xml pour configurer les contraintes de sécurité et autre comportement.
  9. Cliquez sur Terminer.

Créer un projet Web pour le client de service Web

Les assistants de services Web peuvent créer un projet Web pour le client et activer automatiquement les facettes. Cependant, dans ce tutoriel, vous allez créer le projet manuellement.
  1. Dans la perspective Java EE, cliquez avec le bouton droit de la souris sur votre projet d'application d'entreprise, puis sélectionnez Nouveau > Projet Web pour l'assistant de projet Web.
  2. Dans la zone Nom, tapez un nom pour votre projet Web. Pour ce tutoriel, utilisez jwsAddressBookClient.
  3. Dans la section Modèles de projet, sélectionnez le type de modèle Web que vous souhaitez utiliser : Pour ce tutoriel, sélectionnez Simple.
    Option Description
    Dojo Toolkit Configure le projet pour le doter de capacités Dojo. Les ressources Dojo peuvent être situées dans le projet lui-même, dans un projet à part ou à en un point distant accessible par HTTP.
    JavaServer Faces Permet au projet d'être déployé avec des capacités JSF. La configuration est effectuée soit pour la technologie JSP, soit pour la technologie Facelets.
    Services REST Un projet configuré pour des services REST basés sur JAX-RS
    Simple Crée un projet Web élémentaire.
  4. Dans la section Modèle de programmation, sélectionnez le modèle que vous souhaitez utiliser : Pour ce tutoriel, sélectionnez Java EE.
    • Côté client uniquement (HTML, JavaScript,...)
    • Java EE
    • OSGi
  5. Cliquez sur Suivant pour configurer votre nouveau projet Web.
  6. Dans la page Déploiement, depuis la liste des options de configuration disponibles, cliquez sur Déploiement pour ouvrir la page Configuration du déploiement.
    • Dans la zone Environnement d'exécution cible, sélectionnez la version 7 ou 8 de WebSphere Application Server que vous avez installée dans le tutoriel.
    • Dans la zone Version de module Web, acceptez la version par défaut (qui est sélectionnée automatiquement en fonction du serveur WebSphere Application Server que vous avez sélectionné).
    • Dans la zone Appartenance EAR, sélectionnez Ajouter un projet à un fichier EAR et assurez-vous que jwsAddressBookEAR est le nom du projet EAR.
    • Dans la section Déploiement, sélectionnez Changer les fonctions. Sur la page Facettes du projet, sélectionnez JAX-RS (Services Web REST), version 1.1 et cliquez sur OK.
  7. Dans la liste des options de configuration disponibles, cliquez sur Java pour ouvrir la page de configuration Java.
    • Dans la zone Dossiers source dans le chemin de génération, vous pouvez soit accepter le répertoire par défaut src, soit cliquer sur Ajouter un dossier, Editer... ou Supprimer pour indiquer un dossier pour vos fichiers source.
    • Dans la zone Dossier de sortie par défaut :, indiquez un dossier pour vos fichiers de sortie ou acceptez la valeur par défaut (WebContent\WEB-INF\classes).
      Important: Si vous sélectionnez un fichier autre que WebContent\WEB-INF\classes pour votre dossier de sortie par défaut, la vue Incidents affiche un avertissement :
      Avertissement de racine unique
      Par défaut, les problèmes de racine unique génèrent un avertissement. Pour modifier ce paramètre, utilisez la page Filtres de validation pour le valideur de structure de projet :
      1. Cliquez sur Fenêtre > Préférences > Validation > Validation de la structure du projet, puis sur le bouton ... pour Paramètres.
      2. Dans la page Filtres de validation pour le valideur de structure de projet, indiquez le niveau de gravité par défaut. Les niveaux de sécurité disponibles sont Erreur, Avertissement et Ignorer.
  8. Dans la liste des options de configuration disponibles, cliquez sur Module Web. Dans la page Configuration de module Web :
    • Dans la zone Racine du contexte, tapez le nom de la racine de votre projet Web ou acceptez la valeur par défaut (c'est-à-dire le nom de votre projet Web).
    • Dans la zone Répertoire de contenu, entrez le nom de votre répertoire de contenu ou acceptez la valeur par défaut (WebContent).
    • Si vous voulez créer un descripteur de déploiement, sélectionnez Générer un descripteur de déploiement web.xml. Vous pouvez aussi ajouter un descripteur de déploiement à votre module Web ultérieurement. Vous devez utiliser un fichier web.xml pour configurer les contraintes de sécurité et autre comportement.
  9. Cliquez sur Terminer.

Téléchargez le fichier WSDL du carnet d'adresses

Téléchargez le fichier WSDL requis.

Etat des connaissances

Vous pouvez à présent commencer la leçon 2 : Création du service Web .

< Précédent | Suivant >
Icône indiquant le type de rubrique Rubrique de leçon de tutoriel
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 : jaxwstd_exercise11.html