flex 4 accessingdata

7/22/2019 Flex 4 Accessingdata

1/139

Accs aux donnes avec

ADOBEFLEX4


2/139

Dernire mise jour le 18/3/2010

Copyright 2010 Adobe Systems Incorporated. All rights reserved.

Accs aux donnes avec AdobeFlex4.

Adobe, the Adobe logo, ActionScript, Adobe AIR, ColdFusion, Dreamweaver, Flash, Flash Player, Flash Builder, Flex, Flex Builder, and LiveCycle are eitherregistered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Microsoft and Windows are either registered

trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Apple, Macintosh, and Mac OS are trademarks of Apple Inc.,

registered in the United States and other countries. Java is a trademarks or registered trademark of Sun Microsystems, Inc. in the United States and othercountries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. All other trademarks are the property of their respective owners.

This Work is licensed under the Creative Commons Attribution Non-Commercial 3.0 License. To view a copy of this license, visit

http://creativecommons.org/licenses/by-nc-sa/3.0/

Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
http://creativecommons.org/licenses/by-nc-sa/3.0/http://creativecommons.org/licenses/by-nc-sa/3.0/


3/139

iiiDernire mise jour le 18/3/2010

Sommaire

Chapitre 1 : Prsentation de laccs aux services de donnes

Accs aux donnes dans Flex compar dautres technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Utilisation de Flash Builder pour accder aux services de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Composants daccs aux donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapitre 2 : Cration dapplications centres sur les donnes avec Flash Builder

Cration dun projet Flex pour laccs des services de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Connexion des services de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Installation de Zend Framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Utilisation dune occurrence de serveur unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Gnration de lapplication client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Configuration des types de donnes pour les oprations de service de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Test des oprations de service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Gestion de laccs aux donnes partir du serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Gnration du code Flash Builder pour les applications client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Dploiement des applications accdant aux services de donnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Chapitre 3 : Implmentation de services pour des applications centres sur les donnes

AMF (Action Message Format) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Dfinition de type ct client et ct serveur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Implmentation de services ColdFusion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Implmentation de services PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Dbogage de services distants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Exemple dimplmentation de services partir de plusieurs sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

Chapitre 4 : Accs aux donnes ct serveur

Utilisation de composants HTTPService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

Utilisation de composants WebService . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

Utilisation de composants RemoteObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Transmission de paramtres explicites et liaison de paramtres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

Traitement des rsultats des services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127


4/139

1Dernire mise jour le 18/3/2010

Chapitre 1 : Prsentation de laccs auxservices de donnes

Accs aux donnes dans Flex compar dautrestechnologies

Flex nutilise pas les sources de donnes et les donnes de la mme manire que les applications dont linterface

utilisateur fait appel HTML.

Traitement ct client et traitement ct serveur

Contrairement aux ensembles de modles HTML crs laide de servlets, denvironnements JSP, ASP, PHP ou

CFML, Flex spare le code client du code serveur. Linterface utilisateur de lapplication est compile dans un fichier

binaire SWF envoy au client.

Lorsque lapplication effectue une demande un service de donnes, le fichier SWF nest pas recompil et aucune

ractualisation de page nest requise. Le service distant ne renvoie que des donnes. Flex lie les donnes renvoyes

des composants de linterface utilisateur dans lapplication client.

Lorsquun utilisateur clique sur le contrle Button dune application par exemple, le code ct client appelle un service

Web. Les donnes de rsultat provenant du service Web sont renvoyes dans le fichier SWF binaire sans

ractualisation de page. Les donnes de rsultat peuvent alors tre utilises comme contenu dynamique dans

lapplication.

import mx.controls.Alert;

protected function b1_clickHandler(event:MouseEvent):void {

getRestaurantsResult.token = RestaurantWS.getRestaurantss();

}

]]>

. . .


5/139

2ACCS AUX DONNES AVEC FLEXPrsentation de l accs aux services de donnes


Comparons cet exemple Flex lexemple suivant, dans lequel du code JSP est utilis pour appeler un service Web avec

une balise personnalise JSP. Lorsquun utilisateur demande le code JSP, la demande du service Web est effectue sur

le serveur et non pas sur le client. Le rsultat est utilis pour gnrer du contenu dans la page HTML. Le serveur

dapplication regnre la page HTML entire avant de la renvoyer au navigateur Web de lutilisateur.

Accs la source de donnes

Une autre diffrence entre Flex et les autres technologies dapplication Web rside dans labsence (dans Flex) de

communication directe avec une source de donnes. Vous utilisez un composant daccs aux donnes pour vous

connecter un service distant et interagir avec la source de donnes ct serveur.

Lexemple suivant prsente une page ColdFusion accdant directement une source de donnes :

...

SELECT * FROM table

...

Une fonctionnalit similaire est obtenue dans Flex en ayant recours un service HTTPService, un service Web ou un

composant RemoteObject afin dappeler un objet ct serveur qui renvoie les rsultats dune source de donnes.

Evnements, appels de service et liaison de donnes

Flex est une technologie oriente vnement. Une action de lutilisateur ou un vnement de programme peut

dclencher laccs un service. Par exemple, lutilisateur cliquant sur un bouton constitue un vnement daction qui

peut tre utilis pour dclencher un appel de service. Un vnement de programme peut tre une applicationterminant la cration dun composant de linterface utilisateur tel quun composant DataGrid. Lvnement

creationComplete pour le composant DataGrid peut tre utilis pour appeler un service distant qui renseignera ce

composant.

Dans Flex, les appels de service sont asynchrones. Lapplication client na pas besoin dattendre les donnes renvoyes.

Les appels de service asynchrones prsentent des avantages lors de lextraction ou de la mise jour de jeux de donnes

volumineux. Lapplication client nest pas bloque par lattente de lextraction ou de la mise jour des donnes.


6/139



Les donnes renvoyes par un appel de service sont stockes dans une proprit CallResponder associe lappel de

service. Les composants de linterface utilisateur font alors appel la liaison de donnes pour extraire de la proprit

CallResponder les donnes renvoyes.

La liaison de donnes dans Flex vous permet de mettre jour dynamiquement un composant de linterface utilisateur

avec une source de donnes. Par exemple, un composant Flex peut associer son attribut text lattribut lastResult dune

proprit CallResponder. En cas de modification des donnes de CallResponder, le composant Flex est

automatiquement mis jour.

Flex implmente galement la liaison de donnes bidirectionnelle qui garantit la mise jour automatique dun

composant Flex ou dune source de donnes dont les donnes sont modifies. Un autre avantage de la liaison de

donnes bidirectionnelle rside dans la mise jour de donnes distantes partir des saisies effectues par un utilisateur

dans un composant Form ou dans un composant de donnes Flex.

Voir aussi

Cration dapplications centres sur les donnes avec Flash Builder la page 8

Utilisation de Flash Builder pour accder aux services dedonnes

Flex Builder 3 permet dimplmenter des appels de procdures distants des services de donnes laide des

composants daccs aux donnes Flex. Cependant, Flash Builder simplifie ce processus.

Flash Builder fournit des assistants et des outils permettant deffectuer les oprations suivantes :

Accs aux services de donnes

Configuration des donnes renvoyes par le service de donnes

Assistance pour la pagination des donnes renvoyes par le service Assistance pour la fonctionnalit de gestion des donnes qui synchronise plusieurs mises jour des donnes du

serveur

Gnration de code client pour laccs aux services de donnes

Liaison des donnes renvoyes par le service aux composants de linterface utilisateur

Flux de travaux Flash Builder pour laccs aux services

Appliquez le flux de travaux suivant lorsque vous utilisez Flash Builder pour crer une application qui accde des

services de donnes.

1 Selon les circonstances, vous commencerez soit par vous connecter un service de donnes, soit par construire

linterface utilisateur.

Connexion au service distant Si vous commencez par vous connecter au service distant, vous devez ensuite

construire linterface utilisateur.

Construction de linterface utilisateurSi vous commencez par construire linterface utilisateur, vous devez ensuite

vous connecter au service distant.

Remarque : la premire action effectue relve dun choix personnel. Par exemple, si la conception dune interface

utilisateur est dj prvue, vous pouvez commencer par construire linterface utilisateur. A linverse, vous pouvez

commencer par vous connecter aux donnes et laisser Flash Builder vous aider gnrer les composants dapplication.


7/139



