Classe WebService
Nom de classe ActionScript mx.services.WebService
La classe WebService fait partie du package mx.services et est utilisée avec les classes Log, PendingCall et SOAPCall. Pour obtenir une vue d'ensemble des classes du package mx.services, reportez-vous à Classes de service Web.
|
REMARQUE |
|
La classe WebService est prise en charge uniquement si vous travaillez dans un document spécifiant ActionScript 2.0 dans ses paramètres de publication. |
La classe WebService est différente de la classe WebServiceConnector. La classe WebServiceConnector fournit une interface ActionScript au composant visuel WebServiceConnector.
L'objet WebService agit comme référence locale à un service Web distant. Lorsque vous créez un objet WebService, le fichier WSDL de définition du service Web est téléchargé, analysé et placé dans l'objet. Vous pouvez alors appeler les méthodes du service Web directement sur l'objet WebService et gérer tous les rappels en provenance du service Web. Lorsque le fichier WSDL a été traité et que l'objet WebService est prêt, le rappel WebService.onLoad est invoqué. S'il survient un problème au cours du chargement du fichier WSDL, le rappel WebService.onFault est invoqué.
Lorsque vous appelez une méthode sur un objet WebService, la valeur renvoyée est un objet de rappel. Le type d'objet du rappel renvoyé à partir de toutes les méthodes du service Web est PendingCall. Habituellement, ces objets ne sont pas construits par vous. Ils sont générés automatiquement, suite à la méthode webServiceObject.webServiceMethodName() appelée. Ces objets ne résultent pas de l'appel WebService qui a lieu par la suite. L'objet PendingCall représente l'appel en cours. Lorsque l'opération WebService se termine (quelques secondes après l'appel d'une méthode généralement), les différents champs de données PendingCall sont renseignés et le rappel PendingCall.onResult ou PendingCall.onFault que vous fournissez est appelé. Pour plus d'informations sur l'objet PendingCall, reportez-vous à Classe PendingCall.
Flash Player met en file d'attente tous les appels effectués avant l'analyse du fichier WSDL et tente de les exécuter après l'analyse. En effet, le fichier WSDL contient des informations nécessaires à un codage correct et à l'envoi d'une requête SOAP. Les appels de fonction que vous effectuez après analyse du fichier WSDL n'ont pas besoin d'être placés dans la file d'attente ; ils sont exécutés immédiatement. Si un appel mis en file d'attente ne correspond pas au nom de l'une des opérations définies dans le fichier WSDL, Flash Player renvoie une erreur vers l'objet de rappel que vous avez reçu lorsque vous avez lancé votre appel.
L'API WebServices, incluse dans le package mx.services, est constituée des classes WebService, Log et PendingCall.
Afin de rendre les classes de service Web disponibles lors de l'exécution, le composant WebServiceConnector doit se trouver dans la bibliothèque de votre fichier FLA. Si vous utilisez ActionScript uniquement pour accéder à un service Web lors de l'exécution, vous devez ajouter ce composant manuellement à la bibliothèque de votre document.
Méthodes de l'objet WebService
Le tableau suivant répertorie les méthodes de l'objet WebService.
|
Méthode |
Description |
|---|---|
|
Obtient l'objet SOAPCall pour une opération donnée. |
|
|
Invoque une opération spécifique du service Web définie |
Rappels de l'objet WebService
Le tableau suivant répertorie les rappels de l'objet WebService.
|
Rappel |
Description |
|---|---|
|
Appelé lorsqu'une erreur se produit au cours de l'analyse WSDL. |
|
|
Appelé lorsque le service Web a réussi le chargement et l'analyse de son fichier WSDL. |