ColdFusion struct properties converted to uppercase when using Flash Remoting

If you've ever passed a struct from ColdFusion to Flash via Flash Remoting, you've probably noticed that all of the keys for the struct come into Flash as uppercase. In the past, this wasn't that big of a deal, but when Flash Player 7 came around with case-sensitivity, some people started to encounter problems. Here's the simple workaround...

Consider the following code:

<cfcomponent>
  <cffunction name="getSomeData" returntype="struct" access="remote">
    <cfset oData = StructNew() />
    <cfset oData.key1 = "example 1" />   <!--- converts to KEY1 --->
    <cfset oData["key2"]= "example 2" />   <!--- preserves case --->
    <cfset StructInsert(oData, "key3", "example 3") /> <!--- preserves case --->
    <cfreturn oData />
  </cffunction>
</cfcomponent>

Note that accessing a struct in the "usual" way with dot notation will convert the key to all uppercase. By using array (bracket) notation, you can preserve the case of the key. Additionally, if you use the StructInsert function you can also preserve the case of the key.

I hope this post saves someone some debugging time in the future. This question recently came up on a mailing list, so hopefully google will find this post and make the answer easier to locate. :-)