flex中Module的使用

@font-face { font-family: "宋体"; }@font-face { font-family: "@宋体"; }p.MsoNormal,li.MsoNormal,div.MsoNormal { margin: 0cm 0cm 0.0001pt; text-align: justify; font-size: 10.5pt; font-family: "Times New Roman"; }div.Section1 { page: Section1; }

名称	分类	说明
applicationDomain	属性	ApplicationDomain类，将你的模块加载到哪个应用域，详见例3.9
url	属性	String类型。要加载的外部MXML module?的url.，详见例3.1和例3.2
loadModule	方法	格式：loadModule (url:String = null,bytes:ByteArray = null):void 加载module，详见例3.2
unloadModule	方法	格式：unloadModule():void 卸载module，释放内存,详见例3.2
error	事件	当module抛出错误时派发，参见例3.3
loading	事件	当ModuleLoader开始根据URL加载module时派发
progress	事件	Module加载过程中以一定的间隔周期派发，参见例3.3
ready	事件	当module完成加载时派发，参见例3.3
setup	事件	当module已下载(通过info()函数访问)，但module并没有加载完成时(not ready)派发
unload	事件	当module卸载完成时派发，参见例3.3
urlChanged	事件	当ModuleLoader有了一个新的URL时派发

3 ModuleLoader使用方法
3.1 通过URL自动加载module和Alert使用举例
功能说明
????? 通过loadModule加载外部的WelcomeModule，点击module中的alert，显示欢迎

关键代码
ModuleLoaderExam1.mxml
<fx:Script>
??????? <![CDATA[
??????????? import mx.managers.PopUpManager;
??????????? private var pop:PopUpManager=new PopUpManager();
??????? ]]>
??? </fx:Script>
??? <mx:ModuleLoader id="module1" url="example/WelcomeModule.swf"
creationComplete="module1.applicationDomain=ApplicationDomain.currentDomain"/>

说明：
(1)如果在module中使用Alert，必须声明PopUpManager，并且实例化，原因未知。
(2) creationComplete事件表示，当加载完成时，将当前应用程序的域赋给module1，这个语句可以不加，为防万一，最好加上。

ModuleExam1.mxml
??? protected function openAlert_clickHandler(event:MouseEvent):void
??? {
??????? Alert.show("欢迎","欢迎点击Alert",Alert.OK,this);
??? }
??? <s:Button id="openAlert" label="模块使用Alert" click="openAlert_clickHandler(event)"/>

代码详见：ModuleLoaderExam1.mxml和ModuleExam1.mxml
?
3.2手工加载和卸载module举例
功能说明
????? 通过设置URL属性，手工加载和卸载module
函数说明：loadModule (url:String = null,bytes:ByteArray = null):void
url：默认为null，表示当前要加载的module的URL，如果ModuleLoader的URL不为null，则该方法无效
bytes：module的SWF文件的字节数，可以通过URLLoader类获取

关键代码
ModuleLoaderExam2.mxml
??? public function loadModule21():void
??? {
??????? if(mod_loader.url==null)
??????????? mod_loader.url = "example/ModuleExam21.swf";
??? }
??? public function loadModule22():void
??? {
??????? mod_loader.loadModule("example/ModuleExam22.swf");
??? }
??? public function unload():void
??? {
??????? mod_loader.unloadModule();
??????? mod_loader.url = null;//注意，卸载完成后必须设置URL为null，否则内存泄露
??? }
??? <mx:ModuleLoader id="mod_loader" />
说明：
(1)mod_loader.url的值被修改后，直接触发重新加载module，不必再调用loadModule方法
(2) mod_loader.url = null;必须在卸载完成后加上，否则内存泄露

代码详见：ModuleLoaderExam2.mxml、ModuleExam21.mxml和ModuleExam22.mxml
?
3.3 module常用事件举例
功能说明
???? 演示常用事件的处理，module的常用事件包括
???? Error：加载错误时引发
???? Ready：加载完成后引发
???? Progress：加载过程中定时引发
???? Unload：卸载完成后引发