2 Liez les oprations de donnes des composants dapplications.

Flash Builder vous assiste de diverses manires pour lier les oprations de donnes des composants dapplications.

Dans Flash Builder, procdez comme suit :

Gnrez diffrents formulaires pour les donnes renvoyes par les oprations de service. Slectionnez les oprations de service que vous souhaitez lier aux composants de linterface utilisateur.

Gnrez un formulaire pour reprsenter les donnes complexes renvoyes par un service.

3 (Facultatif) Grez lextraction et la mise jour des donnes.

Les outils Flash Builder vous permettent dimplmenter la pagination des donnes renvoyes et de coordonner la

mise jour des jeux de donnes.

Lors du retour de gros volumes denregistrements de donnes, vous implmentez gnralement la pagination pour

extraire un jeu denregistrements selon vos besoins.

Pour les applications mettant jour plusieurs enregistrements, vous pouvez implmenter des fonctions de gestion

de donnes. Les fonctions de la gestion des donnes sont parmi dautres :

Fonction de validation pour la mise jour simultane des enregistrements modifis

Mcanisme dannulation des modifications avant leur criture sur le serveur

Gnration de code pour la mise jour automatique des composants dinterface utilisateur au fur et mesureque des enregistrements sont ajouts, supprims ou modifis

4 Excutez lapplication et surveillez le flux de donnes.

Une fois lapplication termine, excutez-la pour en observer le fonctionnement. Utilisez le Moniteur de rseau

Flash Builder pour afficher les donnes transmises entre lapplication et le service. Le Moniteur de rseau est utile

pour diagnostiquer les erreurs et analyser les performances.

Flash Builder fournit galement des environnements robustes de dbogage et de dfinition de profil. Le Moniteur

de rseau et le profileur Flash sont disponibles avec Flash Builder Premium.

Voir aussi

Cration dapplications centres sur les donnes avec Flash Builder la page 8

Dveloppement des services pris en charge par Flash Builder

Les assistants et les outils Flash Builder prennent en charge laccs aux implmentations des types de services suivants :

Services PHP

Services ColdFusion

BlazeDS

Services LiveCycle Data Services Services HTTP (de style REST)

Services Web (SOAP)

Fichiers XML statiques

Si vous avez besoin dune prise en charge doutils pour dautres types de services (Ruby on Rails, par exemple), vous

pouvez dvelopper limplmentation Flash Builder. Voir Rfrence dextensibilit Flash Builder.
http://www.adobe.com/go/learn_flex4_extensibility_fr/http://www.adobe.com/go/learn_flex4_extensibility_fr/http://www.adobe.com/go/learn_flex4_extensibility_fr/


8/139



Composants daccs aux donnes

Les composants daccs aux donnes permettent une application client dappeler des oprations et des services

travers un rseau. Les composants daccs aux donnes utilisent des appels de procdure distante pour interagir avec

les environnements de serveur. Les trois composants daccs aux donnes sont les composants RemoteObject,

HTTPService et WebService.

Les composants daccs aux donnes sont conus pour les applications client dans lesquelles un modle dappel et de

rponse constitue un bon choix pour accder aux donnes externes. Ces composants permettent au client deffectuer

des demandes asynchrones des services distants qui traitent les demandes, puis de renvoyer les donnes

lapplication.

Un composant daccs aux donnes appelle un service distant. Il stocke ensuite les donnes de rponse du service dans

un objet ActionScript ou tout autre format renvoy par le service. Utilisez les composants daccs aux donnes dans

lapplication client pour quelle fonctionne avec trois types de services :

Services dobjets distants (RemoteObject)

Services Web (WebServices) Services HTTP (HTTPService)

Adobe Flash Builder fournit des assistants et des outils permettant denvelopper limplmentation dun composant

daccs aux donnes dans une enveloppe de service. Lenveloppe de service encapsule la fonctionnalit du composant

daccs aux donnes, rendant invisible une grande partie de limplmentation de niveau infrieur et vous permettant

ainsi de vous concentrer sur limplmentation de services et la gnration dapplications client pour accder ces

services. Pour plus dinformations sur lutilisation de Flash Builder pour accder aux services de donnes, voir

Cration dapplications centres sur les donnes avec Flash Builder la page 8.

Accs aux services

Par dfaut, Adobe Flash Player bloque laccs tout hte qui ne correspond pas exactement celui utilis pour charger

une application. Si vous nutilisez pas Adobe LiveCycle Data Services pour traiter les demandes par proxy, un service

HTTP ou Web doit rsider sur le serveur hbergeant lapplication ou le serveur distant hbergeant le service HTTP ou

Web doit dfinir un fichier crossdomain.xml. Le fichier crossdomain.xml permet un serveur dindiquer que ses

donnes et ses documents sont disponibles pour les fichiers SWF traits partir de certains domaines ou de tous les

domaines. Le fichier crossdomain.xmldoit figurer la racine Web du serveur que lapplication contacte.

Composants HTTPService

Utilisez les composants HTTPService pour lenvoi de requtes HTTP GET ou POST et afin dinclure les donnes de

rponses HTTP dans une application client. Si vous utilisez Flex pour crer des applications de bureau (excutes dans

Adobe AIR), les requtes HTTP PUT et DELETE sont prises en charge.

Si vous utilisez Adobe LiveCycle Data Services ou BlazeDS, vous pouvez faire appel un HTTPProxyService grce

auquel vous pourrez utiliser des mthodes HTTP supplmentaires. Le service HTTPProxyService vous permet

denvoyer des requtes GET, POST, HEAD, OPTIONS, PUT, TRACE ou DELETE.

Un service HTTP peut consister en nimporte quel URI HTTP qui accepte des demandes HTTP et envoie des rponses.

Un autre nom courant pour ce type de service est service Web de style REST. REST signifie REpresentational State

Transfer, un style architectural pour les systmes hypermdia distribus.


9/139



Les composants HTTPService savrent utiles lorsque vous ne pouvez pas exposer la mme fonctionnalit en tant que

service Web SOAP ou service dobjet distant. Vous pouvez par exemple utiliser des composants HTTPService pour

interagir avec des pages JavaServer (JSP), des servlets et des pages ASP qui ne sont pas disponibles comme services Web

ou destinations de service distant.

Lorsque vous appelez la mthode send()de lobjet HTTPService, elle effectue une demande HTTP auprs de lURI

spcifi et une rponse HTTP est renvoye. Si vous le souhaitez, vous pouvez transmettre des arguments lURI

spcifi.

Flash Builder fournit des flux de travaux qui vous permettent de vous connecter de manire interactive des services

HTTP. Pour plus dinformations, voir Accs aux services HTTP la page 13.

Voir aussi

Accs aux services HTTP la page 13

Thse : Representational State Transfer (REST) par Roy Thomas Fielding

Composants WebServiceLes composants WebService vous permettent daccder aux services Web SOAP (modules logiciels comportant des

mthodes). Les mthodes de service Web sont aussi appeles oprations. Les interfaces de service Web sont dfinies

laide du langage WSDL (Web Services Description Language). Les services Web fournissent aux modules logiciels

excuts sur diffrentes plateformes une mthode conforme aux standards leur permettant dinteragir entre eux. Pour

plus dinformations sur les services Web, voir la section relative aux services Web du site World Wide Web

Consortium, www.w3.org/2002/ws/.

Les applications client peuvent interagir avec des services Web qui dfinissent leurs interfaces dans un document

WSDL, disponible en tant quURL. WSDL est un format standard permettant de dcrire les messages quun service

Web comprend, le format des rponses de ce service ces messages, les protocoles que le service Web prend en charge

et ladresse laquelle envoyer les messages.

Flex prend en charge WSDL 1.1, dcrit ladresse www.w3.org/TR/wsdl,ainsi que les services Web cods RPC et

littral document.

Il prend galement en charge les demandes et les rsultats de service Web formats en tant que messages SOAP et

transports via HTTP. SOAP fournit la dfinition du format XML que vous pouvez utiliser pour changer des

informations structures et types entre un client de service Web (une application cre avec Flex, par exemple) et un

service Web.

Vous pouvez utiliser un composant WebService pour vous connecter un service Web SOAP lorsque les services Web

constituent un standard tabli dans lenvironnement. Les composants WebService sont galement utiles pour les objets

situs dans un environnement dentreprise mais qui ne sont pas ncessairement disponibles sur le chemin source de

