Mate（二）——常用tag

Event? Handlers

???????? 对事件的处理，当事件发出时运行

<EventHandlers type="{QuoteEvent.GET}" debug="true">

        <RemoteObjectInvoker destination="ColdFusion" source="stockQuoteExample.QuoteService" 

                method="getQuote"

                arguments="{event.symbol}" 

                debug="true">

            

            <resultHandlers>

                <MethodInvoker generator="{QuoteManager}" 

                    method="storeQuote" arguments="{resultObject}"/>

            </resultHandlers>

        </RemoteObjectInvoker>

    </EventHandlers>

?

InlineInvoker

???????? 调用本地（script block创建）、静态、单例方法

???????? 调用静态方法

??????????????? <InlineInvoker method="Math.random" />

???????? 返回值是 LastReturn

???????? 本地方法

<mx:Script>
private function myMethod():void {
   trace('you called me!');
}
]]>
</mx:Script>

<EventHandlers type="myEventType">
   <InlineInvoker method="myMethod" />
</EventHandlers>

?

???????? 单例方法

????????????? <InlineInvoker method="{MySingleton.getInstance().myMethod}" />

?

MethodInvoker

???????? 创建generator指定类的object实例，并调用方法

<MethodInvoker
   generator="ClassNameToInstantiate" method="methodToExecute"  
   arguments="{['argument1','argument2']}"/>

类似于

?? myWorker.methodToExecute('argument1','argument2');

Event Anouncer

??? 定义事件对象并发出，按事件在文档中定义顺序执行

<EventAnnouncer type="myEventType" generator="MyEventClass">
   <Properties myProperty="myValue" myProperty2="other value"/>
</EventAnnouncer>

??? 类似于

var myEvent:MyEventClass = new MyEventClass("myEventType",true);

myEvent.myProperty = "myValue";

myEvent.myProperty2 = "other value";

dispatchEvent(myEvent);

Service Call

???????? 使用 HttpServiceInvoker? WebServiceInvoker和RemoteObjectInvoker调用不同的服务。当在EventHandlers中使用这些tags时，当service请求发出后，后续的handler会立刻执行。如果希望后续handler等待service返回值再执行，将这些handlers放在service call的resultHandlers中，如：

<RemoteObjectInvoker destination="ColdFusion" source="stockQuoteExample.QuoteService" 
                method="getQuote"
                arguments="{event.symbol}" 
                debug="true">
            <resultHandlers>
                <MethodInvoker generator="{QuoteManager}" 
                    method="storeQuote" arguments="{resultObject}"/>
            </resultHandlers>
        </RemoteObjectInvoker>

result 事件处理支持 EventAnouncer和CallBack

<resultHandlers>
<CallBack method="save_result"/>
<EventAnnouncer generator="{ SearchEvent }"  type="{ SearchEvent.SEARCH }"></EventAnnouncer>
</resultHandlers>

instance属性：已经创建的remoteObject对象，用于service对象的重用，如：

???? <services:Services id="services"destination="ColdFusion" source="someCFC" />
???? <RemoteObjectInvoker instance="{services }" ... >

?????

Date Copier

??? 在 eventHandlers中定义，用处是将数据暂时缓存，为eventhandler后边的标签使用，目标属性可以是event handler lists’s data或者外部变量，如

???????? <DataCopier destination="data" destinationKey="someProperty" source="result" sourceKey="someProperty" />

Stop Handlers

???????? Event handlers中内容会顺序执行，如果想提前停止，可使用这个标签，可根据最后执行的methodInvoker?或者指定判断函数，决定是否停止执行，如

<StopHandlers lastReturnEquals="someValue" />   //最后执行的值是否为someValue

    <StopHandlers stopFunction="myStopSequenceFuntion" />  //停止函数

private function myStopFunction(scope:Scope):Boolean {
        ... here you do some evaluation to determine
        whether to stop the execution of the list or not...
        return false;
    //or return true;

?

Call Back

???????? 调用发出Event的对象（如View）中的函数

??? <CallBack method="methodToCall" arguments="{['argument1','argument2']}" />

ObjectBuilder

???????? 创建对象为MethodInvoker和PropertyInjector服务，如

<ObjectBuilder generator="ClassNameToInstantiate" 
   constructorArguments="{['argument1','argument2']}" > 
   <Properties weightFactor="0.5" flatFee="3" />
</ObjectBuilder>

?

相当于:

??? var myObject:ClassNameToInstantiate = new ClassNameToInstantiate('argument1','argument2');

??? myObject.flatFee=3;

MockRemoteObject

用于模拟远程调用，同样的还有MockWebService，如

<MockRemoteObject id="contacts" mockGenerator="{ MockContactService }" delay="3">
   <methods>
      <MockMethod name="search" dataUrl="assets/xml/contacts.xml"/>
   </methods>
</MockRemoteObject>

?

其他tag

???????? LocalEventMap 主要用于module，需要传入dispatcher

???????? AsyncMethodInvoker 用于函数的异步调用，类似于RemoteObject监听resultHandler和faultHandler

Injectors

??????用于business中修改数据后，反应到view中

????? 当target中的对象创建时就会运行，即the object of that class needs to be created within the display list,or be instantiated by theObjectBuilder orMethodInvoker tags.

??????? 可包含 PropertyInjector和ListenerInjector，以及Message Handler和Event Handler包含的tag

????? 简单实例：

<Injectors target="{ ContactList }">
   <PropertyInjector targetKey="contacts"  source="{ ContactsManager }" sourceKey="contacts"/>
</Injectors>

????????? 包含MethodInvoker和ObjectBuilder

<Injectors target="{ ContactForm }">
    <MethodInvoker generator="{ ContactsManager }" method="getCurrentContact" />
    <ObjectBuilder generator="{ ContactFormresentationModel }" cache="none"
         constructorArguments="{ [ scope.dispatcher,lastReturn ] }" />
    <PropertyInjector targetKey="model" source="{ lastReturn }"/>
</Injectors>

?

PropertyInjector

???????? sourceKey只要有get方法即可

???????? 如果是变量，只要指定source即可

???????? 可以为target注入多个属性

<Injectors target="{PhotoViewAdapter}">
    <PropertyInjector source="{PhotoManager}" .. />
    <PropertyInjector source="{UserManager}" ... />
    <PropertyInjector source="{AlbumManager}" ... />
</Injectors>

?

ListenerInjector

???????? 位于Injectors中，监听type指定的事件，并运行 Injectors target代表的类的函数

<Injectors target="{ ContactFormPresentationModel }">
    <ListenerInjector eventType="{ ContactEvent.SAVED }" method="contactSaved" />
</Injectors>

?

Message Handlers

???????? 用于flex中message处理的简化，在多客户端通信的场景上用到，所以可以使用这它们制作出多人交互的应用，如即时聊天，多人对战，实时会议等。

???????? 有Producer和Consumer，客户端向服务器订阅消息，当服务器消息发生变化后，订阅了该消息的客户端会取得更新数据即时更新

???????? 当flex messaging service发送消息时执行，可以调用MethodInvoker? EventAnnouncer等。

<MessageHandlers destination="YourGateway">
   <MethodInvoker>
   <Call back> 等
</MessageHandlers>