Création d'un module de service HCL Commerce
Le module de service HCL Commerce contient toutes les ressources utilisées par un service HCL Commerce. Si vous prévoyez de fournir de nouveaux services HCL Commerce, vous devez créer un nouveau module de service, puis personnaliser et étendre les ressources qu'il crée.
Avant de commencer
Pourquoi et quand exécuter cette tâche
JET (Java Emitter Template) est utilisé pour générer le code de base du nouveau module de service à partir d'un fichier XML simple. En décrivant le module de service par le biais d'une syntaxe XML spécialisée, ces modules peuvent être générés. Vous pouvez lancer directement l'implémentation du module de service sans devoir consacrer des heures à sa mise en place et à sa configuration.
Que faire avant de créer un nouveau service :
- Déterminez si un nouveau service est nécessaire ou si un service existant peut être étendu. Lorsque des informations personnalisées sont requises, il existe trois options :
- Inclure des informations personnalisées dans la zone UserData d'un nom existant
- Inclure des informations personnalisées comme une superposition d'un nom existant
- Créer un service personnalisé
- Déterminez le nom du service. Un service se compose d'une collection de noms connexes et des opérations qui peuvent être effectuées sur ces noms. Par exemple, le service Catalog se compose des noms Catalog, CatalogGroup et CatalogEntry et prend en charge la récupération, la création, la mise à jour et la suppression de ces noms.
- Déterminez les noms de service. Pour plus d'informations, voir Noms.
- Déterminez les opérations (verbes) pour chaque nom. Pour plus d'informations, voir Verbes.
- Déterminez l'implémentation du service (SOI ou BOD). Pour en savoir plus sur les différences entre les deux implémentations, voir Modules de service SOI et BOD.
Procédure
Pour créer un nouveau module de service HCL Commerce :
- Démarrez HCL Commerce Developer.
-
Créez le fichier de définition d'application de pattern afin de créer le code de base :
- Cliquez avec le bouton droit sur MyServiceModule.xml et sélectionnez
- Sélectionnez Transformation JET et cliquez sur l'icône Nouveau.
-
Dans la section Transformation :
- Sélectionnez l'ID suivant :
com.ibm.commerce.toolkit.internal.pattern.componentprojects - Cliquez sur OK.
- Sélectionnez l'ID suivant :
-
Une fois le pattern appliqué, vérifiez que les projets suivants sont créés :
- MyServiceModule-Client
- Contient le code Java de la bibliothèque client.
- MyServiceModule-DataObjects
- Contient les XSD, WSDL et SDO générés.
- MyServiceModule-Server
- Contient l'implémentation de façade de composant.
- MyServiceModule-UnitTests
- Un module pour le test d'unité de l'implémentation du client.
- MyServiceModuleServicesHTTPInterface
- Module Web utilisé pour activer les services Web sur HTTP pour le module de service.
- MyServiceModuleServicesJMSInterface
- Module EJB utilisé pour activer les services Web sur JMS pour le module de service.
Remarque :- Vous pouvez ignorer les messages d'erreur de compilation. Les objets Java qui représentent le nom n'existent pas encore et sont générés à l'étape suivante. En outre, les projets nouvellement générés ne sont pas encore ajoutés à l'application HCL Commerce et ne peuvent pas résoudre les dépendances sur le code HCL Commerce.
- Les messages d'information sous la forme suivante peuvent être ignorés :
C'est-à-dire, les objets SOAPElement peuvent être sérialisés.CHKJ2500I: change<<Noun>>(javax.xml.soap.SOAPElement) in method javax.xml.soap.SOAPElement must be serializable at runtime (EJB 2.0: 7.10.5). - Chaque projet généré contient également un préfixe, SOI ou BOD, selon le type sélectionné de votre implémentation. Par exemple,
MyServiceModule-ClientseraitSOIMyServiceModule-ClientouBODMyServiceModule-Client.- Si vous spécifiez SOI, le pattern crée un module de service qui assure l'intégration orientée service dans vos commandes de contrôleur existantes, les beans d'accès et les EJB.
- Si vous spécifiez BOD, le pattern crée un module de service d'architecture orienté service qui utilise des commandes développées à l'aide du cadre de commande BOD. Ces commandes BOD agissent sur des objets de données structurés (SDO) et utilisent le Mediateur d'objets métier pour conserver et récupérer ces SDO.
- Ajoutez les modules générés à l'application HCL Commerce.
-
Etapes suivantes :


