Implémentation de la bibliothèque client

L'objectif principal de la bibliothèque client est de simplifier et d'éliminer le code sur le client. La bibliothèque client est essentiellement une couche Java destinée à aider les applications Java à s'intégrer dans votre architecture de services, sans besoin de générer du code supplémentaire. Elle prend déjà en charge les sessions et l'authentification et fournit aux clients basés Java un mécanisme normalisé pour création d'objets SDO logiques représentant des requêtes de service.

Pourquoi et quand exécuter cette tâche

Chaque module de service fournit un projet de bibliothèque client pour accéder aux services fournis par le module. Le projet client contient les ressources suivantes :
  • Interfaces du service fournies pour chaque nom
  • Un fichier contenant des constantes et qui peut être partagé entre le client et le serveur
  • Un module client contenant :
    • La classe abstraite de client Java contenant les méthodes communes et les méthodes requises
    • Une classe Java activée pour le Web, facilitant la programmation, venant étendre la classe abstraite afin d'implémenter les méthodes conviviales Java et compatibles Web
    • Des exceptions spécifiques au nom pour la représentation des erreurs côté client et serveur

Cette leçon du tutoriel présente comment ajouter des méthodes de simplification afin de contourner la complexité de création des différentes requêtes GetProject et ChangeProject.

Procédure

  1. Importez la classe ProjectFacadeConstants fournie :
    1. Dans la vue Explorateur d'entreprise, développez Project-Client > src.
    2. Cliquez avec le bouton droit de la souris sur com.mycompany.commerce.project.facade. Cliquez sur Importer.
    3. Développez Généralités, sélectionnez Système de fichiers puis cliquez sur Suivant.
    4. Accédez au répertoire temporaire dans lequel vous avez extrait le fichier RecipeServices.zip.
    5. Accédez au dossier com.mycompany.commerce.project.facade. Sélectionnez le dossier, puis cliquez sur Ok.
    6. Sélectionnez ProjectFacadeConstants.java. Cliquez sur Terminer.
    7. Cliquez sur Oui pour remplacer le fichier existant.
  2. Importez la classe ProjectFacadeClient.java fournie qui contient les méthodes clientes adaptées à Java :
    1. Développez Project-Client > src.
    2. Cliquez avec le bouton droit de la souris sur com.mycompany.commerce.project.facade.client. Cliquez sur Importer.
    3. Développez Généralités, sélectionnez Système de fichiers puis cliquez sur Suivant.
    4. Accédez au répertoire temporaire dans lequel vous avez extrait le fichier RecipeServices.zip.
    5. Accédez au dossier com.mycompany.commerce.project.facade.client. Sélectionnez le dossier, puis cliquez sur Ok.
    6. Sélectionnez ProjectFacadeClient.java. Cliquez sur Terminer.
    7. Cliquez sur Oui pour remplacer le fichier existant.
  3. Organisez les importations pour le projet Project-Client :
    1. Ouvrez la perspective Java dans HCL Commerce Developer.
    2. Développez Project-Client.
    3. Cliquez avec le bouton droit de la souris sur le dossier src et sélectionnez Source > Organiser les importations.