lapplication Web.


Web. Pour plus dinformations, voir Accs aux services Web la page 16.
http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htmhttp://www.w3.org/2002/ws/http://www.w3.org/TR/wsdlhttp://www.w3.org/TR/wsdlhttp://www.w3.org/TR/wsdlhttp://www.w3.org/2002/ws/http://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm


10/139



Composants RemoteObject

Les services dobjets distants vous permettent daccder la logique commerciale directement dans son format natif

au lieu de la formater en tant que XML, comme vous le faites avec les services Web ou de style REST. Vous conomisez

ainsi le temps ncessaire pour exposer la logique existante au format XML. Un autre avantage des services dobjets

distants rside dans la vitesse de communication travers le rseau. Les changes de donnes seffectuent encore via

HTTP ou https, mais les donnes elles-mmes sont srialises dans une reprsentation binaire. Lutilisation de

composants RemoteObject rduit le volume de donnes qui transitent sur le rseau, diminue la mmoire utilise ct

client et acclre le traitement.

ColdFusion, PHP, BlazeDS et Adobe LiveCycle Data Services peuvent utiliser une dfinition de type ct serveur lors

de laccs des donnes du serveur. Lapplication client accde un objet Java, un composant ColdFusion (qui

constitue un objet Java en interne) ou une classe PHP directement par linvocation distante dune mthode sur un

objet dsign. Lobjet sur le serveur utilise ses propres types de donnes natifs en tant quarguments, interroge une base

de donnes avec ces arguments, puis renvoie les valeurs dans leurs types de donnes natifs.

Lorsque la dfinition de type ct serveur nest pas disponible, Flash Builder dispose doutils pour implmenter la

dfinition de type ct client. Utilisez Flash Builder afin de configurer et de dfinir des types pour les donnes

renvoyes du service. La dfinition de type ct client permet lapplication client dinterroger une base de donnes etdextraire des donnes correctement types. La dfinition de type ct client est requise pour un service qui ne dfinit

pas le type de donnes renvoyes par le service.


dobjets distants. Pour plus dinformations, voir Connexion des services de donnes la page 9.


11/139

8Dernire mise jour le 18/3/2010

Chapitre 2 : Cration dapplicationscentres sur les donnes avec Flash Builder

Les outils Flash Builder peuvent vous aider crer des applications accdant des services de donnes. Commencez

par crer un projet Flex pour vos applications. Vous pouvez ensuite tablir une connexion un service de donnes,

configurer laccs aux donnes du service, puis crer une interface utilisateur pour une application. Dans certains cas,

vous devez commencer par crer linterface utilisateur, puis accder au service de donnes.

Cration dun projet Flex pour laccs des services dedonnes

Flex accde aux services de donnes en tant quobjets distants, services HTTP (style REST) ou services Web (SOAP).

Utilisez un objet distant pour accder aux types de services de donnes suivants :

Services ColdFusion

Services PHP au format AMF

BlazeDS

LiveCycle Data Services

Pour plus dinformations sur lutilisation de lassistant LiveCycle Service Discovery, voir Utilisation de LiveCycle

Discovery.

Pour tout service auquel laccs seffectue par le biais dun objet distant, crez un projet Flex configur pour le type de

serveur dapplication appropri. Lassistant de nouveau projet Flex vous guide au cours des tapes de configurationdun projet pour les types de serveurs dapplications rpertoris ci-dessous.

Vous pouvez vous connecter des services HTTP et Web partir de nimporte quel projet Flex, y compris les projets

sans technologie de serveur spcifie.

Un projet configur pour accder un objet distant peut accder uniquement un service dobjets distants pour lequel

il est configur. Par exemple, vous ne pouvez pas accder un service PHP bas sur AMF partir dun projet configur

pour ColdFusion. Cependant, vous pouvez vous connecter un service PHP partir dun tel projet si vous vous y

connectez en tant que service Web ou HTTP.

Type de serveur Services dobjets distants pris en charge

PHP Services PHP au format AMF

ColdFusion ColdFusion Flash Remoting

BlazeDS


J2EE BlazeDS

http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/


12/139

9ACCS AUX DONNES AVEC FLEXCration dapplications centres sur les donnes avec Flash Builder


Voir aussi

Prsentation de laccs aux services de donnes la page 1

Changement du type de serveur dun projetFlash Builder vous avertit si vous tentez daccder un service pour lequel aucun projet Flex nest configur. Si le projet

Flex ne spcifie pas la configuration de serveur correcte, Flash Builder fournit un lien vers la bote de dialogue

Proprits du projet. Cette bote de dialogue vous permet de configurer le projet afin daccder au service de donnes.

Flash Builder vous avertit par exemple lorsque vous tentez daccder un service PHP bas sur AMF partir dun

projet qui ne spcifie aucune configuration de serveur.

Si le projet Flex a t prcdemment configur pour laccs un autre type de service, crez un nouveau projet Flex ou

modifiez la configuration du projet actuel. En cas de modification de la configuration de serveur dun projet, vous ne

pourrez plus accder aux services prcdemment configurs. Par exemple, si vous modifiez une configuration de

projet de ColdFusion vers PHP, les services ColdFusion auxquels vous tenterez daccder dans le projet ne seront plus

disponibles.

Vous pouvez accder diffrents types de services partir du mme projet en configurant des services en tant queservices HTTP ou Web.

Fichier de rgulation interdomaines

Un fichier de rgulation interdomaines est requis pour laccs aux services se trouvant sur un autre domaine partir

du fichier SWF pour lapplication. Situs dans le mme domaine que lapplication, les services au format AMF ne

ncessitent gnralement pas de fichier de rgulation interdomaines.

Connexion des services de donnes

Utilisez lassistant de service Flash Builder pour vous connecter un service de donnes.

Pour les services dobjets distants, vous pouvez en rgle gnrale spcifier un projet Flex ayant un type de serveurs

dapplications correspondant. Flash Builder introspecte le service et peut configurer des types de retour pour les

donnes renvoyes par le service.

Les services dobjets distants incluent les services de donnes implments dans ColdFusion, PHP, BlazeDS et

LiveCycle Data Services.

Pour plus dinformations sur lutilisation de lassistant LiveCycle Service Discovery, voir Utilisation de LiveCycle

Discovery.

Voir aussi

Cration dun projet Flex pour laccs des services de donnes la page 8

Accs aux services ColdFusion

Utilisez lassistant de service Flash Builder pour accder au service de donnes ColdFusion implment en tant que

composant ColdFusion (CFC). Flex accde ces services en qualit dobjets distants.

Utilisez un projet Flex spcifiant ColdFusion comme type de serveurs dapplications. Lors de la cration du projet Flex,

activez loption Utiliser le service daccs aux objets distants et slectionnez ColdFusion Flash Remoting.
http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/http://www.adobe.com/go/learn_flex4_lcservicediscovery_fr/


13/139



Connexion des services de donnes ColdFusion

Cette procdure part du principe que vous avez implment un service ColdFusion et cr un projet Flex afin daccder

aux services ColdFusion.

1 Dans le menu Donnes de Flash Builder, slectionnez Connexion aux donnes/services pour ouvrir lassistant deconnexion un service.

2 Dans la bote de dialogue Slection dun type de service, choisissez ColdFusion. Cliquez sur Suivant.

3 Dans la bote de dialogue Configuration du service ColdFusion, recherchez lemplacement du fichier CFC qui

implmente le service.

Remarque : si vous navez pas implment de service ColdFusion, Flash Builder peut gnrer un exemple de service

partir dun tableau de base de donnes simple. Utilisez lexemple gnr en guise dillustration de laccs aux services

de donnes. Voir Gnration dun exemple de service ColdFusion partir dun tableau de base de donnes la

page 10.

4 (Facultatif) Modifiez les dtails du service.

5 (Facultatif) Cliquez sur Suivant pour afficher les oprations de service.

6 Cliquez sur Terminer pour gnrer des fichiers ActionScript qui accdent au service.

Remarque : une fois la connexion tablie, vous pouvez modifier les proprits du service. Slectionnez le service dans la

vue Donnes/Services. Dans le menu contextuel, slectionnez Proprits.

Etape suivante : Configuration des types de donnes pour les oprations de service de donnes la page 28.

Gnration dun exemple de service ColdFusion partir dun tableau de base de donnes

