0
@@ -15,7 +15,9 @@
0
       instance.initialState = arguments.initialState;
0
             
0
       configureState();
0
-      setInitialState(instance.initialState);
0
+      if(getState() eq '') {
0
+        setInitialState(instance.initialState);
0
+      }
0
             
0
       return this;
0
     </cfscript>
0
@@ -65,13 +67,13 @@
0
     <cfreturn invokeMethod("get#instance.stateMethod#") />
0
   </cffunction>
0
   
0
-  <cffunction name="setState" access="public" output="false">
0
+  <cffunction name="setInternalState" access="public" output="false">
0
     <cfargument name="state" type="string" required="true" />  
0
     <cfset var local = structNew() />
0
     <cfset local.state = arguments.state />
0
     <cfset invokeMethod("set#instance.stateMethod#", local) />
0
   </cffunction>
0
-
0
+  
0
   <!--- Accessors --->
0
   
0
   <cffunction name="getInitialState" access="public" returntype="string" output="false">
0
@@ -85,7 +87,7 @@
0
     <cfscript>
0
       var state = instance.states[arguments.stateName];
0
       state.before(this);
0
-      setState(arguments.stateName);
0
+      setInternalState(arguments.stateName);
0
       state.after(this);
0
     </cfscript>
0
   </cffunction>  
0
@@ -137,16 +139,22 @@
0
   
0
     1. To defined the state query handlers, i.e. isClosed()
0
     2. To define the event firing shortcuts, i.e. close()
0
-    3. To pass any unknown method on to the decorated object to handle
0
-        
0
+    3. To pass any unknown method on to the decorated object to handle        
0
   --->  
0
   <cffunction name="onMissingMethod" output="false" access="public">
0
     <cfargument name="missingMethodName" type="string" />
0
     <cfargument name="missingMethodArguments" type="struct" />
0
     
0
-    <!--- 
0
-    Shortcut to wire up event methods, so basically if you have a 
0
-    'trash' event, you can call obj.trash() rather than the longer obj.fireEvent('trash') --->
0
+    <!--- This is to highly discourage the manual setting of state. 
0
+          It can still be done by getting the original object and 
0
+          setting it directly. BAD. --->
0
+    <cfif arguments.missingMethodName is "set#getStateMethod()#" >
0
+      <cfthrow type="shade.InvalidStateChange" message="You cannot set the state directly. Please call an event instead to change the state." />
0
+    </cfif>
0
+    
0
+    <!--- Shortcut to wire up event methods, so basically if you have a 
0
+          'trash' event, you can call obj.trash() rather than the longer 
0
+          obj.fireEvent('trash') --->
0
     <cfif structKeyExists(instance.eventTable, arguments.missingMethodName)>
0
       <cfreturn fireEvent(arguments.missingMethodName) />    
0
     </cfif>

0
@@ -50,7 +50,7 @@
0
       
0
       if(not local.isLoopback) {
0
         if(local.nextState.before(obj)) {  
0
-          obj.setState(getToState());
0
+          obj.setInternalState(getToState());
0
           local.nextState.after(obj);  
0
           local.oldState.exit(obj);  
0
         } else {

0
@@ -2,6 +2,7 @@
0
   <cfset instance = structNew() />
0
 
0
   <cffunction name="init" access="public" returntype="any" output="false" hint="">
0
+    <cfset instance.state = '' />
0
     <cfreturn this />
0
   </cffunction>
0
     

0
@@ -210,6 +210,15 @@
0
     </cfscript>
0
   </cffunction>
0
 
0
-
0
+  <cffunction name="testCannotSetStateDirectly" returntype="void" access="public" output="false">
0
+    <cfscript>
0
+      try {
0
+        conversation.setMyState('new');
0
+        fail('Should not be able to set state directly.');
0
+      } catch( any e ) {
0
+        assertEquals( 'shade.InvalidStateChange', e.type );
0
+      }
0
+    </cfscript>
0
+  </cffunction>
0
   
0
 </cfcomponent>
0
\ No newline at end of file