WS GENCON

WS GenCon est un client java qui permet d'envoyer des messages XML à des webservices.  Il est entièrement générique. Ces messages peuvent être signés soit avec un certificat de type X.509 situé sur la machine ou dans un répertoire partagé soit avec la carte d'identité électronique.

WS GenCon signifie "Connecteur générique pour les clients webservices".

WS GenCon a été développée pour répondre aux besoins suivants:

  • Permettre à une application cliente non-XML de communiquer avec des webservices. 
  • Permettre à une application cliente non WS-* d'intégrer les standards ws-security et ws-addressing.
  • Permettre à une application de signer des messages XML aux standards WS-Security.
  • Permettre à une application de convertir les réponses dans un autre format que XML (pour exemple il a été décidé de convertir le XML en script SQL)
  • Permettre à une application d'externaliser la gestion de la communication ws-services à un agent extérieur. Deux moyens de communication sont possibles avec WS Gencon :
  1. soit en échangeant des fichiers par l'intermédiaire d'un répertoire partagé,
  2. soit en communiquant via un système de Queuing intégré à l'application (cfr la solution open-source utilisée: ActiveMQ ). ActiveMQ permet de s'intégrer avec plusieurs langages (cliquer ici pour connaître la liste). Si le langage que vous utilisez ne s'y trouve pas alors il vous reste encore une dernière chance avec le protocole STOMP.
  • Permettre à une application cliente de gérer le HTTPS.

Caractéristiques de l'application WS GenCon

  • Signature des messages XML au standard WS-Security avec un certificat X.509 ou la carte d'identité électronique.
  • Connexion aux webservices en HTTP ou en HTTPS. Le https se configure par l'intermédiaire du fichier 'ssl.properties' dans le répertoire ./comm .
  • Transformation XML vers XML (via XSL) de la requête WS.
  • Transformation XML vers du texte, du xml ou du pdf (via XSL) suivant le type de réponse retournée.
  • Communication entre l'appelant et WSClient par fichier via un répertoire partagé.
  • Communication entre l'appelant et WSClient par un système de queueing (Broker JMS: ActiveMQ ).
  • Configuration au niveau du service (au sens fonctionnel et non technique). WSClient se configure via le fichier databaseXsl.properties situé dans le répertoire ./comm/xsl .
  • Configuration des webservices non-intrusive pour l'application cliente. Cette dernière doit juste connaître le nom du service à appeler (celui déclaré dans la configuration de WSClient) et le fournir en même temps que le message (ou la configuration d'ActiveMQ).

Exemples fournis

Trois exemples de communication sont fournis:

  1. Webservice de FASE (consultation signalètique établissement) en asynchrone
  2. Webservice de FASE (consultation signalètique établissement) en synchrone
  3. Webservice de SIEL (inscriptions des élèves)

Attention ces webservices ne pourront pas être testés pour ceux qui ne possèdent pas des certificats X.509 de la Communauté Française.  

Distributions

La liste des dernières releases est disponible sur notre serveur FTP (cfr. menu download).

La listes des changements entre les versions (release notes) est disponible dans le menu "change log" de Mantis. Cliquer ici pour y accèder.

Le code source est disponible sur notre SVN (cfr. menu source).

Copyright © 2007 ETNIC. Tous droits réservés.