MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX... Mounting instructions

Using ColdFusion MX with Flex 2

Trademarks

1 Step RoboPDF, ActiveEdit, ActiveTest, Authorware, Blue Sky Software, Blue Sky, Breeze, Breezo, Captivate, Central,

ColdFusion, Contribute, Database Explorer, Director, Dreamweaver, Fireworks, Flash, FlashCast, FlashHelp, Flash Lite,

FlashPaper, Flash Video Encoder, Flex, Flex Builder, Fontographer, FreeHand, Generator, HomeSite, JRun, MacRecorder, Adobe

Systems Incorporated, MXML, RoboEngine, RoboHelp, RoboInfo, RoboPDF, Roundtrip, Roundtrip HTML, Shockwave,

SoundEdit, Studio MX, UltraDev, and WebHelp are either registered trademarks or trademarks of Adobe Systems Incorporated

and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos,

designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Adobe

Systems Incorporated or other entities and may be registered in certain jurisdictions including internationally.

Third-Party Information

This guide contains links to third-party websites that are not under the control of Adobe Systems Incorporated, and Adobe

Systems Incorporated is not responsible for the content on any linked site. If you access a third-party website mentioned in this

guide, then you do so at your own risk. Adobe Systems Incorporated provides these links only as a convenience, and the inclusion

of the link does not imply that Adobe Systems Incorporated endorses or accepts any responsibility for the content on those third-

party sites.

Speech compression and decompression technology licensed from Nellymoser, Inc. (www.nellymoser.com).

Sorenson™ Spark™ video compression and decompression technology licensed from

Sorenson Media, Inc.

reproduced, translated, or converted to any electronic or machine-readable form in whole or in part without written

approval from Adobe Systems Incorporated Notwithstanding the foregoing, the owner or authorized user of a valid copy

of the software with which this manual was provided may print out one copy of this manual from an electronic version of

this manual for the sole purpose of such owner or authorized user learning to use such software, provided that no part of

this manual may be printed out, reproduced, distributed, resold, or transmitted for any other purposes, including,

without limitation, commercial purposes, such as selling copies of this documentation or providing paid-for support

services.

Acknowledgments

Project Management: Randy Nielsen

Writing: Anne Sandstrom

Editing: Linda Adler

Production Management: Adam Bernett

Media Design and Production: Masayo Noda

Special thanks to Linda Adler, Randy Nielsen, Bill Sahlas, Farah Gron, Bob Powelll, Mike Nimer., Dean Harmon, and

Tom Jor d h a l

First Edition: June, 2006

Adobe Systems Incorporated

601 Townsend St.

San Francisco, CA 94103

Contents

Chapter 1: Using Flash Remoting Update . . . . . . . . . . . . . . . . . . . . 5

About Flash Remoting Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Using Flash Remoting Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Data translation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

Chapter 2: Using the Flex Messaging Event Gateway . . . . . . . . . 13

About Flex and ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Configuring a Flex Messaging event gateway . . . . . . . . . . . . . . . . . . . . . 15

Enabling communication with Flex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Sending outgoing messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Handling incoming messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Using session and client variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Data translation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Chapter 3: Use ColdFusion Event Gateway Adapter . . . . . . . . . 25

Set up your development environment . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Create the Flex application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Import the required ActionScript classes . . . . . . . . . . . . . . . . . . . . . . 29

Create the ColdFusion application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Test the application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Chapter 4: Using the Flex Data Service Assembler . . . . . . . . . . 35

About Flex and ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Application development and deployment process . . . . . . . . . . . . . . . .37

Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Enabling SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Data translation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47

Example application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

4Contents

Chapter 5: Using the ColdFusion Extensions for

Flex Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

About the ColdFusion Extensions for Flex Builder . . . . . . . . . . . . . . . . 74

Installing the ColdFusion Extensions for Flex Builder . . . . . . . . . . . . . . 74

Eclipse RDS Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

ColdFusion/Flex Application wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

ActionScript to CFC wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

CFC to ActionScript wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

RDS CRUD wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Services Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

CHAPTER 1

Using Flash Remoting

Update

You can use Macromedia Flash Remoting Update to create rich Internet applications in

ColdFusion MX 7.0.2.

Contents

About Flash Remoting Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Using Flash Remoting Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

About Flash Remoting Update