Flash Builder peut gnrer un exemple de service ColdFusion que vous pouvez utiliser en tant que prototype pour vos

propres services. Lexemple de service accde un tableau de base de donnes simple et dispose de mthodes de

cration, de lecture, de mise jour et de suppression.

Flash Builder configure les types de donnes de retour pour les services gnrs et active des fonctionnalits daccsaux donnes telles que la pagination ou la gestion de donnes.

Important : utilisez le service gnr uniquement dans un environnement de dveloppement fiable. Le code gnr

permet toute personne disposant dun accs rseau votre serveur daccder aux donnes du tableau de donnes et de

les modifier ou supprimer. Avant de dployer ce service, assurez-vous daugmenter la protection et de restreindre laccs

de faon adquate. Pour plus dinformations sur la rdaction de services scuriss, voir Securing Data Services.

Nom du service Spcifiez un nom pour le service.

Flash Builder gnre un nom pour le service, bas sur le nom du fichier du service.

Les noms possibles pour un service sont soumis certaines restrictions. Voir Affectation de noms aux services de donnes la page 21.

Package de services Spcifiez un nom pour le package contenant les fichiers ActionScript gnrs quiaccdent au service.

Flash Builder gnre un package bas le nom du service et le place dans unpackage de services.

Package du type de

donnes

Spcifiez un nom pour le package contenant les fichiers de classe ActionScriptgnrs qui dfinissent les types de donnes rcuprs partir du service.

Par dfaut, Flash Builder cre le package valueObjects.
http://www.adobe.com/go/flex_securityhttp://www.adobe.com/go/flex_security


14/139



La procdure suivante part du principe que vous avez cr un projet Flex pour accder aux services ColdFusion et

disposez de sources de donnes ColdFusion.

1 Dans le menu Donnes de Flash Builder, slectionnez Connexion aux donnes/services pour ouvrir lassistant de

connexion un service.

2 Dans la bote de dialogue Slection dun type de service, choisissez ColdFusion. Cliquez sur Suivant.

3 Dans la bote de dialogue Configuration du service ColdFusion, cliquez sur le lien afin de gnrer un exemple de

service.

4 Slectionnez loption Gnrer partir dune source de donnes RDS et indiquez une source de donnes et une table

ColdFusion.

Si la table ne dfinit pas de cl primaire, slectionnez-en une.

Remarque : en labsence de source de donnes ColdFusion disponible, slectionnez loption Gnrer partir dun

modle. Flash Builder rdige un exemple de composant ColdFusion (CFC) avec des oprations de service courantes.

Supprimez les marques de commentaires de certaines fonctions du CFC et modifiez les oprations pour crer un

exemple de service que vous pourrez utiliser comme prototype.

5 Utilisez lemplacement par dfaut ou spcifiez-en un nouveau. Cliquez sur OK.

Flash Builder gnre lexemple de service. Modifiez le nom du service et les emplacements de package afin de

remplacer les valeurs par dfaut.

6 (Facultatif) Cliquez sur Suivant pour afficher les oprations du service.

7 Cliquez sur Terminer.

Flash Builder gnre des fichiers ActionScript qui accdent lexemple de service. Il ouvre galement lexemple de

service dans un diteur du systme enregistr pour ldition de fichiers ColdFusion CFC.

Accs aux services PHP

Utilisez lassistant de service Flash Builder pour vous connecter un service de donnes implment sous PHP. Flexutilise le format AMF (Action Message Format) pour srialiser les donnes entre lapplication client et le service de

donnes. Flash Builder installe la structure Zend AMF pour fournir un accs aux services implments sous PHP. Voir

Installation de Zend Framework la page 21.

Accdez aux services de donnes PHP partir dun projet Flex dont le type de serveurs dapplications spcifi est PHP.

Le service de donnes doit tre disponible sous la racine Web dfinie la configuration du projet pour PHP. Placez le

service dans un rpertoire de services, comme illustr ci-dessous :

/MyServiceFolder/services

Voir aussi


Connexion des services de donnes PHP

Cette procdure part du principe que vous avez implment un service PHP et cr un projet Flex afin daccder aux

services PHP.



2 Dans la bote de dialogue Slection dun type de service, choisissez PHP. Cliquez sur Suivant.

3 Dans la bote de dialogue Configuration du service PHP, recherchez le fichier PHP implmentant le service.


15/139



Remarque : si vous navez pas implment de service PHP, Flash Builder peut gnrer un exemple de service partir

dun tableau de base de donnes simple. Utilisez lexemple gnr en guise dillustration de laccs aux services de

donnes. Voir Gnration dun exemple de service PHP partir dun tableau de base de donnes la page 12.


5 Cliquez sur Suivant pour afficher les oprations de service.

Si vous ne disposez pas de la version prise en charge de Zend Framework pour laccs aux services PHP, Flash

Builder vous invite en installer la version minimale. Voir Installation de Zend Framework la page 21.


Flash Builder gnre des fichiers ActionScript qui accdent au service.




Gnration dun exemple de service PHP partir dun tableau de base de donnes

Flash Builder peut gnrer un exemple de service PHP que vous pouvez utiliser en tant que prototype pour vos propres

services. Lexemple de service accde un tableau de base de donnes MySQL simple et dispose de mthodes de

cration, de lecture, de mise jour et de suppression.

Flash Builder configure les types de donnes de retour pour les services gnrs et active des fonctionnalits daccs

aux donnes telles que la pagination ou la gestion de donnes.

Important : utilisez le service gnr uniquement dans un environnement de dveloppement fiable. Le code gnr

permet toute personne disposant dun accs rseau votre serveur daccder aux donnes du tableau de donnes et de

les modifier ou supprimer. Avant de dployer ce service, assurez-vous daugmenter la protection et de restreindre laccs

de faon adquate. Pour plus dinformations sur la rdaction de services scuriss, voir Securing Data Services.

La procdure suivante part du principe que vous avez cr un projet Flex pour accder aux services PHP et disposez

de sources de donnes MySQL.



2 Dans la bote de dialogue Slection dun type de service, choisissez PHP. Cliquez sur Suivant.

3 Dans la bote de dialogue Configuration du service PHP, cliquez sur le lien afin de gnrer un exemple de service.


Flash Builder gnre un nom pour le service bas le nom du fichier du service.



Flash Builder gnre un package bas sur le nom du service et le place dans unpackageservices.

Package du type de

donnes


http://www.adobe.com/go/flex_securityhttp://www.adobe.com/go/flex_security


16/139



4 Slectionnez Gnrer partir dune base de donnes et spcifiez les informations de connexion la base de donnes.

Cliquez sur Connexion la base de donnes.

Remarque : en labsence de source de donnes PHP disponible, slectionnez loption Gnrer partir dun modle.

Flash Builder rdige un exemple de projet avec des oprations de service courantes. Supprimez les marques de

commentaires de certaines zones du projet et modifiez les oprations pour crer un exemple de service que vous

pourrez utiliser comme prototype.

5 Slectionnez un tableau dans la base de donnes et spcifiez la cl primaire.

6 Utilisez lemplacement par dfaut ou spcifiez-en un nouveau. Cliquez sur OK.

Si vous ne disposez pas de la version prise en charge de Zend Framework pour laccs aux services PHP, Flash

Builder vous invite en installer la version minimale. Voir Installation de Zend Framework la page 21.

Flash Builder gnre lexemple de service. Modifiez le nom du service et les emplacements de package afin de

remplacer les valeurs par dfaut.

7 (Facultatif) Cliquez sur Suivant pour afficher les oprations du service.

8 Cliquez sur Terminer.Flash Builder gnre des fichiers ActionScript qui accdent lexemple de service. Il ouvre galement lexemple de

service dans un diteur du systme enregistr pour ldition de fichiers PHP.

Accs aux services HTTP

Utilisez lassistant de service Flash Builder pour vous connecter aux services HTTP. Vous pouvez vous connecter des

services HTTP partir de nimporte quel projet Flex. Il nest pas ncessaire de spcifier une technologie de serveur

pour le projet.

Un fichier de rgulation interdomaines est requis pour laccs aux services dont le domaine ne correspond pas celui

du fichier SWF de lapplication client. Voir Utilisation de fichiers de rgulation interdomaines.

Configuration des services HTTP

Il existe plusieurs faons de configurer laccs aux services HTTP. Lassistant de configuration du service HTTP prend

en charge les options suivantes.

