Mon premier “Hello World” avec Eclipse, Tomcat, Flex et Live Cycle Data Services !

Aujourd'hui nous allons apprendre à faire notre premier "Hello World" ... avec Eclipse, Tomcat, Flex et Live Cycle Data Services.

N'ayez pas peur le plus long ne sera pas de faire le programme mais plutôt de faire l'installation de tout ces logiciels et surtout de réussir à interfacer le tout.
Voici la liste de tout ce dont vous avez besoin :

• JDK
• Eclipse
• Tomcat
• Plugin Flex Builder pour Eclipse
• Live Cycle Data Services Express
• Et beaucoup de patience !

JDK

Si vous avez déjà le JDK d'installé vous pouvez passer à la section suivante. Sinon allez sur la page de téléchargement du site de Sun et téléchargez la dernière version du JDK puis installez-la.
Ceci vous permettra de compiler des applications Java contrairement au JRE qui ne permet que de l'exécuter.

Eclipse

Téléchargez Eclipse IDE for Java EE Developers et installez-le. Cette version d'Eclipse contient déjà tous les plugins utiles pour faire du J2EE ce qui vous évitera de devoir tout installer manuellement.

Tomcat

Téléchargez la dernière version de Tomcat sur le site offciel et installez le.
Maintenant nous allons indiquer à Eclipse de se servir de votre Tomcat. Pour cela lancez Eclipse puis :

• Passez en perspective J2EE grâce aux raccourcis en haut à droite ou via le menu "Window" > "Open Perspective" > "Other..."
• Un onglet "Servers" devrait être présent parmi les onglets "Console" et "Problems", choisissez-le.
• Faîtes un clic droit puis "New" > "Server".
• Une fenêtre apparaît vous permettant de spécifier votre Tomcat, choisissez dans "Apache" > "Tomcat vX.X Server" où "vX.X" correspond à la version de votre Tomcat.
  

• Ensuite vous devez lui donner nom, et surtout vous définissez son emplacement.
• Faîtes "Finish" et le tour est joué !

Plugin Flex Builder pour Eclipse

Maintenant nous allons installer le plugin Flex Builder pour Eclipse qui se trouve ici.

L'avantage de ce plugin par rapport à Flex Builder (qui est aussi basé sur Eclipse) est de pouvoir développer du Flex directement sous Eclipse. De ce fait vous bénéficiez directement des options pour Java et Tomcat.

Live Cycle Data Services Express

Enfin terminez cette longue phase d'installation par Adobe Live Cycle Data Services Express que vous trouverez ici.
Pendant l'installation vous aurez à sélectionner "LifeCycle Data Services J2EE web application".

Hello World

Ca y est ! Nous avons enfin fini toute l'installtion. Passons au projet !
Tout d'abord lancez votre Eclipse puis :

• Passez en perspective J2EE.
• Créez un nouveau projet et choisissez "Dynamic Web Project".
• Indiquez le nom de votre projet et son emplacement.
• Vous devriez obtenir cette arborescence

Maintenant ajoutons ce projet à Tomcat :

• Allez dans l'onglet "Servers" où vous avez déclaré votre serveur Tomcat.
• Faîtes clic droit et choisissez "Add and Remove Projects..."
• Ajoutez votre projet et faites "Finish".

L'architecture du projet est presque finie. Il ne reste plus qu'à intégrer Flex :

• Passez en perspective Flex Developpement.
• Faîtes un clic droit sur le projet puis "Flex Project Nature" > "Add Flex Project Nature".
• Vous devriez obtenir l'écran suivant

• Sur l'écran suivant indiquez où se trouve le "flex.war" de votre LCDS (Live Cycle Data Services). Il devrait se trouver dans le répertoire où vous avez installé LCDS.

• Aller ensuite dans l'onglet "Problems" puis faîtes un clic droit sur le message d'erreur "Cannot create HTML wrapper. Right-click here to recreate folder html-template." et choisissez "Recreate HTML Templates".

La structure du projet est enfin achevée. Nous pouvons commencer à créer une classe HelloWorld dans un package helloworld situé dans src. Cette classe aura une méthode sayHelloWorld() renvoyant "Hello World !".

Maintenant nous aimerions bien appelé cette méthode depuis Flex. Pour cela il faut d'abord établir un lien entre la classe Java et Flex. C'est là qu'intervient LCDS !

Ouvrez le fichier remoting-config.xml se trouvant dans WebContent/WEB-INF/flex/ et ajoutez ceci dans le fichier :

La balise destination contient un id qui pourra être appelé depuis Flex. Cet id correspond à une classe Java que l'on trouve ici entre les balises source. Comme vous pouvez le voir il s'agit de notre classe HelloWorldappartenant au package helloworld.

Pour tester que l'accès à notre méthode depuis Flex fonctionne, recopiez le code ci-joint dans le fichierhello_world.mxml :

Nous utilisons le composant RemoteObject et sa propriété destination afin de faire le lien avec la classe Java grâce à LCDS. Cela nous permet d'utiliser les méthodes contenues dans cette classe et donc d'appeler la méthode sayHelloWorld.
Lancez votre application et vous devriez obtenir ceci :

Comme vous le voyez, le lien a bien établi entre notre classe Java et Flex !

Vous trouverez les sources de ce proje