Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
HTTP-Kommunikation
Bei der Definition von Variablen innerhalb des URLVariables-Konstruktors oder innerhalb der
URLVariables.decode()-Methode müssen die Zeichen, die in einem URI-String eine besondere Bedeutung haben,
in URL-Kodierung formatiert werden. Wenn ein Parametername oder ein Parameterwert beispielsweise das &-
Zeichen enthält, müssen Sie das & als %26 kodieren, da dieses Zeichen als Trennzeichen für Parameter dient. Zu diesem
Zweck kann die encodeURIComponent()-Funktion auf oberster Ebene verwendet werden.
Verwenden der URLLoader-Klasse
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Mithilfe der URLLoader-Klasse können Sie eine Anforderung an einen Server senden und auf die zurückgegebenen
Informationen zugreifen. Außerdem können Sie mithilfe der URLLoader-Klasse auf Dateien im lokalen Dateisystem
zugreifen, wenn der lokale Dateizugriff zulässig ist (beispielsweise in der Sandbox „local-with-filesystem“ von Flash
Player oder in der Sandbox der AIR-Anwendung). Die URLLoader-Klasse lädt die Daten von einer URL als Text,
Binärdaten oder URL-kodierte Variablen herunter. Die URLLoader-Klasse löst verschiedene Ereignisse aus, wie zum
Beispiel complete, httpStatus, ioError, open, progress und securityError.
Das Ereignisverarbeitungsmodell in ActionScript 3.0 unterscheidet sich ganz erheblich von dem ActionScript 2.0-
Modell, das die Ereignisprozeduren LoadVars.onData, LoadVars.onHTTPStatus und LoadVars.onLoad
verwendet. Weitere Informationen zur Ereignisverarbeitung in ActionScript 3.0 finden Sie unter „Verarbeiten von
Ereignissen“ auf Seite 133.
Die heruntergeladenen Daten stehen erst zur Verfügung, wenn der Download abgeschlossen ist. Sie können den
Fortschritt des Downloads überwachen (geladene Byte und Byte gesamt), indem Sie auf die Auslösung des progress-
Ereignisses warten. Doch wenn eine Datei sehr schnell geladen wird, wird möglicherweise kein progress-Ereignis
ausgelöst. Sobald eine Datei erfolgreich heruntergeladen wurde, wird das complete-Ereignis ausgelöst. Durch
Einstellen der URLLoader-Eigenschaft dataFormat können Sie festlegen, dass Daten als Text, in Form von
unformatierten Binärdaten oder als URLVariables-Objekt empfangen werden.
Die URLLoader.load()-Methode (und wahlweise der Konstruktor der URLLoader-Klasse) arbeiten mit einem
Parameter, request, bei dem es sich um ein URLRequest-Objekt handelt. Ein URLRequest-Objekt enthält alle
Informationen einer HTTP-Anforderung, beispielsweise die Ziel-URL, die Anforderungsmethode (GET oder POST),
zusätzliche Header-Informationen sowie den MIME-Typ.
Im folgenden Beispiel wird ein XML-Paket zu einem serverseitigen Skript hochgeladen:
var secondsUTC:Number = new Date().time;
var dataXML:XML =
{secondsUTC}
;
var request:URLRequest = new URLRequest("http://www.yourdomain.com/time.cfm");
request.contentType = "text/xml";
request.data = dataXML.toXMLString();
request.method = URLRequestMethod.POST;
var loader:URLLoader = new URLLoader();
loader.load(request);
Mit diesem Codefragment wird ein XML-Dokument namens dataXML erstellt, welches das XML-Paket enthält, das an
den Server gesendet wird. In diesem Beispiel wird die URLRequest-Eigenschaft contentType auf "text/xml"
eingestellt und das XML-Dokument wird der URLRequest-Eigenschaft data zugewiesen. Abschließend erstellt das
Beispiel ein URLLoader-Objekt und sendet die Anforderung über die load()-Methode an das Remote-Skript.
Letzte Aktualisierung 27.6.2012
865