?关键代码
ModuleLoaderExam3.mxml
<mx:ModuleLoader id="mod_loader"
??????????? error="mod_loader_errorHandler(event)"
??????????? ready="mod_loader_readyHandler(event)"
???????????? progress="mod_loader_progressHandler(event)"
???????????? unload="mod_loader_unloadHandler(event)"/>
??? protected function mod_loader_errorHandler(event:ModuleEvent):void
??? {
??????? lbRecord.text=lbRecord.text+"n error:"+event.module.url;
??? }
??? protected function mod_loader_readyHandler(event:ModuleEvent):void
??? {
??????? lbRecord.text=lbRecord.text+"n ready:"+event.bytesLoaded+"bytes:"+event.bytesTotal;
??? }
??? protected function mod_loader_progressHandler(event:ModuleEvent):void
??? {
??????? lbRecord.text=lbRecord.text+"n progress:"+event.bytesLoaded+"bytes:"+event.bytesTotal;
??? }
??? protected function mod_loader_unloadHandler(event:ModuleEvent):void
??? {
??????? lbRecord.text=lbRecord.text+"n unload:"+event.bytesLoaded+"bytes:"+event.bytesTotal;
??? }
代码详见：ModuleLoaderExam3.mxml、ModuleExam21.mxml和ModuleExam22.mxml
?
3.4 Application调用module中的方法举例
功能说明
????? 演示Application程序如何调用module中的方法
????? Application并不能直接访问module提供的方法，而是通过moduleLoader中的属性child来完成的。

?关键代码
ModuleLoaderExam4.mxml
<mx:ModuleLoader url="example/ModuleExam4.swf" id="m1" ready="getTitle()"/>
private function getTitle():void {
??????? s = (m1.child as ModuleExam4).getModTitle();
??? }

ModuleExam4.mxml
public function getModTitle():String {
??????? return "Child Module 1";
??? }
?说明：
(m1.child as ModuleExam4).getModTitle()，表示将m1中的属性child对应的对象强制转换为ModuleExam4类，再调用这个对象的方法。

代码详见：ModuleLoaderExam4.mxml和ModuleExam4.mxml

3.5 通过ModuleLoader的URL向module传递参数举例
功能说明
????? 通过URL属性向module传递参数
????? GET参数基本上是这种格式，url=module1.swf?param1=value1&param2=value2

关键代码
ModuleLoaderExam5.mxml
??? public function submitToModule():void {
??????? var s:String = "example/ModuleExam5.swf?"
??????????????? + "firstName=" +ti1.text + "&lastName=" + ti2.text;
??????? m1.url = s;
??? }
??? <mx:ModuleLoader id="m1"/>
??? <mx:Button id="b1" label="Submit" click="submitToModule()"/>

ModuleExam5.mxml
?????? //对参数进行过滤
??????? var myPattern:RegExp = /.*?/;
??????? var s:String = this.loaderInfo.url.toString();
??????? s = s.replace(myPattern,"");
??????? // 通过&拆分成数组name=value，保存为String类型数据
??????? var params:Array = s.split("&");
??????? // 显示数组中各个元素的值
??????? var keyStr:String;
??????? var valueStr:String;
??????? var paramObj:Object = params;
??????? for (keyStr in paramObj) {
??????????? valueStr = String(paramObj[keyStr]);
??????????? ta1.text += keyStr + ":" + valueStr + "n"; //keyStr的值为0。1.2...
??????? }
??????? // 通过=拆分各个元素，并保存到变量salutation中
??????? for (var i:int = 0; i < params.length; i++) {
??????????? var tempA:Array = params[i].split("=");
??????????? if (tempA[0] == "firstName") {
??????????????? o.firstName = tempA[1];
??????????? }
??????????? if (tempA[0] == "lastName") {
??????????????? o.lastName = tempA[1];
??????????? }
??????? }
代码详见：ModuleLoaderExam5.mxml和ModuleExam5.mxml
?
3.6利用ActionScript接口实现Module与Application数据交互举例
功能说明
????? 对于Module模块和Application对象间的通信，可以定义一个ActionScript接口，Module模块对象实现了这个接口中定义的方 法和属性，那么Application就可以访问这个接口中定义的属性和方法。接口中定义了Module模块对象和Application需要共享的数据 和方法，是两者间共同的一个契约，同时也实现了接口和实现的分离，达到了松耦合的目的。

接口类IModuleInterface.as：
??? public interface IModuleInterface extends IEventDispatcher {
??????? function getModuleName():String;
??????? function setAdjusterID(s:String):void;
??????? function setBackgroundColor(n:Number):void;
??? }

?ModuleExam6.mxml
模块必须实现以上接口，代码如下
??? <mx:Module xmlns:fx="http://ns.adobe.com/mxml/2009"
?????????? xmlns:s="library://ns.adobe.com/flex/spark"
?????????? xmlns:mx="library://ns.adobe.com/flex/mx"
?????????? implements="IModuleInterface"
?????????? layout="vertical"? width="60%" height="60%">
??? public function setAdjusterID(s:String):void {
??????? adjuster = s;
??? }
??? public function setBackgroundColor(n:Number):void {
??????? bgcolor = n;
??? }
??? public function getModuleName():String {
??????? return "module Insurance";
??? }
说明：
????? 这个module实现了接口中的三个方法。