URL de base en tant que prfixe

Cette option savre pratique pour accder plusieurs oprations partir dun service unique. Si vous spcifiez une

URL de base vers le service, il vous suffit ensuite de spcifier pour chaque opration le chemin relatif vers les

oprations HTTP.

Lutilisation dune URL de base ne permet pas daccder plusieurs services.

URL avec paramtres de requte

Lors de la spcification dune URL vers une opration, vous pouvez inclure les paramtres de requte pour les

oprations de service. Lassistant de configuration du service HTTP renseigne le tableau Paramtres avec chaque

paramtre inclus dans lURL de lopration.

Services RESTful

Flash Builder prend en charge laccs aux services RESTful qui utilisent des paramtres dlimits au lieu du

paramtre de requte GET. Par exemple, supposons que vous utilisez lURL suivante pour accder un service

RESTful :

http://restfulService/items/itemID


17/139



Utilisez des accolades ({}) pour spcifier les paramtres de lURL de lopration, comme lillustre lexemple

suivant :

http://restfulService/{items}/{itemID}

Lassistant de configuration du service HTTP renseigne ensuite le tableau Paramtres.

Lorsque vous spcifiez des paramtres pour un service RESTful, Type de donnes et Type de paramtre sont

toujours configurs en tant que String et URL respectivement.

Remarque : vous pouvez associer des paramtres de service RESTful avec des paramtres de requte lors de la

spcification de lURL vers une opration.

Chemin vers un fichier local pour une URL dopration

Pour une URL dopration, vous pouvez spcifier un chemin vers un fichier local qui implmente les services

HTTP. Par exemple, spcifiez ce qui suit pour une URL dopration :

c:/MyHttpServices/MyHttpService.xml

Ajout doprations GET et POST

Vous pouvez ajouter des oprations supplmentaires lors de la configuration dun service HTTP. Cliquez sur le

bouton Ajouter du tableau Oprations.

Spcifiez la mthode de lopration (GET ou POST).

Ajout de paramtres une opration

Vous pouvez ajouter des paramtres lopration que vous aurez pralablement slectionne dans le tableau

Oprations. Slectionnez une opration, puis cliquez sur le bouton Ajouter du tableau Paramtres.

Spcifiez un nom et un type de donnes pour le paramtre ajout. Le type de paramtre (GET ou POST) correspond

la mthode de lopration.

Type de contenu pour les oprations POST

Pour les oprations POST, vous pouvez spcifier le type de contenu. Il peut sagir de application/x-www-form-

urlencodedou de application/xml .

Si vous slectionnez application/xml comme type de contenu, Flash Builder gnre un paramtre de requte non

modifiable, dont le nom par dfaut est strXML. Vous pourrez spcifier le paramtre actuel lexcution.

Vous ne pouvez pas ajouter de paramtres supplmentaires pour le type de contenu application/xml.

Connexion des services HTTP



2 Dans la bote de dialogue Slection dun type de service, choisissez HTTP. Cliquez sur Suivant.

Nom Type de donnes Type de paramtre

items String URL

itemID String URL

Nom Type de donnes Type de paramtre

strXML String POST


18/139



3 (Facultatif) Spcifiez une URL de base utiliser en tant que prfixe pour toutes les oprations.

4 Sous Oprations, spcifiez les lments suivants pour chaque opration laquelle vous souhaitez accder :

Mthode de lopration (GET ou POST)

URL de lopration de service

Vous pouvez inclure dans lURL nimporte quel paramtre dopration. Utilisez des accolades ({}) pour

spcifier des paramtres de service de style REST.

Flash Builder prend en charge laccs aux protocoles suivants :

http://

https://

Chemins daccs standard tels que C:/ou /Applications/

Nom de lopration

5 Spcifiez le nom et le type de donnes de chaque paramtre dopration de lURL slectionne.

6 (Facultatif) Cliquez sur Ajouter ou Supprimer pour ajouter ou supprimer des paramtres pour lopration

slectionne.


8 (Facultatif) Modifiez le nom du package gnr pour le service.



Une fois la connexion au service HTTP tablie, configurez les types de retour des oprations de service. Lors de la

configuration du type de retour, les types de paramtres de lopration sont galement configurs. Voir

Configuration des types de donnes pour les oprations de service de donnes la page 28.




Accs un fichier XML implmentant des services HTTP

Vous pouvez accder un fichier XML statique qui implmente un service HTTP. Ce fichier XML statique peut tre

un fichier local ou tre disponible sous la forme dune URL.


Flash Builder gnre un nom pour le service, bas le nom du fichier du service.



Flash Builder gnre un package bas sur le nom du service et le place dans un

packageservices.

Package du type de

donnes




19/139



Le service utilise une mthode GET qui renvoie une rponse XML. Cette fonctionnalit est utile pour apprendre

connatre les services HTTP dans Flex et pour tablir des prototypes de donnes fictives dans les applications client.

Lors de laccs au service, spcifiez le nud renvoyant la rponse XML. Flash Builder utilise ce nud pour configurer

automatiquement un type de retour pour les donnes. Une fois la connexion au service tablie, vous pouvez lier des

oprations du service des composants dinterface utilisateur.

Connexion un fichier de service XML



2 Dans la bote de dialogue Slection dun type de service, slectionnez XML. Cliquez sur Suivant.

3 Spcifiez Fichier local ou URL, puis accdez au fichier.

4 Slectionnez un nud dans le fichier contenant la rponse souhaite.

Indiquez si la rponse est un tableau Array.

Flash Builder configure un type de retour pour le nud slectionn.

5 Modifiez les dtails du service.

6 (Facultatif) Modifiez le nom du package gnr pour le service.





Accs aux services Web

Utilisez lassistant de service Flash Builder pour vous connecter aux services Web (SOAP). Vous pouvez vousconnecter des services Web partir de nimporte quel projet Flex. Il nest pas ncessaire de spcifier une technologie

de serveur pour le projet.

Un fichier de rgulation interdomaines est requis pour laccs aux services se trouvant sur un autre domaine partir

du fichier SWF pour lapplication client.

Voir aussi

Using cross-domain policy files


Flash Builder gnre un nom pour le service, bas le nom du fichier du service.




Package du type de

donnes

Spcifiez un nom pour le package contenant les fichiers de classe ActionScript

gnrs qui dfinissent les types de donnes rcuprs partir du service.

http://livedocs.adobe.com/flex/3/html/security2_04.htmlhttp://livedocs.adobe.com/flex/3/html/security2_04.html


20/139



Connexion des services Web



2Dans la bote de dialogue Slection dun type de service, choisissez Service Web (WSDL). Cliquez sur Suivant.

3 (LiveCycle Data Services/BlazeDS) Si vous avez install LiveCycle Data Services ou BlazeDS, vous pouvez accder

au service Web via un proxy.

Slectionnez loption Par une destination proxy LCDS/BlazeDS.

Spcifiez une destination. Cliquez sur Suivant et passez ltape 5.

Remarque : loption daccs aux services Web via un proxy LiveCycle Data Services est active uniquement si le type

de serveurs dapplications spcifi pour le projet Flex est J2EE.

4 Saisissez un URI pour le service SOAP.


6 (Facultatif) Configurez la gnration de code pour le service.





Une fois la connexion au service Web tablie, configurez les types de retour des oprations de service. Pour plus

dinformations, voir Configuration des types de donnes pour les oprations de service de donnes la page 28.

Accs BlazeDS

Vous pouvez accder aux services BlazeDS uniquement si vous avez install Adobe BlazeDS et configur un serveur

RDS (Remote Development Services). Pour plus dinformations sur linstallation et la configuration de BlazeDS, voir

la documentation dAdobe LiveCycle Data Services ES.

Nom du service Spcifiez un nom pour le service.Flash Builder gnre un nom pour le service bas sur lURI WSDL.




Package du type de

donnes


Par dfaut, Flash Builder cre le package dataValues.

Service

Port

Slectionnez lun des services disponibles.

Flash Builder gnre un nom pour le service bas sur lURI WSDL.

Liste doprations Slectionnez les oprations du service auquel vous souhaitez accder dans votreapplication client.


21/139



En rgle gnrale, vous accdez aux services de donnes BlazeDS partir dun projet Flex dont le type de serveurs

dapplications spcifi est J2EE.

Voir aussi


Connexion des services BlazeDS

