mac martine

To set up our examples, let create a most basic CFC. Let's call this file NEWCFComponent.cfc and this'll be it's contents:

<cfcomponent displayname="CF_Service" output="false"> <cffunction name="WelcomeMsg" access="remote" returntype="string"> <cfargument name="name" type="string" required="yes"> <cfreturn "YO, #name#!"> </cffunction> </cfcomponent>

You can see this simply takes the #name# variable that it retrieves and returns the welcome message "Yo, #name#!".

Okay, let's first call this with a WebService. Just create a basic local Flex project. Here's the main application for that project:

<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute"> <mx:Script> <![CDATA[ import mx.rpc.events.FaultEvent; import mx.rpc.Fault; import mx.rpc.events.ResultEvent; private function onResult( e : ResultEvent ) :void { msg.text = e.result.toString(); } private function onFault( e : FaultEvent ) :void { trace( 'Oops!' ); } ]]> </mx:Script> <mx:WebService id="ws" wsdl="http://<server-name-or-IP>:8500/cf/CF_Service/NewCFComponent.cfc?wsdl" showBusyCursor="true"> <mx:operation name="WelcomeMsg" result="onResult(event)" fault="onFault(event)"> <mx:request xmlns=""> <name> {_name.text} </name> </mx:request> </mx:operation> </mx:WebService> <mx:Button x="284" y="10" label="Get Welcome Message." click="ws.WelcomeMsg.send()"/> <mx:TextInput id="msg" x="681" y="10"/> <mx:TextInput id="_name" x="116" y="10"/> <mx:Label x="10" y="12" text="Enter your name:"/> </mx:Application>

Modify the 'wsdl' attribute of the WebService tag as necessary to point to your CF server.

That's it! Now Run the Flex app, enter your name, click the button and see your welcome message!

Now let's do the same thing but use a RemoteObject.

Create a Flex Project and in the Flex Project Wizard choose 'ColdFusion' for the server type and 'ColdFusion Flash Remoting'. Point the 'Web root' and 'Root URL' to your CF server.

Use the same contents for the Flex application as above except remove the WebService tag and all it's contents, and put this in it's place:

<mx:RemoteObject id="ws" destination="ColdFusion" source="cf.CF_Service.NewCFComponent"> <mx:method name="WelcomeMsg" result="onResult(event)" fault="onFault(event)"/> </mx:RemoteObject>

The 'destination' is the remote destination as defined in remoting-config.xml (located in the /WEB-INF/flex directory). 'ColdFusion' is a pre-defined, built-in destination. The 'source' attribute should point to the location of your CFC starting at the server root. Note that this does not include the CFC extension, just the name of the CFC.

Go ahead and run the app and it should behave just the same as the WebService version we created above, but maybe faster.

If you want to create you own destination you can do that easily. Open remoting-config.xml (located in the /WEB-INF/flex directory and add this destination:

<destination id="cfRemotingExample"> <channels> <channel ref="my-cfamf"/> </channels> <properties> <source>cf.CF_Service.NewCFComponent</source> <!-- define the resolution rules and access level of the cfc being invoked --> <access> <!-- Use the ColdFusion mappings to find CFCs, by default only CFC files under your webroot can be found. --> <use-mappings>false</use-mappings> <!-- allow "public and remote" or just "remote" methods to be invoked --> <method-access-level>remote</method-access-level> </access> <property-case> <!-- cfc property names --> <force-cfc-lowercase>false</force-cfc-lowercase> <!-- Query column names --> <force-query-lowercase>false</force-query-lowercase> <!-- struct keys --> <force-struct-lowercase>false</force-struct-lowercase> </property-case> </properties> </destination>

The 'source' attribute should point to the location of your CFC starting at the server root. This should be identical to the 'source' attribute you had in your RemoteObject tag.

Now a couple quick modifications to the RemoteObject and we're good to go:

<mx:RemoteObject id="ws" destination="cfRemotingExample" showBusyCursor="true"> <mx:method name="WelcomeMsg" result="onResult(event)" fault="onFault(event)"/> </mx:RemoteObject>

Notice we just changed the 'destination' attribute to point to our new destination name, and we removed the 'source' attribute because we included that in the of our custom destination in remoting.config.xml. For now we'll just use the default remote destination configured in remoting-config.xml (located in the /WEB-INF/flex directory)