Flex 开发架构(五): Mate－基于标签的框架

Mate 将会成为Flex领域的另一个热点。它使用设置（configuration）来调用Service，处理结果，同样也使用设置文件来更新绑定对象（Bindable object）。从某个角度来说：Mate是Flex领域的“springframework”。

 

Mate有两个架构层面的图表。一个是来自Yakov Fain of Farata Systems，另一个来自ASFusion。我更喜欢后者，其构架图如下：

 

http://mate.asfusion.com/assets/content/diagrams/two_way_view_injection.png

 

来看看用Mate的编程方式来建立buddyList应用程序。

1，建立Mate的核心组件：EventMap。

EventMap是Mate的心脏，它黏着了所有的组件和控件。其代码如下：

BuddyListEventMap.mxml:

 

<?xml version=”1.0″ encoding=”utf-8″?>
  
<EventMap xmlns=”http://mate.asfusion.com/” 
                             xmlns:mx=http://www.adobe.com/2006/mxml>

</EventMap>

 

 

 

 

 

 

其它内容稍后再填写，现在我们需要告诉主程序（Main Application）初始化EventMap：

主程序 Flex_Mate.mxml:

<?xml version="1.0" encoding="utf-8"?>
<mx:Application  xmlns:map="com.ny.flex.mate.map.*" xmlns:views="com.ny.flex.mate.views.*" xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute">
<mx:Script>
	<![CDATA[
		[Bindable]
		public var viewStackSelectedIndex :int = 0;
	]]>
</mx:Script>
<map:BuddyListEventMap/>
    <mx:HBox  horizontalAlign="center" verticalAlign="top"  width="100%" height="100%" y="0" x="0">
    <mx:ViewStack id="viewStack"  resizeToContent="true" selectedIndex="{viewStackSelectedIndex}" >
        <views:LoginView  />
        <views:BuddyListView/>
    </mx:ViewStack>
    </mx:HBox>
</mx:Application>

 

 

 

 

2. 建立LoginView :

<?xml version="1.0" encoding="utf-8"?>
<mx:Panel xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="300" height="200" horizontalAlign="center" verticalAlign="middle" title="Flex Cirngorm Login">
 <mx:Script>
	<![CDATA[
		import com.ny.flex.mate.event.LoginEvent;
		import com.ny.flex.mate.vo.User;
		import mx.validators.Validator;
		private function login():void{
			if(Validator.validateAll(validators).length == 0){
				var loginUser:User = new User();
				loginUser.userName=username.text;
				loginUser.password=password.text;
				var loginEvent:LoginEvent = new LoginEvent(LoginEvent.LOGIN);
				loginEvent.loginUser = loginUser;
				dispatchEvent(loginEvent);
			}   
		}
	]]>
</mx:Script>

 <!--  Validators-->
 <mx:Array id="validators">
    <mx:StringValidator  id="userNameValidator" source="{username}"  property="text"  required="true"/>
    <mx:StringValidator  id="passwordValidator" source="{password}"  property="text" required="true" />
 </mx:Array>    


<mx:Form id="loginForm" x="0" y="0">
          <mx:FormItem label="Username:" >
               <mx:TextInput id="username" />
           </mx:FormItem>
           <mx:FormItem label="Password:" >
               <mx:TextInput id="password" displayAsPassword="true" />
           </mx:FormItem>
           <mx:FormItem direction="horizontal" verticalGap="15" paddingTop="5" width="170">
               <mx:Button id="loginBtn" label="Login" click="login()"/>
           </mx:FormItem>
    </mx:Form>
   	
</mx:Panel>

 

 

从上面可以看出在方法login()中发送(dispatch)了LoginEvent, 来看看LoginEvent代码：

package com.ny.flex.mate.event
{
	import com.ny.flex.mate.vo.User;
	
	import flash.events.Event;

	public class LoginEvent extends Event
	{
		public static const LOGIN:String = "login";
		public var  loginUser:User;
		public function LoginEvent(type:String, bubbles:Boolean=true, cancelable:Boolean=false)
		{
			super(type, bubbles, cancelable);
		}
		
	}
}

 

在代码中“bubbles”属性必须为“true”，以使得上层的组件（EventMap）可以处理它。

Mate的魔法完全存在于EventMap中，LoginEvent在这里被标签化处理：

…..
 
<EventHandlers type=”{LoginEvent.LOGIN}“>
     <RemoteObjectInvoker destination=”flexmvcRO” 
                                                method=”authenticate” 
                                                arguments=”{event.loginUser}“>
 
         <resultHandlers>
               <MethodInvoker generator=”{LoginService}” 
                                         method=”onResult_Authenticate” 
                                                    arguments=”{resultObject}“/>
        </resultHandlers>
    </RemoteObjectInvoker>
 </EventHandlers>
