Das flash.net -Paket enthält Funktionen auf Paketebene zum Öffnen eines neuen Browserfensters, zum Senden einer URL-Anforderung an einen Server und zum Verarbeiten von Klassen-Aliasbezeichnungen.
Öffentliche Funktionen
 FunktionDefiniert von
  
Sucht nach einer Klasse, für die mit dem Aufruf der Methode "registerClassAlias()" ein Alias registriert wurde.
flash.net
  
navigateToURL(request:URLRequest, window:String = null):void
Öffnet oder ersetzt ein Fenster in der Anwendung mit dem Flash Player-Container (in der Regel ein Browser).
flash.net
  
registerClassAlias(aliasName:String, classObject:Class):void
Behält die Klasse (den Typ) eines Objekts bei, wenn dieses in Action Message Format (AMF) codiert wird.
flash.net
  
Sendet eine URL-Anforderung an einen Server, Antworten werden jedoch ignoriert.
flash.net
Funktionsdetail
getClassByAlias()Funktion
public function getClassByAlias(aliasName:String):Class

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Sucht nach einer Klasse, für die mit dem Aufruf der Methode registerClassAlias() ein Alias registriert wurde.

Es erfolgt keine Interaktion zwischen dieser Methode und der Methode flash.utils.getDefinitionByName().

Parameter

aliasName:String — Der zu suchende Alias.

Rückgabewerte
Class — Die mit dem gegebenen Alias verknüpfte Klasse. Falls die Suche nach der Klasse nicht erfolgreich ist, wird eine Ausnahme ausgelöst.

Auslöser
ReferenceError — Der Alias wurde nicht registriert.

Siehe auch

navigateToURL()Funktion 
public function navigateToURL(request:URLRequest, window:String = null):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Öffnet oder ersetzt ein Fenster in der Anwendung mit dem Flash Player-Container (in der Regel ein Browser).

