setMultitonKey becomes initializeNotifier

Author: Cliff Hall

src/org/puremvc/as3/multicore/core/Controller.as

@@ -113,7 +113,7 @@ package org.puremvc.as3.multicore.core
 if ( commandClassRef == null ) return;
 
 var commandInstance : ICommand = new commandClassRef();
-commandInstance.setMultitonKey( multitonKey );
+commandInstance.initializeNotifier( multitonKey );
 commandInstance.execute( note );
 }
 

src/org/puremvc/as3/multicore/core/Model.as

@@ -89,7 +89,7 @@ package org.puremvc.as3.multicore.core
  */
 public function registerProxy( proxy:IProxy ) : void
 {
-proxy.setMultitonKey( multitonKey );
+proxy.initializeNotifier( multitonKey );
 proxyMap[ proxy.getProxyName() ] = proxy;
 }
 

src/org/puremvc/as3/multicore/core/View.as

@@ -136,7 +136,7 @@ package org.puremvc.as3.multicore.core
 public function registerMediator( mediator:IMediator ) : void
 {
 
-mediator.setMultitonKey( multitonKey );
+mediator.initializeNotifier( multitonKey );
 
 // Register the Mediator for retrieval by name
 mediatorMap[ mediator.getMediatorName() ] = mediator;

src/org/puremvc/as3/multicore/interfaces/INotifier.as

@@ -43,8 +43,15 @@ package org.puremvc.as3.multicore.interfaces
 function sendNotification( notificationName:String, body:Object=null, type:String=null ):void; 
 
 /**
- * Set the multitonKey for this INotifier instance
+ * Initialize this INotifier instance.
+ * <P>
+ * This is how a Notifier gets its multitonKey. 
+ * Calls to sendNotification or to access the
+ * facade will fail until after this method 
+ * has been called.</P>
+ * 
+ * @param key the multitonKey for this INotifier to use
  */
-function setMultitonKey( key:String ): void;
+function initializeNotifier( key:String ): void;
 }
 }

src/org/puremvc/as3/multicore/patterns/facade/Facade.as

@@ -32,7 +32,7 @@ package org.puremvc.as3.multicore.patterns.facade
  */
 public function Facade( key:String ) {
 if (instanceMap[ key ] != null) throw Error(MULTITON_MSG);
-setMultitonKey( key );
+initializeNotifier( key );
 instanceMap[ multitonKey ] = this;
 initializeFacade();
 }
@@ -302,7 +302,7 @@ package org.puremvc.as3.multicore.patterns.facade
  * It is necessary to be public in order to 
  * implement INotifier.</P>
  */
-public function setMultitonKey( key:String ):void
+public function initializeNotifier( key:String ):void
 {
 multitonKey = key;
 }

src/org/puremvc/as3/multicore/patterns/observer/Notifier.as

@@ -60,7 +60,25 @@ package org.puremvc.as3.multicore.patterns.observer
 facade.sendNotification( notificationName, body, type );
 }
 
-public function setMultitonKey( key:String ):void
+/**
+ * Initialize this INotifier instance.
+ * <P>
+ * This is how a Notifier gets its multitonKey. 
+ * Calls to sendNotification or to access the
+ * facade will fail until after this method 
+ * has been called.</P>
+ * 
+ * <P>
+ * Mediators, Commands or Proxies may override 
+ * this method in order to send notifications
+ * or access the Multiton Facade instance as
+ * soon as possible. They CANNOT access the facade
+ * in their constructors, since this method will not
+ * yet have been called.</P> 
+ * 
+ * @param key the multitonKey for this INotifier to use
+ */
+public function initializeNotifier( key:String ):void
 {
 multitonKey = key;
 }