Cette procdure part du principe que vous avez install BlazeDS, configur un serveur de dveloppement distant et

cr un projet Flex afin daccder aux services BlazeDS.



2 Dans la bote de dialogue Slection dun type de service, choisissez BlazeDS. Cliquez sur Suivant.

3 Slectionnez une destination importer.






Accs Adobe LiveCycle Data Services

Vous pouvez accder aux services disponibles partir de LiveCycle Data Services uniquement si vous avez install

Adobe LiveCycle Data Services ES et configur un serveur RDS (Remote Development Services). Pour plus

dinformations sur linstallation et la configuration de LiveCycle Data Services, voir la documentation Adobe

LiveCycle Data Services ES.

Vous pouvez accder LiveCycle Data Services partir dun projet Flex dont le type de serveurs dapplications spcifi

est soit J2EE soit ColdFusion.


Flash Builder gnre un nom pour le service bas sur la destination.




Package du type de

donnes




22/139



Types de service pour LiveCycle Data Services

Lors de la connexion LiveCycle Data Services, les types de services de donnes suivants sont disponibles en tant que

destinations.

Service distantLes services distants sont implments laide de la dfinition de types AMF. Ils ne fournissent aucune gestion de

donnes ct serveur. Vous pouvez utiliser les outils Flash Builder pour configurer la gestion de donnes ct client.

Voir Activation de la gestion des donnes la page 35.

Service de donnes

Les services de donnes implmentent la gestion de donnes ct serveur. Pour plus dinformations, reportez-vous

la documentation LiveCycle Data Services.

Service Web

Les services Web sont disponibles par le biais dun proxy LiveCycle configur en tant que destination LiveCycle Data

Services. La dfinition de type ct serveur nest gnralement pas fournie lors de la connexion un service Web.

Configuration et gestion de types de donnes

Flash Builder fournit des outils pour la configuration et la gestion des donnes ct client. Les outils Flash Builder

disponibles dpendent du type de destination LiveCycle Data Services.

Service distant

Les services distants implmentent la dfinition de types AMF sur le service. Il nest pas ncessaire de configurer

des types de donnes de retour pour les destinations de service distant.

Cependant, vous pouvez utiliser Flash Builder pour gnrer du code pour la gestion de donnes ct client. Voir

Activation de la gestion des donnes la page 35.

Service de donnes

Les services de donnes implmentent les types de donnes ct serveur. Il nest pas ncessaire de configurer destypes de donnes de retour pour les destinations de service de donnes.

Les destinations de service de donnes fournissent galement la gestion des donnes ct serveur. Vous ne pouvez

pas utiliser la gestion des donnes ct client avec les destinations de service de donnes.

Service Web

En rgle gnrale, les destinations de service Web disponibles par le biais dun proxy LiveCycle Data Service

nimplmentent pas la dfinition de type ct serveur. Vous pouvez utiliser les outils Flash Builder pour configurer

des types de retour pour les oprations de service Web. Voir Configuration des types de donnes pour les

oprations de service de donnes la page 28.

Vous pouvez utiliser Flash Builder pour gnrer du code pour la gestion des donnes ct client. Voir Activation

de la gestion des donnes la page 35.

Connexion aux destinations LiveCycle Data Service (destinations de service de donnes etde service distant)

Cette procdure part du principe que vous avez install LiveCycle Data Services, configur un serveur de

dveloppement distant et cr un projet Flex pour laccs aux services LCDS.




23/139



2 Dans la bote de dialogue Slection dun type de service, choisissez LCDS. Cliquez sur Suivant.

3 Saisissez votre identifiant de connexion, le cas chant.






Connexion aux destinations LiveCycle Data Service (destinations de service Web)

Cette procdure part du principe que vous avez install LiveCycle Data Services, configur un serveur de

dveloppement distant et cr un projet Flex afin daccder aux services LCDS.



2 Dans la bote de dialogue Slection dun type de service, choisissez Service Web. Cliquez sur Suivant.

3 Slectionnez loption Par une destination proxy LCDS/BlazeDS.

4 Saisissez votre identifiant de connexion, le cas chant.

5 Slectionnez la destination.

6 (Facultatif) Modifiez les dtails du service. Cliquez sur Suivant.

Nom du service Nindiquez aucun nom de service. Flash Builder gnre un nom de service. Ilgnre un nom pour le service bas sur la destination.



Destinations Spcifiez une ou plusieurs destinations disponibles partir du serveur LiveCycleData Services.

Package du type de

donnes

Spcifiez un nom pour le package de type de donnes. Ce package contient lesfichiers de classe ActionScript gnrs qui dfinissent les types de donnesrcuprs partir du service.



Flash Builder gnre un nom pour le service bas sur le nom de la destination.




Package du type de

donnes


Par dfaut, Flash Builder cre le package dataValues.


24/139


25/139



Serveurs de production

Pour les serveurs de production, Adobe vous recommande de dplacer le dossier ZendFrameworkhors de la racine

Web. Mettez jour la variable zend_pathdfinie dans le fichier amf_config.ini.

Si la variable zend_pathest commente, supprimez-en le commentaire. Spcifiez lemplacement de linstallation ZendFramework.

Installation manuelle de Zend Framework

Vous avez la possibilit dinstaller manuellement Zend Framework.

1 Tlchargez la dernire version de Zend Framework.

Vous pouvez installer le package minimal ou le package complet. Flash Builder installe le package minimal.

2 Extrayez la version tlcharge dans un emplacement du systme.

3 Dans le dossier du projet Flex permettant daccder aux services PHP, mettez jour la variable zend_pathdfinie

dans le fichier amf_config.ini.

Si la variable zend_pathest commente, supprimez-en le commentaire. Spcifiez le chemin absolu vers

lemplacement de linstallation Zend Framework.

Dpannage dune installation Zend Framework

Voici quelques conseils pour rsoudre les erreurs susceptibles de survenir lors de la connexion Zend Framework.

Installation manuelle de Zend Framework

Si vous avez install manuellement Zend Framework, examinez la variable zend_path dans le fichier amf_config.ini.

Le fichier amf_config.inise trouve dans le dossier de sortie du projet.

Vrifiez ce qui suit : Zend_amf nest pas comment.

Le chemin spcifi vers votre installation Zend Framework est correct :

Il sagit dun chemin absolu vers une destination situe sur le systme de fichiers local. Vous ne pouvez passpcifier un chemin vers une ressource rseau mappe.

Le chemin mne au dossier de bibliothque de linstallation Zend Framework. Habituellement, le dossier debibliothque est situ dans les emplacements suivants :

(Windows) C:\apache\PHPFrameworks/ZendFramework/library

(Mac OS) /utilisateur/apache/PHP/frameworks/ZendFramework/library

Installation de Zend Framework par Flash BuilderSi Zend Framework a t install par Flash Builder, vrifiez ce qui suit :

Lemplacement du dossier racine Web

Flash Builder installe Zend Framework dans le dossier racine Web du projet. Vrifiez-en lemplacement.

Slectionnez Projet > Proprits > Serveur Flex.

La variable zend_path du fichier amf_config.ini

Le fichier amf_config.inise trouve dans le dossier de sortie du projet.
http://framework.zend.com/download/latesthttp://framework.zend.com/download/latest


26/139



Vrifiez ce qui suit :

zend_amfnest pas comment.

Le chemin spcifi pointe vers linstallation Zend Framework la racine Web du projet.

Il sagit dun chemin absolu vers une destination situe sur le systme de fichiers local. Vous ne pouvez passpcifier un chemin vers une ressource rseau mappe.

Utilisation dune occurrence de serveur unique

Une fois la connexion un service de donnes tablie, chaque application dun projet peut accder ce service. Par

dfaut, chaque application cre sa propre occurrence de service lorsquelle accde au serveur.

Vous pouvez modifier ce comportement de sorte quun projet ne comporte quune seule occurrence de service.

Chaque application dans le projet accde la mme occurrence de service. En rgle gnrale, vous crez une

occurrence de serveur unique lorsque vous souhaitez coordonner laccs aux donnes partir dapplications multiples.

Vous pouvez spcifier laccs une seule occurrence de service par projet ou en tant que prfrence pour tous les

projets.

Accs une occurrence de serveur unique pour un projet

1 Cliquez sur Projet > Proprits > Donnes/Services.

2 Slectionnez la case cocher pour lutilisation dune occurrence de serveur unique. Cliquez sur OK.