ModuleLoaderExam6.mxml
??? private function applyModuleSettings(e:Event):void {
??????? // m1.child 是接口IModuleInterface的具体实现对象
??????? //var ichild:* = mod.child as IModuleInterface;
??????? var ichild:IModuleInterface = m1.child as IModuleInterface;
??????? if (m1.child != null) {
??????????? ichild.setAdjusterID(myId.text);
??????????? ichild.setBackgroundColor(myColor.selectedColor);
??????? }
??????? //从接口获取模块的名称
??????? currentModuleName = ichild.getModuleName();
??? }
说明：
???? Application通过接口中的方法setAdjusterID和setBackgroundColor向module传递数据，
???? Module通过接口中的方法getModuleName向Application传递数据
代码详见：ModuleLoaderExam6.mxml、ModuleExam6.mxml和IModuleInterface.as

?3.8 Module与Module之间数据交互举例
功能说明
????? 一个Application如果具有两个Module，这两个Module可以通过Application传递数据。原理如下：
??? <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
?????? <mx:ModuleLoader url="Module1.swf" id="module1"/>
?????? <mx:ModuleLoader url="Module2.swf" id="module2"/>
?? </mx:Application>
在module1中，你可以通过以下方法访问module2的属性和方法
?? parentApplication.module2.child.someProperty;
?? parentApplication.module2.child.someMethod();

关键代码
ModuleLoaderExam7.mxml
<mx:ModuleLoader url="example/ModuleExam71.swf" width="400" id="module1"/>
??? <mx:ModuleLoader url="example/ModuleExam72.swf" width="400" id="module2"/>

ModuleExam71.mxml
??? [Bindable]
??? public var m1:String="module1";
??? public function getProperty(event:MouseEvent):void {
??????? lbmodule2.text=parentApplication.module2.child.m2;
??? }
??? public function getMethod(event:MouseEvent):void {
??????? lbmodule2.text=parentApplication.module2.child.getModuleName();
??? }
??? <s:TextInput id="lbmodule2" text="{m1}" />
??? <s:Button label="调用module1属性"? click="getProperty(event)"/>
??? <s:Button label="调用module1方法"? click="getMethod(event)"/>
说明
???? getProperty函数功能：直接访问module2中的属性m2
???? getMethod函数功能：通过调用module2中的函数getModuleName获取文本输入框的值

ModuleExam72.mxml
??? [Bindable]
??? public var m2:String="module2";
? ? public function getModuleName():String {
??????? return lbmodule2.text;
??? }
??? <s:TextInput id="lbmodule2" text="{m2}" />
说明
???? m2与lbmodule2之间的绑定是单向的，修改m2的值，则改变lbmodule2的text，修改lbmodule2的值并不影响m2的值
代码详见：ModuleLoaderExam7.mxml、ModuleExam71.mxml和ModuleExam72.mxml

参考文献

Flex Modules . http://www.flexafterdark.com/docs/Flex-Modules

3.9 applicationDomain属性举例
功能说明
?? ?? ApplicationDomain 类是一个容器，用于管理不同swf的安全域和类之间的关系。它们允许同一个类存在不同的ApplicationDomain。
????? ApplicationDomain是一个树形结构，Application所在的域(以下简称主域)就是它唯一的子域，使用Loader类加载swf时可以通过指定ApplicationDomain 参数将swf加载到不同的域(Domain)。
????? ApplicationDomain最根部的是系统域(system domain)，主程序所在的域(以下简称主域)就是它唯一的子域。SWF 文件中的所有代码被定义为存在于应用程序域(ApplicationDomain)中。主应用程序在"当前域"中运行。"系统域"中包含所有应用程序域 （包括当前域），也就是，它包含所有 Flash Player 类。
???? 所有应用程序域（除系统域外）都有关联的父域。主应用程序的应用程序域的父域是系统域。已加载的类仅在其父级中没有相关定义时才进行定义。不能用较新的定义覆盖已加载类的定义。

?有两种方式可以访问 ApplicationDomain :
(1)ApplicationDomain.currentDomain
????? currentDomain是ApplicationDomain的静态变量，表示当前代码所在的域。例如：该变量在主程序里指向主域，在加载到子域的模块里和currentDomain则指向该模块所在的子域。
参见例3.1，通过URL自动加载module和Alert使用举例

????? 虽然 ApplicationDomain有个 parentDomain 属性，但子域已经自动获得了父域的类定义，所以通过 ApplicationDomain.currentDomain 就可以获取父域定义了——包括主程序和加载到主域的共享库。(注：系统域不可直接访问，主域和所有新域即系统域子域的parentDomain属性为 null)
参见例3.8，Module与Module之间数据交互举例