……

  

 

在EvevntHandler代码中，用户可以定义service函数（RemoteObjectInvoker），同时也定义了结果处理的类、方法和参数。

来看看 LoginService.as代码：:

 

 

package com.ny.flex.mate.service
{
	import com.ny.flex.mate.vo.User;
	
	public class LoginService
	{
		[Bindable]
		public var authUserName:String;
		[Bindable]
		public var viewStackSelectedIndex:int ;

		public function  onResult_Authenticate(user:User):void{
			authUserName = user.userName;
			viewStackSelectedIndex = 1;
		}
		
	}
}

 

Service类处理结果，返回绑定的对象。然后我们就需要更新目标视窗。

Mate另一个闪光点就是注射（Injecting）可绑定的对象到目标视窗！用户只需要在EventMap类中增加另一个标签Injector。（Coolest 部分）：

 

<Injectors target=”{BuddyListView}“>
           <PropertyInjector targetKey=”authUserName”     
                                        source=”{LoginService}” 
                                        sourceKey=”authUserName“/>
 
 </Injectors>
 
<Injectors target=”{Flex_Mate}“>
              <PropertyInjector targetKey=”viewStackSelectedIndex” 
                               source=”{LoginService}”
                               sourceKey=”viewStackSelectedIndex“/>
 
 </Injectors>
 
 

 

 

在此定义目标视窗、目标关键词，资源服务对象和资源关键词。 你根本不需要写任何glue code。

最后定义目标视窗： BuddyListView.mxml：

<?xml version="1.0" encoding="utf-8"?>
<mx:Panel xmlns:mx="http://www.adobe.com/2006/mxml" title="Buddy List of  {authUserName}" creationComplete="getBuddyList()" width="500" height="320">
<mx:Script>
	<![CDATA[
		import mx.collections.ArrayCollection;
		import com.ny.flex.mate.event.GetBuddyListEvent;
	   [Bindable]
	   public var authUserName:String;
	   [Bindable]
	   public var buddyCollection:ArrayCollection;
	   
	   private function getBuddyList():void{
			var getBuddyListEvent:GetBuddyListEvent = new GetBuddyListEvent(GetBuddyListEvent.GET_BUDDY_LIST);
			getBuddyListEvent.authUserName = authUserName;
			dispatchEvent(getBuddyListEvent);
		}
	]]>
</mx:Script>

 <mx:DataGrid id="buddyList"  dataProvider="{buddyCollection}"  borderStyle="none" width="100%" height="100%" >
       <mx:columns>
        <mx:DataGridColumn dataField="firstName" headerText="First Name"/>
        <mx:DataGridColumn dataField="lastName" headerText="Last Name"/>
    </mx:columns>

 </mx:DataGrid>
</mx:Panel>

 

 

 

 

 

整个开发流程是这样的：

 

 

Action–>Dispatch Event–>Config Handler–>create service–>Inject Bindable Object –>another Action….

 

整个项目结构图 见附件

 

 

总结：

在我5篇blog中讨论过的Flex编程框架中，哪一个是最好的呢？

我认为中央管理（central management）最适合进阶水准的小型项目。因为无须学习新的框架，并且也一样有清晰的架构。 而且 他也是走向框架的起点。

对于Mate和Cairngorm，在我看来Mate略占上风，原因如下：

对于Cairngorm：

1，Cairngorm过于复杂，学习曲线较高

2，我觉得Cairngorm有一些垃圾代码（例如Frontcontroller，event 和Command）。

对于Mate：

1，比Cairngorm更简单易学，貌似继承和发扬了Flex的特质。

2，从EventMap中得益，因为无须编写在事件和服务之间的黏着代码。

但另一个方面， EventMap也会带来痛苦，试想一下，用户有50个行为和100个对象需要绑定，那就需要在EventMap中写入大量的configration代码。那么EventMap就成为一个灾难。

因此，如果用户使用Cairngorm，就可以选用  Cairngorm without FrontContoller的方案。

对于Mate，如果使用Meta标签来代替EventMap，就无须设置太多的东西，示例如下：

[EventHadler ={name ="myHandler", serviceclass="myservice" result , taget ...}]

MateDispatch(myevent).

 

我在期待着它的来临。

 

嗯。。。麻烦重排一下版

顶楼上。代码有点乱。

Mate前几天研究过，和Cairgnorm比起来它只是加入了标签功能，整个的流程更加简洁，但似乎不利于debug，而且它没有解决Cairgnorm最大的缺陷：多窗口时数据和UI之间的对应关系

同意这个观点，以上提的几个框架没有对UI的解耦做详细分析，这应该是flex 框架的重要之处