Adobe^® Flex^™ Tutorial

Ce tutorial Adobe Flex avec BlazeDS va vous expliquer comment monter une application Java en liaison avec une application Flex. On va ici utiliser le service Messaging de BlazeDS pour la communication. Afin de faciliter l'explication, on va utiliser la version "Turnkey" de BlazeDS qui est directement livrée avec un serveur d'application Tomcat. Si vous n'avez pas encore installé BlazeDS Turnkey, suivez ces instructions:

Flex BlazeDS – Configurer son environnement BlazeDS avec Turnkey

BlazeDS offre un service de messaging qui permet aux applications Flex de publier des messages et de s'inscrire à un ensemble de destinations, permettant le développement d'application temps réel et / ou collaboratives comme des chats par exemple.

Création du projet Java

Vous allez avoir besoin d'un projet Java pour la partie serveur de l'application. Tout d'abord, ouvrez Eclipse et créez un nouveau projet Java:

• Dans le menu d'Eclipse, choisissez File > New > Project
• Dans l'arbre, choisissez Java Project comme type de projet puis Next
• Sur la page "Create a Java Project":
  • Entrez "blazeds-server" comme nom de projet
  • Sélectionnez "Create project from existing source", et entrez le chemin vers la webapp "sample" comme par exemple "C:\blazeds\tomcat\webapps\samples\WEB-INF"
  • Next
• Sur la  page "Java Settings", assurez-vous que le Default output folder soit à "blazeds-server/WEB-INF/classes" puis Finish

Cette configuration de projet vous permet de conserver le code source de vos classes Java dans le dossier WEB-INF/src. Ces classes seront automatiquement compilées dans le dossier WEB-INF/classes.

Création du channel de destination (messaging-config.xml)

Ce que l'on appelle une "Messaging Destination" dans le jargon BlazeDS représente un sujet de conversation en temps réel dont les clients peuvent s'inscrire (écoute) ou contribuer en envoyant leur propres messages.

Pour définir une simple destination de chat pour cette application:

• Dans votre projet "blazeds-server", ouvrez le fichier "messaging-config.xml" situé dans /WEB-INF/flex/.
• Ajoutez une destination appelée "tutorial-chat" définie comme ceci:

<destination id="tutorial-chat"/>

• Redémarrez le serveur application Tomcat (voir manipulation dans le tutorial plus haut)

Le canal de destination est un élément-clé qui va permettre d'échanger de la donnée entre le client et le serveur. En utilisant BlazeDS, une destination utilise typiquement soit un canal de type "streaming", soit un canal de type "polling".

• Quand on utilise un canal de type "streaming", le serveur reste ouvert jusqu'à ce que le canal de connexion soit fermé, permettant au serveur d'envoyer des bouts de données au client. Puisque les connexions HTTP ne sont pas "duplex", un seul canal AMF ou HTTP requiert en fait deux connexions HTTP pour envoyer de la donnée dans les deux directions. Une est nécessaire pour la réponse streaming du serveur. L'autre est une connexion transitoire, seulement nécessaire quand de la donnée est envoyée vers le serveur.
• Un canal de type "polling" peut être configuré avec un intervalle de "polling", ou il peut être configuré pour attendre qu'une donnée serveur soit disponible (ce qu'on appelle le "long-polling").

Notez qu'il n'y a pas besoin de définir un type de canal pour la destination "tutorial-chat". Quand vous ne spécifiez pas de canal pour une destination, la destination utilise le canal par défaut définit au début du fichier "messaging-config.xml". Dans notre cas, le client va d'abord essayer de se connecter au service de Messaging en utilisant le canal "my-streaming-amf". Si une connexion au serveur ne peux être établie, le client va utiliser le canal "my-polling-amg". Les canaux peuvent être configurés dans le fichiers services-config.xml.

Création de l'application Flex

Pour créer la partie client, rendez-vous dans Flex Builder (ou restez dans Eclipse si vous l'avez installé en plug-in).

• Créez un nouveau Flex Project nommé "MessagingClient"
• Sélectionnez Web Application comme Application Type
• Sélectionnez J2EE comme Application Server Type
• Dans l'écran suivant, décochez "Use default location for local LiveCycle Data Services server" et entrez:
• "C:\blazeds\tomcat\webapps\samples" comme Root folder (à modifier si vous avec placé votre BlazeDS ailleurs
• "http://localhost:8400/samples" comme Root URL
• "/samples" comme Context Root

Ouvrez le fichier MessagingClient.mxml et entrez:

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
                creationComplete="consumer.subscribe()">

  <mx:Script>
    <![CDATA[
      import mx.messaging.events.MessageFaultEvent;
      import mx.rpc.events.FaultEvent;import mx.messaging.events.MessageEvent;
      import mx.messaging.messages.AsyncMessage;

      private function send():void
      {
        var message:AsyncMessage = new AsyncMessage();
        message.body.chatMessage = msg.text;
        producer.send(message);
        msg.text = "";
      }

      private function messageHandler(event:MessageEvent):void
      {
        log.text += event.message.body.chatMessage + "\n";
      }

      private function faultHandler(event:MessageFaultEvent):void {
        msg.text += "Received fault: " + event.faultDetail + "\n";
      }

    ]]>
  </mx:Script>

  <mx:Producer id="producer" destination="tutorial-chat" fault="faultHandler(event)"/>
  <mx:Consumer id="consumer" destination="tutorial-chat" message="messageHandler(event)" fault="faultHandler(event)"/>

  <mx:Panel title="Chat" width="100%" height="100%">
    <mx:TextArea id="log" width="100%" height="100%"/>
    <mx:ControlBar>
      <mx:TextInput id="msg" width="100%" enter="send()"/>
      <mx:Button label="Send" click="send()"/>
    </mx:ControlBar>
  </mx:Panel>
</mx:Application>

Quelques précisions sur le code Adobe Flex

• Du côté client, l'API de Messaging de BlazeDS fournit deux classes: Producer et Consumer, qui vous permettent de publier et de s'inscrire à une destination, respectivement.
• Pour souscrire à une destination, utilisez la méthode subscribe() de la classe Consumer
• Quand un message est publié à une destination à laquelle vous êtes inscrite, l'évènement de Messaging est déclenché vers le Consumer.

Dans cet exemple, les messages sont publiés par les clients Flex. Le service de Messaging offre aussi une API Java qui permet aux composants serveur de publier des messages à une destination BlazeDS. Une autre option pour l'échange des messages entre Flex et les application Java est l'utilisation des topics Java Message Service.

Utilisation de l'application exemple

Pour utiliser cette application, ouvrez la dans plusieurs navigateurs et envoyez des messages. Vous verrez le message apparaître dans toutes les applications ouvertes.

• Flex BlazeDS – Les fonctionnalités de BlazeDS
• Flex BlazeDS – Tutorial Application Java Remoting avec BlazeDS Turnkey
• Flex BlazeDS – Introduction à BlazeDS
• Flex BlazeDS – RPC Fault: faultCode="InvokeFailed" faultDetail="Couldn't establish a connection to 'echoServiceDestination'"
• Flex BlazeDS – Spécifier la configuration BlazeDS à l'exécution (services-config.xml et context-root)