The Flash Remoting Update lets you create rich Internet applications (RIAs) by using Adobe

Flex Builder 2, with the advanced data retrieval features of ColdFusion, such as the cfpop,

cfldap, and cfquery tags. In addition, you can use Flash Remoting Update to create

Macromedia Flash Forms and Flash applications that contain features such as server call backs

and customized user interface.

You can use Flash Remoting Update with all configurations of ColdFusion MX 7.0.2 (server,

multiserver, and J2EE) on all the platforms that ColdFusion MX 7.0.2 supports.

To use Flash Remoting Update, you must have the following installed:

■Flex Builder 2

■Flash Player 9

■ColdFusion MX 7.0.2

6 Using Flash Remoting Update

Using Flash Remoting Update

To specify a CFC to connect to, you do one of the following:

■Specify the CFC, including the path from the web root, in the MXML.

■Create a named resource for each CFC that you connect to. This is similar to registering a

data source.

To specify the CFC in the MXML:

■Specify the CFC, including the path from the web root, in the MXML; for example:

<mx:RemoteObject

id="myCfc"

destination="ColdFusion"

source="myApplication.components.User"/>

The destination “ColdFusion” is preconfigured in the services-config.xml file, which is

located in the ColdFusion webroot\WEB-INF\flex directory, with the wildcard *as the

source. To use the source attribute in MXML, you can use any destination by specifying

the source="*". If you specify a source other than “*”, that source definition overrides

the source specified in the MXML.

To create a named resource for each CFC that you connect to:

1. Edit the services-config.xml file by adding an entry for each CFC that you connect to, for

example:

</channels>

<lowercase-keys>true</lowercase-keys>

</properties>

</destination>

The source attribute specifies the dot notation to the CFC from the web root (the

classpath to the CFC).

2. Restart the ColdFusion server.

Using Flash Remoting Update 7

To use the CFC resource in your Flex Builder 2 project:

1. For each Flex Builder 2 project, set the Flex compiler property by doing the following:

a. Select Project > Properties.

b. Select the Flex complier option.

c. Enter the following in the Additional Compiler Argument text box:

--services=C:\CFusionMX7\wwwroot\WEB-INF\flex\services-config.xml

2. In the mxml file, you use the <mx:RemoteObject> tag to connect to your CFC named

resource. With this connection you can call any remote method on the CFC.

3. Use the destination attribute of the <mx:RemoteObbject> tag to point to the name that

you defined in the services-config.xml file; for example:

<mx:RemoteObject

id="a_named_reference_to_use_in_mxml"

destination="CustomID"

result="my_CFC_handler(event)"/>

4. Call a CFC method, for example, as the following example shows:

<mx:Button label="reload" click="my_CFC.getUsers()"/>

In this example, when a user presses a button, the Click event calls the CFC method

getUsers.

5. Specify a handler for the return result of the CFC method call for the <mx:RemoteObject>

tag, as the following example shows.

private function my_CFC_handler( event:ResultEvent )

{

// Show alert with the value that is returned from the CFC.

mx.controls.Alert.show(ObjectUtil.toString(event.result));

}

8 Using Flash Remoting Update

Flash Remoting Update and authentication

The Flash client passes the username and password, which are set in the Flash client, to the

CFC. To authenticate users when using Flash Remoting Update, you can then use the

cflogin tag to authenticate the user.

Flash Remoting Update supports the same authentication mechanism as any HTTP request

from the browser, including getting and setting cookies. This mechanism allws you to take

advantage of the same authentication systems you use for any normal HTTP request. To take

advantage of this functionality in a Flash application, you need to set the HTTP authorization

headers by specifying the user’s username and password with the RemoteObject

setRemoteCredentials method. When ColdFusion receives the Flash Remoting /http

request, ColdFusion populates the cflogin.name and cflogin.password variables (inside the

cflogin tag) with these values. For more information, see the documentation for the

cflogin tag.

Example application

The following sample application lets you test authentication. It consists of a Flex application,

and a ColdFusion application that consists of an Application.cfm file and the ColdFusion

component that the Flex application calls.

The Flex application appears as follows:

The Flex application above lets you enter a username and password. It creates a remote object

to the CFC. Because the application creates a remote object that is managed by a CFC, you

can set a username and password for the authentication mechanism of the remote service.

When you click the Login button, the application calls the setRemoteCredentials method,