Spcification dune occurrence de serveur unique en tant que prfrence

1 Ouvrez la bote de dialogue Prfrences.

2 Slectionnez Flash Builder > Donnes/Services.3 Slectionnez la case cocher pour lutilisation dune occurrence de serveur unique. Cliquez sur OK.

Gnration de lapplication client

Utilisez lditeur MXML pour crer une interface utilisateur. Vous pouvez utiliser lditeur en mode Cration ou en

mode Source.

Aprs avoir dispos les composants pour lapplication, liez les donnes renvoyes par le service aux composants de

linterface utilisateur. Gnrez des gestionnaires dvnement en fonction des interactions de lutilisateur avec

lapplication.

Vous pouvez aussi gnrer un formulaire partir des oprations de service disponibles dans la vue Donnes/Services.

Utilisation du mode Cration pour gnrer une application

Flex fournit un riche ensemble de conteneurs et de contrles que vous pouvez utiliser pour crer une interface

utilisateur. Un conteneur offre une structure hirarchique pour organiser et prsenter linterface utilisateur. Il peut

contenir dautres conteneurs, navigateurs, contrles et composants.


27/139



Les contrles de base sont les lments de linterface utilisateur, par exemple Button, TextArea et CheckBox. Les

contrles orients donnes, tels que les composants DataGrid et List, sont idaux pour laffichage des donnes

obtenues partir dun service. Les navigateurs sont des conteneurs qui contrlent les mouvements de lutilisateur par

le biais de conteneurs enfant, par exemple les ensembles de tabulation.

En mode Cration de lditeur MXML, faites glisser des conteneurs et des contrles partir de la vue Composants et

dposez-les dans la zone de cration. Agencez ensuite les composants et configurez-en les proprits. Une fois dfinie

la prsentation de lapplication, reliez aux composants les donnes renvoyes par le service de donnes.

Liaison doprations de service des contrles

Plusieurs mthodes permettent de lier des oprations de service un composant dinterface utilisateur. Vous pouvez

faire glisser une opration de service de la vue Donnes/Services vers un composant dans la zone de cration. Vous

pouvez aussi ouvrir la bote de dialogue Lier aux donnes pour slectionner une opration lier un composant.

La bote de dialogue Lier aux donnes est disponible partir de la barre doutils dans la vue Donnes/Services. Elle est

galement disponible en mode Cration de lditeur MXML lorsque vous slectionnez un composant qui accepte les

donnes, tel que DataGrid. Slectionnez le composant et ouvrez la bote de dialogue Lier aux donnes partir de sonmenu contextuel. La bote de dialogue Lier aux donnes peut galement tre ouverte partir du champ Fournisseur de

donnes dans la vue Proprits.

Lorsque vous liez une opration de service un composant, Flash Builder gnre du code MXML et ActionScript pour

accder lopration de service partir de lapplication client.

Types de retour pour les oprations de service

Lorsque vous liez une opration de service un contrle, Flash Builder utilise le type des donnes renvoyes par

lopration. En rgle gnrale, vous configurez le type de retour pour une opration de service avant de la lier un

composant.

Si le type de retour dune opration de service na pas t configur, la bote de dialogue Lier aux donnes vous invite

terminer cette tape.Voir Configuration des types de donnes pour les oprations de service de donnes la page 28.

Liaison dune opration de service un contrle DataGrid (glisser-dposer)

Cette procdure part du principe que vous tes connect un service de donnes.

1 En mode Cration de lditeur MXML, faites glisser un composant DataGrid partir de la vue Composants et

dposez-le dans la zone de cration.

2 Faites glisser une opration de la vue Donnes/Services vers le composant DataGrid.

Si le type de retour de lopration a t pralablement configur, Flash Builder lie lopration au composant

DataGrid. Le composant DataGrid change pour afficher les champs extraits de la base de donnes.

Si le type de retour de lopration na pas t configur, Flash Builder ouvre la bote de dialogue Lier aux donnes.Voir Liaison dun contrle DataGrid une opration de service (bote de dialogue Lier aux donnes) la

page 25.

3 Personnalisez laffichage du composant DataGrid.

Voir Configuration de composants DataGrid et AdvancedDataGrid.

4 Enregistrez et excutez lapplication.


28/139



Liaison dun contrle DataGrid une opration de service (bote de dialogue Lier auxdonnes)


1 En mode Cration de lditeur MXML, faites glisser un composant DataGrid partir de la vue Composants etdposez-le dans la zone de cration.

2 Une fois le composant DataGrid slectionn, ouvrez la bote de dialogue Lier aux donnes en utilisant lune des

mthodes suivantes :

Slectionnez Lier aux donnes partir du menu Donnes de Flash Builder, du menu contextuel du composantDataGrid ou de la barre doutils de la vue Donnes/Services.

Dans la vue Proprits, slectionnez le bouton Lier aux donnes (disponible en regard du champ Fournisseur dedonnes).

3 Slectionnez Nouvel appel de service, puis un service et une opration.

Si vous avez li une opration de service un composant, vous pouvez utiliser ces rsultats. Dans ce cas, spcifiez

Rsultat dappel existant et slectionnez lopration utiliser.

4 (Facultatif) Slectionnez Modifier type de retour.

Slectionnez Modifier type de retour si vous voulez reconfigurer le type de retour pour lopration de service.

Si le type de retour de lopration na pas t prcdemment configur, slectionnez Configurer le type de retour.

Voir Configuration des types de donnes pour les oprations de service de donnes la page 28.

5 Cliquez sur OK.

Le composant DataGrid change pour afficher les champs extraits de la base de donnes.

Voir Configuration de composants DataGrid et AdvancedDataGrid.

6 Enregistrez et excutez lapplication.

Gnration dun appel de service une opration

Flash Builder peut gnrer une mthode ActionScript qui appelle une opration de service. Cette mthode nest pas

lie un composant dinterface utilisateur, mais peut tre utilise dans le code de lapplication.

Outre la mthode ActionScript, Flash Builder gnre une proprit CallResponder donnant accs aux donnes

renvoyes partir de lappel de service. Voir CallResponder la page 40.

Gnration dun appel de service une opration


1 Dans la vue Donnes/Services, slectionnez une opration.

2 Dans le menu contextuel de lopration, slectionnez Gnrer lappel de service.

Flash Builder gnre une mthode pour appeler lopration et affiche la mthode gnre en mode Source dans

lditeur MXML. Il cre une proprit CallResponder qui contient le rsultat de lappel de service.

Cette option est galement disponible partir de la barre doutils Donnes/Services.


29/139



Cration dun formulaire pour une application

Les formulaires sont lune des mthodes les plus courantes que les applications Web utilisent pour recueillir des

informations des utilisateurs. Flash Builder peut gnrer des formulaires pour les donnes obtenues partir des appels

de service ou pour les types de donnes personnaliss utiliss pour accder aux donnes distantes.

Lors de la gnration dun formulaire, Flash Builder cre un conteneur de prsentation Form et ajoute des composants

afin dafficher ou de modifier les donnes spcifiques rcupres partir du service.

Flash Builder gnre les types de formulaires suivants.

Lors de la gnration dun formulaire, dfinissez les champs inclure, spcifiez le type du contrle dinterface

utilisateur utilis pour reprsenter chaque champ et indiquez si le formulaire est modifiable ou non.

Cration dun formulaire

Cette procdure indique comment gnrer un formulaire pour un appel de service. Les procdures pour gnrer dautres

types de formulaires sont similaires. Cette procdure suppose que vous soyez en mode Cration de lditeur MXML.

1 Plusieurs mthodes permettent dexcuter lassistant de gnration dun formulaire. Dans la vue Donnes/Services,

slectionnez une opration :

Dans le menu contextuel de lopration, slectionnez Gnrer le formulaire.

Dans le menu Donnes de Flash Builder, slectionnez Gnrer le formulaire.

Faites glisser lopration de la vue Donnes/Services vers un composant Form dans la zone de cration.

2 Dans lassistant Gnrer le formulaire, slectionnez Appel de service dans le champ Gnrer le formulaire pour.

3 Slectionnez Nouvel appel de service ou Rsultat dappel existant.

Spcifiez Rsultat dappel existant pour utiliser le code gnr prcdemment pour un appel de service.

Sinon, activez Nouvel appel de service et slectionnez un service et une opration pour le formulaire.

