Guide de reference du langage ActionScript 2.0 - PowWeb

send (méthode LocalConnection.send)
public send(connectionName:String, methodName:String, [args:Object]) :
Boolean
Invoque la méthode nommée method sur une connexion établie à l'aide de la commande
LocalConnection.connect( connectionName ) (l'objet LocalConnection de réception).
L'objet utilisé avec cette commande est appelé l'objet LocalConnection d'envoi. Les fichiers
SWF qui contiennent les objets d'envoi et de réception doivent s'exécuter sur le même
ordinateur client.
La quantité de données que vous pouvez transmettre en tant que paramètres à cette
commande est limitée à 40 Ko. Si la commande renvoie la valeur false mais si votre syntaxe
est correcte, essayez de répartir les requêtes LocalConnection.send() en plusieurs
commandes, chacune comportant moins de 40 Ko de données.
Comme nous l'avons vu dans l'entrée LocalConnection.connect(), Flash ajoute le
superdomaine actuel à connectionName par défaut. Si vous implémentez la communication
entre différents domaines, vous devez définir connectionName dans les objets
LocalConnection d'envoi et de réception de sorte que Flash n'ajoute pas le superdomaine
actuel à connectionName. Pour ce faire, procédez de l'une des deux façons suivantes :
■ Placez un trait de soulignement (_) au début de connectionName dans les objets
LocalConnection d'envoi et de réception. Dans le fichier SWF contenant l'objet de
réception, utilisez LocalConnection.allowDomain pour spécifier que les connexions à
partir de tous les domaines seront acceptées. Cette implémentation vous permet de stocker
vos fichiers SWF d'envoi et de réception dans n'importe quel domaine.
■ Incluez le superdomaine à connectionName dans l'objet LocalConnection d'envoi, par
exemple, myDomain.com:myConnectionName. Dans l'objet de réception, utilisez
LocalConnection.allowDomain pour spécifier que les connexions à partir du
superdomaine spécifié seront acceptées (dans ce cas, myDomain.com) ou que les
connexions à partir de tous les domaines seront acceptées.
Remarque : Vous ne pouvez pas spécifier de superdomaine dans connectionNamepour l'objet
LocalConnection de réception : vous pouvez le faire uniquement dans l'objet
LocalConnection d'envoi.
Lorque vous utilisez cette méthode, prenez en considération le modèle de sécurité de Flash
Player. Par défaut, un objet LocalConnection est associé au Sandbox du fichier SWF qui l'a
créé et les appels interdomaines vers les objets LocalConnection ne sont pas autorisés si la
méthode LocalConnection.allowDomain() a été invoquée.
752 Chapitre 2: Classes ActionScript