Validation du module de service Project avec JUnit

Après avoir appliqué un pattern de module de service HCL Commerce, un projet Project-UnitTests est créé afin de fournir un emplacement pour les tests JUnit des services que vous avez créés.

Pourquoi et quand exécuter cette tâche

Dans le projet de test unitaire généré, une unique classe de test, ProjectFacadeClientTest, est également créée. Cette classe de test étend la classe JUnit TestCase et contient des méthodes de test pour chaque service qui sera pris en charge par le module de service. Ces méthodes de test construisent des objets de requête de service vides et utilisent la classe de bibliothèque client générée pour émettre la requête de service Web et recevoir la réponse du service.

Utilisez la classe de test JUnit fournie, ProjectFacadeClientTest, afin de valider votre module de service Project.

Procédure

  1. Importez le test JUnit ProjectFacadeClientTest fourni :
    1. Dans la vue Explorateur d'entreprise, développez Project-UnitTests > src, puis cliquez avec le bouton droit sur le package com.mycompany.commerce.project.facade.
    2. Cliquez sur Importer. Développez Généralités et sélectionnez Système de fichiers. Cliquez sur Suivant.
    3. Accédez au répertoire temporaire dans lequel vous avez extrait le fichier RecipeServices.zip.
    4. Accédez au dossier com.mycompany.commerce.Project.facade.
    5. Sélectionnez ProjectFacadeClientTest.java.
    6. Cliquez sur Terminer. Cliquez sur Oui pour tout pour remplacer le fichier existant.
    7. Ouvrez le fichier ProjectFacadeClientTest.java en édition.
    8. Recherchez le commentaire // TODO Change the username and password to match the server. Mettez à jour dans la classe le nom et le mot de passe de l'administrateur de site HCL Commerce afin qu'ils correspondent à votre serveur.
    9. Recherchez le commentaire // TODO: modify the test storeID. Remplacez le nombre 11301 par le storeId de votre magasin.
    10. Sauvegardez vos modifications.
    11. Dans le menu Projet, sélectionnez Générer le projet, si Générer automatiquement n'est pas sélectionné.
  2. Organisez les importations pour le projet Project-UnitTests :
    1. Ouvrez la perspective Java dans HCL Commerce Developer.
    2. Développez Project-UnitTests. Cliquez avec le bouton droit sur src et sélectionnez Source > Organiser les importations.
    3. Enregistrez tous les fichiers ouverts. Sélectionnez Fichier > Tout enregistrer.
  3. Mettez à jour les dépendances JAR pour les applications HCL Commerce et Eclipse Modeling Framework sur le chemin d'accès de génération du projet de test d'unité.
    1. Cliquez avec le bouton droit sur Project-UnitTests.
    2. Sélectionnez Chemin de génération > Configurer le chemin de génération.
    3. Sous l'onglet Bibliothèques, dans la liste des fichiers JAR et des dossiers de classe sur le chemin d'accès de génération, sélectionnez WebSphere Application Server v8.5 [HCL Commerce Runtime]. Ensuite, cliquez sur Retirer.
    4. Cliquez sur Ajouter des fichiers JAR.
    5. Dans la liste de sélection JAR, sélectionnez les fichiers JAR suivants. Cliquez ensuite sur OK.
      • Search-eardir/lib/commons-logging-1.2.jar
      • WC/lib/commons-logging.jar
    6. Cliquez sur Ajouter des fichiers JAR externes.
    7. Accédez au répertoire WAS_installdir\runtimes et sélectionnez le fichier JAR com.ibm.ws.webservices.thinclient_9.0.jar.
    8. Cliquez sur Ouvrir pour ajouter le fichier JAR au chemin d'accès de génération.
    9. Répétez les étapes 3.f à 3.h pour ajouter les fichiers JAR suivants qui se trouvent dans le répertoire WAS_installdir\plugins\ au chemin d'accès de génération du projet.
      • org.eclipse.emf.common.jar
      • org.eclipse.emf.commonj.sdo.jar
      • org.eclipse.emf.ecore.change.jar
      • org.eclipse.emf.ecore.jar
      • org.eclipse.emf.ecore.sdo.jar
      • org.eclipse.emf.ecore.xmi.jar
      Remarque : Vous pouvez utiliser la fonction de sélection multiple pour ajouter plusieurs fichiers JAR à la bibliothèque plutôt que d'ajouter les fichiers individuellement.
    10. Sous l'onglet Bibliothèques, cliquez sur OK.
  4. Démarrez ou redémarrez le serveur de test HCL Commerce.
  5. Cliquez avec le bouton droit de la souris sur HCL Commerce Test Serveur et sélectionnez Publier.
  6. Configurez un moniteur TCP/IP dans HCL Commerce Developer. Utilisez ce moniteur TCP/IP pour observer les documents de requête et de réponse en provenance et en direction du service HCL Commerce que vous avez créé.
    1. Sélectionnez Fenêtre > Préférences.
    2. Depuis le panneau Préférences, développez Exécuter/Déboguer > Moniteur TCP/IP.
    3. Cliquez sur Ajouter.
    4. Entrez les informations suivantes :
      • Port de surveillance local :81.
      • Nom d'hôte : Le hostname du serveur HCL Commerce sur lequel s'exécute le service Project.
      • Port :80 pour HCL Commerce Developer, 8007 pour un environnement de production
    5. Cliquez sur OK.
    6. Sélectionnez le moniteur TCP/IP créé.
    7. Cliquez sur Démarrer.
    8. Cliquez sur OK.
  7. Insérez les données de test dans la base de données de HCL Commerce :
    1. Accédez à l'emplacement temporaire où vous avez décompressé le fichier RecipeServices.zip, et dans le dossier RecipeServices/data, ouvrez data.txt dans un éditeur de texte.
    2. Remplacez le nombre 11301 par le storeId que vous utilisez.
    3. Ouvrez une nouvelle fenêtre de navigateur et entrez l'URL suivante : http://localhost/webapp/wcs/admin/servlet/db.jsp.
    4. Copiez le contenu de l'éditeur de texte dans la zone de texte d'entrée de la fenêtre du navigateur.
    5. Cliquez sur Soumettre la requête.
  8. Dans la vue Explorateur d'entreprise, vérifiez l'absence d'erreurs de compilation dans vos projets.
  9. Exécutez le test JUnit :
    1. Développez Project-UnitTests > src > com.mycompany.commerce.project.facade.
    2. Cliquez avec le bouton droit de la souris sur la classe ProjectFacadeClientTest.java et sélectionnez Exécuter en tant que > Test JUnit.
    3. Passez en revue la vue de test JUnit et le moniteur TCP/IP.
      • Dans le moniteur TCP/IP, les documents XML BOD de requête et de réponse transmis entre le serveur et le client s'affichent si le test est réussi.
      • Dans la vue de test JUnit, une barre verte s'affiche lorsque le test est réussi.
      Vous pouvez également cliquer sur l'onglet Console pour afficher un message qui indique que le scénario de test est concluant.