4 (Facultatif) Les options disponibles sur le formulaire gnr varient en fonction de lopration.

Si lopration accepte les paramtres, vous pouvez choisir dinclure un formulaire pour les paramtres.

Si lopration renvoie une valeur, vous pouvez choisir dinclure un formulaire pour la valeur renvoye.

Vous pouvez choisir de rendre le formulaire modifiable ou de le rendre uniquement accessible en lecture.

5 (Facultatif) Configurez les types dentre et les types de retour.

Si lopration slectionne dispose de paramtres dentre ou renvoie une valeur, vous pouvez configurer le type

dentre ou le type de retour.

Formulaire Description

Type de donnes Ce formulaire contient les composants reprsentant les champs duntype de donnes.

Dtail des donnes principales Le composant principal correspond en rgle gnrale uncontrle de donnes rpertoriant les donnes obtenues dun service.

Le formulaire dtaill reprsente des lments individuelsslectionns dans le composant principal.

Appel de service Crez deux formulaires. Le premier spcifie les entres duneopration. Le second affiche les donnes renvoyes.


30/139



Pour pouvoir gnrer le formulaire, vous devez configurer les types dentre et de retour de lopration. Si vous les

avez dj configurs prcdemment, vous avez ici la possibilit de les configurer nouveau.

Voir Configuration des types de donnes pour les oprations de service de donnes la page 28.

6 Cliquez sur Suivant. Dans la bote de dialogue Mappage de contrle de proprit, slectionnez les champs incluredans le formulaire et le type de contrle pour reprsenter les donnes.


8 Dans la zone de cration, rorganisez les formulaires gnrs.

Les formulaires gnrs par Flash Builder peuvent tre superposs. Slectionnez un formulaire et faites-le glisser

vers un emplacement adquat.

Utilisez le mode Source pour vous assurer davoir bien slectionn et dplac un formulaire et non un composant

de ce dernier. La slection de formulaires superposs peut en effet savrer difficile. En mode Source, slectionnez

la balise correspondant un formulaire. Basculez en mode Cration : ce formulaire est maintenant slectionn.

Gnration dun formulaire de dtails

Pour gnrer un formulaire de dtails, ajoutez un composant de contrle de donnes lapplication et liez les rsultats

dune opration au contrle.

Ajoutez par exemple un composant DataGrid, puis liez ce composant les rsultats dune opration telle que

getItems_paged() .

1 En mode Cration, slectionnez un contrle de donnes tel que DataGrid.

2 Dans le menu Donnes, slectionnez Gnrer le formulaire de dtails.

3 Gnrez le formulaire en suivant les instructions founies dans le paragraphe Cration dun formulaire.

Cration dun formulaire pour un type de donnes

Pour gnrer un formulaire avec des composants reprsentant les champs dun type de donnes personnalis,

commencez par configurer le type de donnes. Voir Configuration des types de donnes pour les oprations de

service de donnes la page 28.

1 Dans la vue Donnes/Services, slectionnez un type de donnes personnalis.

2 Dans le menu contextuel, slectionnez Gnrer le formulaire.

3 Assurez-vous que loption Gnrer le formulaire pour Type de donnes est slectionne, puis choisissez un type de

donnes.

4 (Facultatif) Rendez le formulaire modifiable si vous le souhaitez.


Gnration de gestionnaires dvnement pour lextraction de donnesdistantes

Lorsque vous reliez une opration de service de donnes un composant, Flash Builder cre un gestionnaire

dvnement qui renseigne le composant avec les donnes extraites du service.

Par exemple, si vous reliez une opration getAllItems() un DataGrid, Flash Builder gnre un gestionnaire

dvnement creationComplete. Le composant DataGrid rfrence le gestionnaire dvnements gnr. Les

rsultats de lappel deviennent le fournisseur de donnes du composant DataGrid.


31/139



. . .

protected function dataGrid_creationCompleteHandler(event:FlexEvent):void

{

getAllItemsResult.token = productService.getAllItems();

}

. . .

. . .

. . .

Lorsque vous excutez lapplication, le gestionnaire dvnement renseigne le composant DataGrid cr avec les

donnes extraites du service.

Lorsque vous crez des gestionnaires dvnement, vous pouvez accepter les gestionnaires crs ou les remplacer par

des gestionnaires adapts vos besoins. Vous pouvez par exemple remplacer le gestionnaire dvnement

creationComplete sur DataGrid par un gestionnaire creationComplete sur Application.

Vous pouvez galement gnrer ou crer des gestionnaires dvnement pour des contrles acceptant les interactionsavec lutilisateur, par exemple les contrles Button et Text.

Cration dun gestionnaire dvnement pour un composant dinterface utilisateur

1 Crez une application contenant un composant dinterface utilisateur tel que DataGrid ou Button.

2 Passez en mode Cration de lditeur MXML.

Utilisez lune des mthodes suivantes :

A partir de la vue Donnes/Services, faites glisser une opration sur un composant dinterface utilisateur.

Slectionnez le composant dinterface utilisateur, puis cliquez sur licne de gnration dun gestionnairedvnement dans la vue Proprits. Slectionnez Gnrer le gestionnaire dvnement.

Flash Builder cre un gestionnaire pour lvnement par dfaut du composant. Pour un bouton par exemple, legestionnaire dvnement est lvnement Click.

Flash Builder passe en mode Source de lditeur et met en vidence le stub gnr pour le gestionnaire

dvnement.

Compltez le code restant pour le gestionnaire dvnement. Flash Builder comporte un assistant de contenu

facilitant le codage du gestionnaire dvnement.

Configuration des types de donnes pour les oprationsde service de donnes

Lors de la connexion un service de donnes, Flash Builder doit connatre le type des donnes renvoyes par une

opration de service. Les types de donnes pris en charge sont ceux reconnus par AMF pour changer des donnes

avec un service de donnes ou un service distant.

De nombreux services de donnes dfinissent le type des donnes renvoyes sur le serveur (dfinition de type ct

serveur). Toutefois, si le serveur ne dfinit pas le type, lapplication client doit configurer le type des donnes renvoyes

(dfinition de type ct client).


32/139



Les oprations de service qui spcifient les paramtres doivent galement spcifier un type correspondant aux donnes

auxquelles le service permet daccder. La dfinition de type ct client permet de configurer le type des paramtres

dentre.

Lors de la configuration des types pour la dfinition de type ct client, Flash Builder reconnat uniquement les types

de donnes AMF. Le type peut galement tre un type de donnes personnalis reprsentant des donnes complexes

ou un type vide pour indiquer que lopration ne renvoie aucune donne.

Vous pouvez configurer des types dfinis par lutilisateur pour les oprations de service qui renvoient des donnes

complexes. Si vous rcuprez par exemple des enregistrements dune base de donnes demploys, vous allez dfinir le

retour de donnes complexes comme Employ. Dans ce cas, le type de donnes personnalis pour Employ contient

des entres pour chaque champ de lenregistrement de base de donnes.

Types de donnes pour la dfinition de type ct client

Type dfini par lutilisateur (Employ)

Type de donnes Description

Types ActionScript Boolean

Boolean[]ByteArray

ByteArray[]

Date

Date[]

int

int[]

Number

Number[]

Object

Object[]

String

String[]

Aucune donnerenvoye

void

Type dfini parlutilisateur

CustomType

CustomType[]

Champ Type de donnes

emp_no Number

first_name String

last_name String

hire_date Date

birth_date Date


33/139



Authentification de laccs aux services

Les services de donnes ncessitent gnralement une authentification de lutilisateur avant dautoriser laccs aux

services. Les services PHP, BlazeDS et ColdFusion donnant accs laide du protocole HTTP peuvent requrir une

authentification supplmentaire. Dans certains cas, ces types de services ncessitent une authentification HTTP et une

authentification distante.

Flash Builder offre une option dauthentification du service lorsque vous effectuez les oprations suivantes :

Configuration du type de retour pour une opration

Voir Configuration du type de retour pour les donnes dune opration la page 31.

Utilisation de linterface Opration de test

Voir Test des oprations de service la page 33.

Lorsque vous slectionnez loption Authentification requise, Flash Builder ouvre la bote de dialogue Authentification

des services. Suivant le type de service auquel vous accdez, vous pouvez choisir lauthentification de base ou

lauthent

flex 4 accessingdata

Documents