Apache Adobe Flex TutorialTutoriaux Adobe Flex & AIR en Français

Flex Modules – Communication Application vers Module

Vous pouvez accéder aux méthodes et aux propriétés d'un module depuis l'application parent. Pour cela, vous devez récupérer une instance de la classe du module.

Si vous utilisez la classe ModuleLoader pour charger votre module, vous pouvez appeler des méthodes de module depuis l'application parente en prenant une référence de la propriété "child" du ModuleLoader, et en la castant (conversion de type) en la classe du module (difficile à expliquer avec des mots, l'exemple suivant sera plus parlant).

La propriété "child" est une instance de la classe du module. Dans ce cas, la classe du module est le nom du fichier MXML qui définit le module.

L'exemple suivant appelle la méthode getTitle() du module depuis l'application parente:

Code Application parente

<?xml version="1.0"?>
<!-- modules/ParentApplication.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
  <mx:Script>
    <![CDATA[
      [Bindable]
      private var s:String;

      private function getTitle():void {
        s = (m1.child as ChildModule1).getModTitle();
      }
    ]]>
  </mx:Script>
  <mx:Label id="l1"
            text="{s}"/>
  <mx:ModuleLoader url="ChildModule1.swf"
                   id="m1"
                   ready="getTitle()"/>
</mx:Application>

Code Module (ChildModule1.swf)

<?xml version="1.0"?>
<!-- modules/ChildModule1.mxml -->
<mx:Module xmlns:mx="http://www.adobe.com/2006/mxml"
 width="100%"
 height="100%">
 <mx:Script>
 <![CDATA[
 // Defines the method that the application calls.
 public function getModTitle():String {
   return "Child Module 1";
 }
 ]]>
 </mx:Script>
</mx:Module>

Comme vous pouvez le voir, cette approche crée une liaison forte entre l'application et le module, et ne vous permettra pas de réutiliser le même code quand vous chargerez de multiples modules. Une autre technique est d'utiliser une interface qui va définir les méthodes et les propriétés d'un module (ou d'un groupe de modules) que l'application peut charger.

En passant par le ModuleManager

Si vous chargez vos modules en passant par l'API ModuleManager, il y a un peu plus de code à écrire dans l'application mère. Vous devez utiliser la propriété "factory" du ModuleManager pour obtenir une instance de la classe du module. Vous pouvez ensuite appeler la méthode du module sur cette instance.

Le module suivant définit une seule méthode, computeAnswer():

<?xml version="1.0"?>
<!-- modules/mxmlmodules/SimpleModule.mxml -->
<mx:Module xmlns:mx="http://www.adobe.com/2006/mxml">
 <mx:Script>
 <![CDATA[
  public function computeAnswer(a:Number, b:Number):Number {
   return a + b;
 }
 ]]>
 </mx:Script>
</mx:Module>

L'exemple suivant récupère une instance de la classe SimpleModule en utilisant la propriété "factory" et appelle la méthode create(). On appelle ensuite la méthode computeAnswer() sur cette instance.

<?xml version="1.0"?>
<!-- modules/mxmlmodules/SimpleMXMLApp.mxml -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"
                creationComplete="initApp()">
  <mx:Script>
    <![CDATA[
      import mx.modules.IModuleInfo;
      import mx.modules.ModuleManager;

      public var assetModule:IModuleInfo;

      public var sm:Object;

      [Bindable]
      public var answer:Number = 0;

      public function initApp():void {
// Get the IModuleInfo interface for the specified URL.
        assetModule = ModuleManager.getModule("SimpleModule.swf");
        assetModule.addEventListener("ready", getModuleInstance);
        assetModule.load();
      }

      public function getModuleInstance(e:Event):void {
// Get an instance of the module.
        sm = assetModule.factory.create() as SimpleModule;
      }

      public function addNumbers():void {
        var a:Number = Number(ti1.text);
        var b:Number = Number(ti2.text);
// Call a method on the module.
        answer = sm.computeAnswer(a, b).toString();
      }
    ]]>
  </mx:Script>
  <mx:Form>
    <mx:FormHeading label="Enter values to sum."/>
    <mx:FormItem label="First Number">
      <mx:TextInput id="ti1"
                    width="50"/>
    </mx:FormItem>
    <mx:FormItem label="Second Number">
      <mx:TextInput id="ti2"
                    width="50"/>
    </mx:FormItem>
    <mx:FormItem label="Result">
      <mx:Label id="ti3"
                width="100"
                text="{answer}"/>
    </mx:FormItem>
    <mx:Button id="b1"
               label="Compute"
               click="addNumbers()"/>
  </mx:Form>
</mx:Application>

Dans cet exemple, on devrait en fait créer un module qui hérite de la classe ModuleBase en ActionScript plutôt qu'un module MXML qui hérité de la classe Module car on a aucun élément visuel, simplement une méthode qui additionne et retourne la valeur. Un module qui hérite de ModuleBase serait plus léger qu'une classe qui hérite de Module.