Adobe^® Flex^™ Tutorial

BlazeDS est distribué en 2 versions différentes. Une version binaire composée d'un WAR pour intégration dans un environnement déjà existant et une version nommée "Turnkey" que l'on pourrait appeler "clé-en-main", spécialement destinée aux débutants. Cette version Turnkey contient un serveur applicatif Tomcat (actuellement en version 6.0.14) dans lequel les services BlazeDS ont déjà été déployés avec des applications d'exemple.

Turnkey permet de tester facilement BlazeDS. Dans un environnement de production, vous devriez intégrer BlazeDS dans votre propre application web, sur votre propre serveur applicatif.

Installation du serveur BlazeDS Turnkey

• Assurez-vous que vous avez bien installé un JDK 1.5 (ou supérieur) et que votre variable d'environnement JAVA_HOME pointe bien vers votre installation du Java Development Kit. Tutorial installation et configuration de JDK
• Téléchargez la version Turnkey de BlazeDS (160 Mo)
  
• Dé-zippez l'archive dans un dossier nommé "blazeds" (sur le disque C: dans cet exemple)

Démarrage de Tomcat (serveur applicatif)

Pour que vos applications s'exécutent, il faut lancer le serveur tomcat. Pour cela, prenez un Invité de commande  (Démarrer> Exécuter > cmd). Puis naviguer vers le dossier d'installation de BlazeDS, dans le sous répertoire /tomcat/bin (cd C:\blazeds\tomcat\bin en ligne de commande Windows). Une fois dans le répertoire "bin", tapez "catalina run" puis Entrée pour lancer le serveur Tomcat:

Si le message "Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
At least one of these environment variable is needed to run this program" apparait, revenez à l'étape précédente pour spécifier la variable d'environnement dans le Path.

Si tout se passe bien, vous devriez avoir plusieurs messages et enfin, INFO: Server startup in x ms.

Installation d'Eclipse et Flex Builder 3

Pour les projets utilisant BlazeDS, vous aurez besoin de manipuler du code serveur (Java) et du code client (Adobe Flex / AIR).

Vous ne pouvez pas utiliser la version Standalone de Flex Builder 3 pour les projets Java car elle est basée sur une version d'Eclipse minimaliste.

Vous devez donc avoir au minimum une vraie version d'Eclipse "Eclipse IDE for Java Developers". Une fois Eclipse installé, vous pouvez soit installer Flex Builder 3 en standalone (le code client sera donc dans FB et le code Java dans Eclipse) ou installer FB3 en tant que plug-in Eclipse. Si vous installez FB3 en tant que plugin, vous pourrez avoir les projets Java et Flex dans un même environnement.

Structure de l'installation de BlazeDS Turnkey

Voici la structure des applications web installées avec une installation de BlazeDS Turnkey. Dans notre cas, le dossier "root" J2EE application server est le dossier "blazeds" que l'on a crée plus tôt:

Voici les dossiers principaux à connaître:

• /blazeds, /samples et /ds-console: Le répertoire racine d'une application web qui contient le répertoire WEB-INF. Ce dossier inclus tous les fichiers qui doivent être accessibles par le navigateur de l'utilisateur, comme les fichiers SWF, les pages JSP ou HTML, les fichiers CSS, images et JavaScript. Vous pouvez placer ces fichiers directement dans le répertoire racine ou dans n'importe quel autre sous répertoire tant qu'il ne s'appelle pas WEB-INF.
• /META-INF: Contient la configuration des packages et des extensions
• /WEB-INF: Contient le fichier de description de déploiement de l'application (web.xml) qui configure l'application BlazeDS.
• /WEB-INF/classes: Contient les classes Java et les fichiers de configuration
• /WEB-INF/flex: Contient les fichiers de configuration de BlazeDS
• /WEB-INF/flex/libs: Contient les fichiers librairie SWC pour la compilation par Adobe Flex Builder
• /WEB-INF/flex/locale: Contient les fichiers pour l'internationalisation pour la compilation par Adobe Flex Builder
• /WEB-INF/lib: Contient les fichiers JAR de BlazeDS
• /WEB-INF/src: (Optionnel) Contient le code source Java utilisé par l'application Web

• Flex BlazeDS – Introduction à BlazeDS
• Flex BlazeDS – Spécifier la configuration BlazeDS à la compilation (services-config.xml et context-root)
• Flex BlazeDS – Tutorial Application Java Messaging avec BlazeDS Turnkey
• Flex BlazeDS – Tutorial Application Java Remoting avec BlazeDS Turnkey
• Installation de Flex Builder 2 sous Eclipse 3.3 (Europa)