(2)LoaderInfo类的applicationDomain属性
????? 此方式可以访问任何方式加载的swf的 ApplicationDomain。对于主程序来说，加载到同域的库定义已经存在于 ApplicationDomain.currentDomain ，而模块的类主程序一般用不到。所以这种方式个人不推荐使用。
???? 使用Loader类加载swf时可以通过指定 ApplicationDomain参数将swf加载到不同的域(Domain):
??????????? var loader : Loader = new Loader();
??????????? var context : LoaderContext = new LoaderContext();
??????????? /* 加载到子域(模块) */
??????????? context.applicationDomain = new ApplicationDomain(ApplicationDomain.currentDomain);
??????????? /* 加载到同域(共享库) */
??????????? context.applicationDomain = ApplicationDomain.currentDomain;
??????????? /* 加载到新域(独立运行的程序或模块) */
??????????? context.applicationDomain = new ApplicationDomain();
? ?? ?????? loader.load(new URLRequest("loaded.swf"),context);

(1)加载到子域(module)—参见图中的用法C
????? 类似于“继承”，子域可以直接获得父域所有的类定义，反之父域得不到子域的。和继承关系不同的是，如果子域中有和父域同名的类，子域定义的类会被忽略而使用父域的定义的类。最大特点是可以动态的加载和移除。便于垃圾回收。
????? context.applicationDomain = new
????? ApplicationDomain(ApplicationDomain.currentDomain);
说明创建一个新的域，并变成当前域的子域

(2)加载到同域(RSL) —参见图中的用法B
????? 就是在当前的ApplicationDomain添加新的类定义。类似集合里的合并关系。被加载swf里的所有类定义被合并到当前域中可以直接使用。和加载到子域相同，和当前域同名的定义也会被忽略。
?????? context.applicationDomain = ApplicationDomain.currentDomain;

?(3)加载到新域(独立运行的程序或模块) —参见图中的用法A
????? 用的不是很多，实际上是单独的创建一个新的域和当前应用程序域平级。作为系统域的真子集。
????? swf载入指定域之前，先要检查该域及其父域中是否存在同名类，重复定义一概忽略。如果加载别人写的程序，或者使用旧版本的主程序加载新版本的模块，为避免类名冲突就要加载到新域独立运行以使用自己的类。
????? context.applicationDomain = new ApplicationDomain();
????? loader.load(new URLRequest("loaded.swf"),context);
说明：创建了一个新的域，并加载到独立的程序loaded.swf中。

模块加载到同域不是一样可以吗？为何要加载到子域呢？
好处就在于，卸载一个加载到子域的模块时，只要确保清除所有到该模块的引用，模块的所有类定义将被垃圾回收(Garbage Collection)。

关键代码
????? ApplicationDomain中的currentDomain属性使用参见例3.1
????? ApplicationDomain中的parrentDomain属性使用参见例3.8

参考文献
1. Flex 中ApplicationDomain. http://www.wedoswf.com/questions/935
2. flash 中的 ApplicationDomain . http://chaimzane.javaeye.com/blog/470987
3. AS3应用程序模块化开发与ApplicationDomain . http://hereson.javaeye.com/blog/192337

3.10 module中使用PopUpManager和DragManager异常说明 ????? 通常将module加载为主域的一个子域，module里面的类都不属于主域的。比如第一个module载入了类PopUpManager，那么整合到 Application中，它就成了PopUpManager的拥有者，因为像这种manager都是单例的，如果另外一个模块稍后要使用这个 PopUpManager，就会引发运行时异常。 ????? 解决办法就是确保这些managers，比如PopUpManager和DragManager或者其他一些共享的服务是在application中定义的，这样就能确保所有模块都能够使用，代码如下： ???? import mx.managers.PopUpManager; ???? import mx.managers.DragManager; ???? private var popUpManager:PopUpManager; ???? private var dragManager:DragManager; ???? 这项技术同时也被应用到组件中，当module第一次使用组件时，将在它自己的域中拥有这些组件的类定义。如果别的module试图使用这些已经被另一个 module使用的组件，它的定义将会不能匹配到现存的定义中。因此，为了避免组件的定义不匹配，在主应用程序中创建组件的实例，让所有的module去 引用。 ????? 但是这个坏处很明显，这些声明看起来莫名其妙，成为了一个个"木偶变量"。另一个解决方法是借助 ApplicationDomain 来共享这些代码和资源。在ModuleLoader 的creationComplete方法中加入moduleLoader.applicationDomain = ApplicationDomain.currentDomain; 表示将其加载到运行时库。对于使用ModuleManager，则可以在IModuleInfo的load方法里指定域。 参见： flash.system.ApplicationDomain flash.system.SecurityDomain?