Emmanuel PIERRE - Tutoriels et Astuces en Java

1. Prérequis

• Java JDK 1.5
• Apache ant : http://ant.apache.org/bindownload.cgi (ajouter le dossier bin au PATH)
• JBoss AS est déjà installé avec Nuxeo dans le dossier $JBOSS_HOME.
• Définir la variable d'environnement $JBOSS_HOME.
• Télécharger jbossesb-4.0GA.zip The JBossESB 4.0 GA Binary (pas les sources, pas le bundle) : http://labs.jboss.com/jbossesb/downloads/4.0GA

(on ne prend pas la dernière version de JBoss ESB.Elle pourrait être incompatible avec la vieille version de JBoss AS utilisée par Nuxeo)

• On dézippe (il ne faut surtout pas d'espace dans le chemin vers le répertoire), on obtient un dossier avec :
  • docs : documents pdf, dont GettingStarted utilisé pour l'installation.
  • install
  • samples : des exemples utilisant esb

2. Déploiement de JBoss ESB dans JBoss AS

• Dans le dossier, modifier le fichier deployment.properties pour indiquer où se trouve JBoss AS. Commenter toutes les lignes autres que :

org.jboss.esb.dist.lib=../lib
org.jboss.esb.appserver.home=D:/Logiciels/nuxeo-5.1.2.GA (attention au sens des /, ne pas mettre des \ )
org.jboss.esb.appserver.config=default
(un bug peut se produire si le chemin vers le serveur comporte des espaces...)

• Ouvrir une console, se positionner dans le dossier install. Taper 'ant' .
• On doit obtenir :

deploy:
BUILD SUCCESSFUL

• Cette opération déploie JBoss ESB dans le serveur d'application :
  • copie des dossiers jbossesb.sar et jbossesb-dependencies.sar dans $JBOSS_HOME/server/default/deploy (dossiers contenant des librairies)
  • copie de fichiers de conf dans $JBOSS_HOME/server/default/conf : jbossesb.xml, jbossesb-properties.xml, ...
  • copie de fichiers dans $JBOSS_HOME/server/default/data/hypersonic

• On démarre le serveur JBoss AS

3. Test de JBoss ESB avec le quickstart hello world

• Arrêter le serveur.

• Aller dans le dossier dézippé jbossesb-4.0GA\samples\quickstarts et récupérer le fichier esb-quickstart-service.xml. Le copier dans $JBOSS_HOME/server/default/deploy

Ce fichier contient toutes les définitions des Files (Queues) JMS utilisées dans les quickstarts. Ici on interagi avec le JMS provider JBossMQ.

• Modifier le fichier quickstarts.properties, et faire pointer vers le serveur JBoss AS

jbosshome.dir=D:/Logiciels/nuxeo-5.1.2.GA

• Lancer le serveur run.bat (appelons cette fenêtre, la fenêtre serveur)

• Ouvrir une nouvelle console (fenetre 1) et aller dans jbossesb-4.0GA\samples\quickstarts\helloworld taper 'ant'

This will start the ESB Message "Listeners"

On a l'affichage suivant :

run:
[echo] Basic JMS Gateway and Listener with Actions
[java] +----------------------------------------------------------+
[java] | |
[java] | Starting JBossESB... |
[java] | |
[java] +----------------------------------------------------------+
[java] Reading config from D:\Logiciels\jbossesb-4.0GA\samples\quickstarts\helloworld\jbossesb.xml

• Ouvrir une nouvelle console (fenetre ) et aller dans jbossesb-4.0GA\samples\quickstarts\helloworld taper 'ant runtest'

Ce qui permet d'envoyer un message JMS .

Buildfile: build.xml
runtest:
[echo] Runs Test JMS Sender
[java] Connection Started
BUILD SUCCESSFUL

• Regarder dans la fenetre 1 :

[java] &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&
[java]
[java] Body: Hello World
[java]
[java] &&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&

L'ESB Listener a bien reçu un message qu'il affiche. On peut changer le texte dans le fichier build.xml. on peut envoyer autant de message que l'on veut.

4.Regarder le chapitre "Components of the QuickStart" pour comprendre le flux de données