@@ -19,6 +19,10 @@ package com.insideria.twitteria.business { private var username:String; private var password:String; + /** + * When constructed, we get the credentials and an event dispatcher to dispatch events through + * so that the EventMap will recieve them + */ public function TwitterDelegate(username:String, password:String, dispatcher:IEventDispatcher) { trace("creating TwitterDelegate with useDummyData: " + useDummyData); this.username = username; mate/src/com/insideria/twitteria/business/TwitterDelegate.as @@ -2,6 +2,11 @@ package com.insideria.twitteria.business { import mx.collections.ArrayCollection; + /** + * A Manager is something like a model, + * and this one holds onto anything that comes back from + * Twitter for us + */ public class TwitterManager { [Bindable] mate/src/com/insideria/twitteria/business/TwitterManager.as @@ -8,14 +8,21 @@ ]]> </mx:Script> + <!-- A debugger, for free! --> <Debugger level="{Debugger.ALL}" /> + <!-- EventHandlers do the work corresponding to an event --> <EventHandlers type="{LoginEvent.LOG_IN}" debug="true"> + <!-- An ObjectBuilder builds an object object of a certain type and caches that object for later use, + indexed by class (see below). We use this so that we can pass arguments to the contructor --> <ObjectBuilder generator="{TwitterDelegate}" constructorArguments="{[event.username, event.password, scope.dispatcher]}" /> + <!-- The TwitterDelegate used by this MethodInvoker will be the one constructed by the ObjectBuilder --> <MethodInvoker generator="{TwitterDelegate}" method="loadTimeline" /> </EventHandlers> <EventHandlers type="{TimelineReceivedEvent.TIMELINE_RECEIVED}" debug="true"> + <!-- Without an ObjectBuilder, the first call to a class in the generator attribute of a MethodInvoker + will be cached and used the next time the class is referenced --> <MethodInvoker generator="{TwitterManager}" method="setCurrentTweets" arguments="{[event.tweets]}" /> <EventAnnouncer generator="{ViewStateEvent}" type="{ViewStateEvent.SHOW_MAIN_VIEW}" bubbles="true" /> </EventHandlers> @@ -28,7 +35,10 @@ <MethodInvoker generator="{TwitterDelegate}" method="loadTimeline" /> </EventHandlers> + <!-- This injector references the MainView which was already instantiated on the root --> <Injectors target="{MainView}"> + <!-- Whenever the currentTweets property on the cached TwitterManager changes, Mate sets the + currentTweets property on the MainView to point to that property --> <PropertyInjector source="{TwitterManager}" sourceKey="currentTweets" targetKey="currentTweets" /> </Injectors> mate/src/com/insideria/twitteria/maps/MainEventMap.mxml @@ -4,6 +4,8 @@ [Event(name='login', type='com.insideria.twitteria.events.LoginEvent')] </mx:Metadata> + <!-- I can't find any Mate here, can you? --> + <mx:Script> <![CDATA[ import com.insideria.twitteria.events.LoginEvent; mate/src/com/insideria/twitteria/view/LoginView.mxml @@ -1,6 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <mx:VBox xmlns:mx="http://www.adobe.com/2006/mxml" width="100%" height="100%" xmlns:status="com.insideria.twitteria.view.status.*"> + <!-- I can't find any Mate here, can you? --> + <mx:Script> <![CDATA[ import com.insideria.twitteria.events.SetStatusEvent; mate/src/com/insideria/twitteria/view/MainView.mxml @@ -18,8 +18,10 @@ <mx:DropShadowFilter id="twitteShadow" inner="true" distance="1" blurX="2" blurY="2" /> <mx:DropShadowFilter id="riaShadow" distance="1" blurX="2" blurY="2" /> + <!-- Any event maps need to be instantiated on the root --> <maps:MainEventMap /> + <!-- Here is an example of a declarative listener which calls a local method --> <mate:Listener type="{ViewStateEvent.SHOW_MAIN_VIEW}" method="showMainView" /> <mx:Label id="titleTwitteLabel" styleName="twitTitle" filters="{[twitteShadow]}" text="Twitte" /> mate/src/twitteria_mate.mxml 2f8c2f1f3e0e185804819a09d5236ab8d5c5d40b Tony Hillerson tony.hillerson@effectiveui.com http://github.com/thillerson/twitteria/commit/c43b5bb646fb8009d5ac0ad4f79ca06079aefc89 c43b5bb646fb8009d5ac0ad4f79ca06079aefc89 2009-01-30T19:02:01-08:00 2009-01-30T19:02:01-08:00 documented some key points about Mate 9b755ed30d0a4e63ce3eeafce994dd3597bbc72a Tony Hillerson tony.hillerson@effectiveui.com