Mode Serveur du simulateur

Simulateur - Mode Serveur

Mode Serveur

 

Le mode Serveur permet de simuler un serveur XAT2V2. Le rôle du simulateur est alors de renvoyer des réponses XAT2V2 à un client.

 

Les fonctionnalités de ce mode se décomposent en 3 parties :

  1. Configuration du serveur
  2. Création des Réponses XAT2V2
  3. Démarrage du serveur XAT2V2

 

1. Configuration

Le panneau Configuration permet de configurer le serveur qui sera exposé par le simulateur :

Mode-serveur-1

Dans cet écran de configuration du serveur XAT2V2, les données saisissables sont :

  • Port d’écoute : port d’écoute du serveur. Celui-ci est valorisé à 8081 par défaut. Les ports 7001 à 7010 sont particulièrement recommandés.
  • Chemin d’accès : chemin d’accès au serveur XAT2. L’URL d’accès au serveur devient alors http://localhost:<port>/<chemin_d_acces>.
  • Support des sessions XAT2 : indique si le serveur supporte les sessions XAT2. Si cette case est cochée, le simulateur reconnaîtra les verbes createSession et deleteSession et effectuera le traitement associé automatiquement.
  • Validation des messages : indique si la validation des requêtes XAT2 est activée. Si cette case est cochée, toute erreur dans la requête XAT2 (erreur de dictionnaire) sera indiquée dans la réponse.
  • Support compression GZIP : indique si le serveur doit gérer la compression GZIP. Les requêtes non compressées sont également acceptées, même si la compression GZIP est activée.

 

Le bouton « Démarrer le serveur » permet de lancer le serveur ainsi configuré. Même si le serveur est capable de prendre en compte des modifications de sa configuration à chaud, il est cependant fortement recommandé d’avoir configuré les réponses (paragraphe suivant) avant de le faire. Quand le serveur tourne, il est possible de l’arrêter en cliquant sur le bouton « Arrêter le serveur ».


Haut de la page

2. Création des réponses

2.1. Gérer un verbe par JavaScript

Ce mode de fonctionnement du serveur permet d’associer un script (ECMA Script) à un verbe. Ce script décrit le traitement se chargeant de remplir la réponse. Il est exécuté par le serveur lorsque le verbe associé au script est envoyé dans la requête.

Dans le panneau « Réponse » :

Mode-serveur-2

  • Sélectionner l’option « Scripts »
  • Cliquer sur « Gérer un verbe »

Dans la nouvelle fenêtre « Handle verb / Gérer un verbe » :

  • Saisir un verbe à gérer dans le champ intitulé « Verbe ».
  • Saisir le code Javascript dans la zone « Script ».
  • Cliquer sur le bouton « Valider ».

Mode-serveur-3

Le nouveau verbe se trouve maintenant dans la liste principale des verbes gérés par le serveur :

Mode-serveur-4

Exemple de script

importPackage(Packages.fr.etai.xat2v2.obj);
if (!response.shuttle) {
response.shuttle = new Shuttle();
}
response.shuttle.transport = new Transport();
response.shuttle.transport.partner = new Partner();
response.shuttle.transport.partner.name = ‘Toto’;

var parts = request.shuttle.partList.part;
for (i=0; i < parts.size(); i++) {
var shortLabel = parts.get(i).label.shortLabel;
var part = new Part();
part.label = new Label();
part.label.shortLabel = shortLabel;
response.shuttle.addPart(part);
}

Note : lorsque le script est exécuté, il « connaît » déjà quelques objets implicites :

  • request : la requête XAT2, avec les propriétés de l’objet Java le représentant.
  • response : la réponse XAT2 qui doit être remplie.

2.2. Gérer un verbe par réponse fixe

Dans le panneau « Réponse » :

Mode-serveur-5

  • Sélectionner l’option « Réponse par verbe »
  • Cliquer sur « Gérer un verbe »

Dans la nouvelle fenêtre « Handle verb / Gérer un verbe » :

  • Saisir un verbe à gérer dans le champ intitulé « Verbe » (par exemple getPriceAndStock)
  • Saisir un message XML, qui sera renvoyé par le simulateur lorsque le verbe configuré sera reçu.
  • Cliquer sur le bouton « Valider ».

Mode-serveur-6

Le nouveau verbe se trouve maintenant dans la liste principale des verbes gérés par le serveur :

Mode-serveur-7

2.3. Gérer une séquence de réponse

Dans le panneau « Réponse » :

Mode-serveur-8

  • Sélectionner l’option « Réponses dans l’ordre ».
  • Cliquer sur « Ajouter une réponse ».
  • Ajouter des réponses dans le champ « Contenu ».

Mode-serveur-9


Haut de la page

3. Démarrage du serveur XAT2V2

Retourner dans l’écran « Config. », et cliquer sur le bouton « Démarrer le serveur » :

Mode-serveur-10

 

 Retour à la rubrique simulateur