Hinweis: Für lokalen in einem Browser ausgeführten Inhalt sind Aufrufe der Funktion navigateToURL(), die ein "javascript:"- Pseudo-Protokoll (z. B. navigateToURL("javascript:someFunction()") angeben, nur dann zulässig, wenn sich die SWF-Datei und die Webseite, in die sie eingebettet ist, (falls vorhanden) in der lokalen vertrauenswürdigen Sicherheits-Sandbox befinden. Weitere Informationen finden Sie in den folgenden Abschnitten:

Parameter

request:URLRequest — Ein URLRequest-Objekt, das die URL angibt, zu der navigiert werden soll.
 
window:String (default = null) — Das Browserfenster oder der HTML-Frame, in dem das mit dem Parameter request angegebene Dokument angezeigt werden soll. Sie können den Namen eines bestimmten Fensters angeben oder einen der folgenden Werte verwenden:
  • "_self" bezeichnet den aktuellen Frame im aktuellen Fenster.
  • "_blank" bezeichnet ein neues Fenster.
  • "_parent" bezeichnet den übergeordneten Frame des aktuellen Frames.
  • "_top" bezeichnet den obersten Frame im aktuellen Fenster.

Wenn Sie für diesen Parameter keinen Wert angeben, wird ein neues leeres Fenster erstellt. Im Standalone-Player können Sie entweder ein neues Fenster ("_blank") oder ein benanntes Fenster angeben. Die anderen Werte treffen nicht zu.

Hinweis: Wenn eine SWF-Datei in der lokalen Sandbox des Dateisystems ausgeführt wird und mit einem Code, der sich in dieser SWF-Datei befindet, die Funktion navigateToURL() aufgerufen und ein benutzerdefinierter Fenstername für den Parameter window angegeben wird, wird der Fenstername in einen Zufallsnamen umgewandelt. Der Name hat die Form "_flashXXXXXXXX", wobei jedes X eine zufällige hexadezimale Zahl darstellt. Wenn Sie innerhalb derselben Sitzung (bis zum Schließen des jeweiligen Browserfensters) die Funktion erneut aufrufen und denselben Namen für den Parameter window angeben, wird derselbe Zufalls-String verwendet.


Auslöser
SecurityError — Dieser Fehler wird in folgenden Situationen ausgelöst:
  • Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können diese Situation vermeiden, indem Sie die entsprechende SWF-Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.
  • Mit einem Navigationsvorgang wurde versucht, die Pseudo-URL eines Skripts zu evaluieren, das zugehörige Dokument (in der Regel ein HTML-Dokument in einem Browser) befindet sich jedoch in einer Sandbox, auf die Sie keinen Zugriff haben. Sie können diese Situation vermeiden, indem Sie im zugehörigen Dokument allowScriptAccess="always" angeben.
  • Sie können in den Fenstern "_self", "_top" und "_parent" nicht navigieren, wenn Ihre SWF-Datei in einer HTML-Seite enthalten ist, für die allowScriptAccess auf den Wert "none" oder auf den Wert "sameDomain" gesetzt ist (wenn die Domänen der HTML-Datei und der SWF-Datei nicht übereinstimmen).
  • Sie können nicht von einer SWF-Datei in einer lokalen Dateisystem-Sandbox aus in einem Fenster mit einem nicht standardmäßigen Namen navigieren.

Siehe auch


Beispiel

Im folgenden Beispiel wird die URL http://www.adobe.com in einem neuen Browserfenster geöffnet, und in einem URLVariables-Objekt erfasste Daten zu einer Benutzersitzung werden an den Webserver übergeben.
package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class NavigateToURLExample extends Sprite {

        public function NavigateToURLExample() {
            var url:String = "http://www.adobe.com";
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "Your Name";
            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            try {            
                navigateToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}
registerClassAlias()Funktion 
public function registerClassAlias(aliasName:String, classObject:Class):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Behält die Klasse (den Typ) eines Objekts bei, wenn dieses in Action Message Format (AMF) codiert wird. Bei der Codierung eines Objekts in AMF speichert diese Funktion einen Alias für die Klasse des Objekts, sodass Sie die Klasse wiederherstellen können, wenn Sie das Objekt decodieren. Wenn im Kontext der Codierung kein Alias für eine Objektklasse registriert wird, erfolgt die Codierung des Objekts als anonymes Objekt. Wenn im Kontext der Decodierung nicht derselbe Alias registriert ist, wird für die decodierten Daten ein anonymes Objekt erstellt.

LocalConnection, ByteArray, SharedObject, NetConnection und NetStream sind Beispiele für Klassen, die Objekte in AMF codieren.

Für den Codierungs- und Decodierungs-Kontext muss nicht dieselbe Klasse für einen Alias verwendet werden. Die Klassen können geändert werden, vorausgesetzt, dass die Zielklasse alle Mitglieder enthält, die von der Quellklasse serialisiert werden.

Parameter

aliasName:String — Der zu verwendende Alias.
 
classObject:Class — Die mit dem gegebenen Alias verknüpfte Klasse.


Auslöser
TypeError — Wenn einer der Parameter den Wert null aufweist.

Siehe auch


Beispiel

In diesem Beispiel wird die Funktion registerClassAlias() zur Registrierung eines Alias (com.example.eg) für die ExampleClass-Klasse verwendet. Die Registrierung eines Alias für die Klasse ermöglicht die Deserialisierung des Objekts als Instanz von ExampleClass, und der Code gibt den Wert true aus. Bei Entfernung des Aufrufs registerClassAlias() würde der Code den Wert false ausgeben.
package {
    import flash.display.Sprite;
    import flash.net.registerClassAlias;
    import flash.utils.ByteArray;

    public class RegisterClassAliasExample extends Sprite {
        public function RegisterClassAliasExample() {
            registerClassAlias("com.example.eg", ExampleClass);
            var eg1:ExampleClass = new ExampleClass();
            var ba:ByteArray = new ByteArray();
            ba.writeObject(eg1);
            ba.position = 0;
            var eg2:* = ba.readObject();
            trace(eg2 is ExampleClass); // true
        }
    }
}

class ExampleClass {}
sendToURL()Funktion 
public function sendToURL(request:URLRequest):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Sendet eine URL-Anforderung an einen Server, Antworten werden jedoch ignoriert.

Verwenden Sie die MethodeURLLoader.load(), wenn die Serverantwort überprüft werden soll.

Ab der Version Flash Player 9 können Sie eine SWF-Datei daran hindern, diese Methode aufzurufen, indem Sie in der HTML-Seite, die den SWF-Inhalt beinhaltet, den Parameter allowNetworking der Tags object und embed festlegen.

Weitere Informationen finden Sie im Flash Player 9-Whitepaper zum Thema Sicherheit unter http://www.adobe.com/go/fp9_0_security_de.

Parameter

request:URLRequest — Ein URLRequest-Objekt, das die URL angibt, an die Daten gesendet werden sollen.


Auslöser
SecurityError — Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können diese Situation vermeiden, indem Sie die entsprechende SWF-Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.

Siehe auch


Beispiel

Im folgenden Beispiel werden die in einem URLVariables-Objekt erfassten Daten zu einer Benutzersitzung an die Anwendung unter http://www.yourDomain.com/application.jsp übergeben.
 package {
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.net.URLVariables;
    import flash.net.sendToURL;

    public class SendToURLExample extends Sprite {

        public function SendToURLExample() {
            var url:String = "http://www.yourDomain.com/application.jsp";
            var variables:URLVariables = new URLVariables();
            variables.sessionId = new Date().getTime();
            variables.userLabel = "Your Name";

            var request:URLRequest = new URLRequest(url);
            request.data = variables;
            trace("sendToURL: " + request.url + "?" + request.data);
            try {
                sendToURL(request);
            }
            catch (e:Error) {
                // handle error here
            }
        }
    }
}

 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/package.html