Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Sicherheit
Wenn Sie die load()-Methode des Loader-Objekts aufrufen, können Sie einen context-Parameter angeben, bei dem
es sich um ein LoaderContext-Objekt handelt. Die LoaderContext-Klasse umfasst drei Eigenschaften, mit denen Sie
den Kontext definieren können, wie der geladene Inhalt verwendet werden kann:
checkPolicyFile: Verwenden Sie diese Eigenschaft nur beim Laden einer Bilddatei (nicht beim Laden einer
SWF-Datei). Dies ist nur dann notwendig, wenn eine Bilddatei aus einer anderen Domäne stammt als die Datei,
die das Loader-Objekt enthält. Wenn Sie diese Eigenschaft auf true festlegen, sucht der Loader auf dem
Ursprungsserver nach einer URL-Richtliniendatei (siehe „Kontrolloptionen für Websites (Richtliniendateien)“ auf
Seite 1111). Wenn der Server Zugriffsrechte für die Loader-Domäne erteilt, kann ActionScript aus SWF-Dateien
in der Loader-Domäne auf Daten im geladenen Bild zugreifen. Anders ausgedrückt, Sie können mit der Eigenschaft
Loader.content einen Verweis auf das Bitmap-Objekt erhalten, das ein geladenes Bild darstellt; oder Sie
verwenden die Methode BitmapData.draw() oder BitmapData.drawWithQuality(), um auf die Pixel des
geladenen Bilds zuzugreifen. Die drawWithQuality-Methode ist in Flash Player 11.3 und höher sowie AIR 3.3 und
höher verfügbar.
securityDomain: Verwenden Sie diese Eigenschaft nur beim Laden einer SWF-Datei (nicht beim Laden eines
Bilds). Dies ist nur dann notwendig, wenn eine SWF-Datei aus einer anderen Domäne stammt als die Datei, die
das Loader-Objekt enthält. Für die Eigenschaft securityDomain werden derzeit nur zwei Werte unterstützt: null
(Standardwertdefault) und SecurityDomain.currentDomain. Wenn Sie SecurityDomain.currentDomain
einstellen, muss die geladene SWF-Datei in die Sandbox der ladenden SWF-Datei importiert werden. Mit anderen
Worten, sie wird so behandelt, als ob sie vom eigenen Server der ladenden SWF-Datei geladen wurde. Dies ist nur
dann zulässig, wenn sich eine URL-Richtliniendatei auf dem Server der geladenen SWF-Datei befindet, die den
Zugriff auf die Domäne der ladenden SWF-Datei gewährt. Wenn die erforderliche Richtliniendatei gefunden
wurde, haben die ladende und die geladene Datei mit Beginn des Ladens gegenseitigen Skriptzugriff, da sich beide
Dateien in der gleichen Sandbox befinden. Beachten Sie, dass das Sandbox-Importieren weitestgehend durch das
Ausführen eines regulären Ladevorgangs und das Aufrufen der Methode Security.allowDomain() durch die
geladene SWF-Datei ersetzt werden kann. Das zuletzt genannte Verfahren ist einfacher anzuwenden, da sich die
geladene SWF-Datei in ihrer eigenen natürlichen Sandbox befindet und auf Ressourcen auf ihrem eigenen Server
zugreifen kann.
applicationDomain: Verwenden Sie diese Eigenschaft nur beim Laden einer SWF-Datei, die in ActionScript 3.0
geschrieben wurde (nicht beim Laden eines Bilds oder einer SWF-Datei, die in ActionScript 1.0 oder 2.0
geschrieben wurde). Beim Laden der Datei können Sie angeben, dass die Datei nicht wie in der Standardeinstellung
in einer neuen Anwendungsdomäne (bei der es sich um ein untergeordnetes Element der Anwendungsdomäne der
ladenden SWF-Datei handelt), sondern in einer bestimmten Anwendungsdomäne abgelegt werden soll. Beachten
Sie, dass Anwendungsdomänen Untereinheiten von Sicherheitsdomänen sind. Aus diesem Grund können Sie nur
dann eine Ziel-Anwendungsdomäne angeben, wenn die von Ihnen geladene SWF-Datei aus Ihrer eigenen
Sicherheitsdomäne stammt (entweder stammt sie von Ihrem Server oder Sie haben sie mit der Eigenschaft
securityDomain erfolgreich in Ihre Sicherheitsdomäne importiert). Wenn Sie eine Anwendungsdomäne
angegeben haben, die geladene SWF-Datei aber Teil einer anderen Sicherheitsdomäne ist, wird die Domäne, die
Sie in applicationDomain angegeben haben, ignoriert. Weitere Informationen finden Sie unter „Verwenden von
Anwendungsdomänen“ auf Seite 157.
Weitere Informationen finden Sie unter „Festlegen des Ladekontexts“ auf Seite 214.
Eine wichtige Eigenschaft eines Loader-Objekts ist contentLoaderInfo, bei der es sich um ein LoaderInfo-Objekt
handelt. Im Gegensatz zu den meisten anderen Objekten wird ein LoaderInfo-Objekte von der ladenden SWF-Datei
und dem geladenen Inhalt gemeinsam genutzt und beide Parteien können immer darauf zugreifen. Handelt es sich bei
dem geladenen Inhalt um eine SWF-Datei, kann sie über die Eigenschaft DisplayObject.loaderInfo auf das
LoaderInfo-Objekt zugreifen. LoaderInfo-Objekte enthalten Informationen wie den Ladefortschritt, die URLs der
ladenden und der geladenen Dateien, die Vertrauensbeziehungen zwischen ladender und geladener Datei und andere
Daten. Weitere Informationen finden Sie unter „Überwachen des Ladefortschritts“ auf Seite 212.
Letzte Aktualisierung 27.6.2012
1122