using the username and password entered in the text boxes. This sets the properties in the

mx:RemoteObject tag, which are passed in all future requests.

Using Flash Remoting Update 9

When you click the Logout button, the application calls the setRemoteCredentials

method, which sets the username and password to null, and logs out the user on the client

side. In addition, the application calls the logoutuser method, which handles server side

logout.

When you click the Get Secure Data button, the application calls the getData method in the

MXML file, which, in turn, calls the getData function in the CFC. The getData function in

the CFC returns a string for purposes of this simple test application, but could be modified to

return data such as the results of a query.

The Flex application also includes the serverFault and serverResult methods, which

display an alert box to indicate whether the login was successful or not.

The MXML file appears as follows:

<?xml version="1.0" encoding="utf-8"?>

<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" xmlns="*"

layout="absolute">

<mx:Script>

<![CDATA[

import mx.rpc.events.ResultEvent;

import mx.utils.ObjectUtil;

import mx.controls.Alert;

import mx.rpc.events.FaultEvent;

private function logIn():void{

cf.setRemoteCredentials(this.username.text, this.password.text);

}

private function logOut():void

{

cf.setRemoteCredentials(null, null);

cf.logoutuser();

}

private function getData():void

{

cf.getData();

}

private function serverFault(event:FaultEvent):void{

Alert.show( ObjectUtil.toString(event.fault) );

Alert.show( "error" );

}

private function serverResult(event:ResultEvent):void{

Alert.show( ObjectUtil.toString(event));

Alert.show( "success" );

}

]]>

</mx:Script>

10 Using Flash Remoting Update

<mx:RemoteObject id="cf"

destination="ColdFusion"

source="CFIDE.samples.LoginTest.logintest">

<mx:method name="getData" result="serverResult(event)"

fault="serverFault(event)" />

<mx:method name="logoutuser" />

</mx:RemoteObject>

<mx:Form x="10" y="10">

<mx:FormItem label="username">

<mx:TextInput id="username" text="admin"/>

</mx:FormItem>

<mx:FormItem label="password">

<mx:TextInput id="password" text="adminpwd"/>

</mx:FormItem>

<mx:FormItem direction="horizontal">

<mx:Button label="Login" click="logIn();"/>

<mx:Button label="Logout" click="logOut()"/>

</mx:FormItem>

<mx:Button label="Get Secure Data" click="getData();"/>

</mx:Form>

</mx:Application>

The Application.cfm file authenticates the user and identifies the user with the flexadmin role.

<cfapplication name="loginTest6" sessionmanagement="true"

setclientcookies="true">

<cfloginuser name="#cflogin.name#" password="#cflogin.password#"

roles="flexadmin">

</cfif>

</cflogin>

This manual suits for next models

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA BREEZE-FOR MEETING PRESENTERS User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-DEVELOPING WEB User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION... User manual

MACROMEDIA

MACROMEDIA FLASH 8-DEVELOPING FLASH LITE 2.X User manual

MACROMEDIA

MACROMEDIA BREEZE 5 Operator's manual

MACROMEDIA

MACROMEDIA DRUMBEAT 2000 ECOMMERCE EDITION User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA FLASH 8-USING FLASH VIDEO ENCODER Mounting instructions

MACROMEDIA

MACROMEDIA CONTRIBUTE 3-CONTRIBUTE PUBLISHING SERVER User manual

MACROMEDIA

MACROMEDIA COLDFUSION MX 61-CFML User manual

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING ACTIONSCRIPT 2.0 IN FLASH User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-LEARNING FLASH User manual

MACROMEDIA

MACROMEDIA FLASH COMMUNICATION SERVER MX-SERVER-SIDE COMMUNICATION ACTIONSCRIPT... User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MEDIA SERVER 2-SERVER-SIDE ACTIONSCRIPT... Service manual

MACROMEDIA

MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER User manual

MACROMEDIA

MACROMEDIA FLEX - DEVELOPING COMPONENTS AND THEMES User manual

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML User manual

MACROMEDIA

MACROMEDIA FLASH 8-INTRODUCTION TO FLASH LITE 2.X... Reference manual

MACROMEDIA

MACROMEDIA FLASH 8-EXTENDING FLASH User manual

MACROMEDIA

MACROMEDIA FIREWORKS 8-USING FIREWORKS Mounting instructions

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual