Paketflash.net
Klassepublic final class URLRequest
VererbungURLRequest Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die URLRequest-Klasse erfasst alle Informationen in einer HTTP-Anforderung. URLRequest-Objekte werden an die load()-Methoden von URLStream, URLLoader, Loader und anderen Ladevorgängen übergeben, um die URL-Downloads zu starten, sowie an die upload()- und download()-Methoden der FileReference-Klasse.

Beachten Sie bei Verwendung dieser Klasse das folgende Sicherheitsmodell von Adobe® Flash® Player:

Weitere Informationen finden Sie in den folgenden Abschnitten:

Beispiele anzeigen

Siehe auch

URLRequestHeader
URLLoader
URLStream
FileReference
Verwenden von externen Daten


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  contentType : String
Der MIME-Inhaltstyp der POST-Daten.
URLRequest
  data : Object
Ein Objekt, das mit der URL-Anforderung zu übertragende Daten enthält.
URLRequest
  method : String
Steuert, ob als HTTP-Übertragungsmethode ein GET- oder ein POST-Vorgang verwendet wird.
URLRequest
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  requestHeaders : Array
Das Array der an die HTTP-Anforderung anzuhängenden HTTP-Anforderungsheader.
URLRequest
  url : String
Die anzufordernde URL.
URLRequest
Öffentliche Methoden
 MethodeDefiniert von
  
URLRequest(url:String = null)
Erstellt ein URLRequest-Objekt.
URLRequest
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftsdetail
contentTypeEigenschaft
contentType:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der MIME-Inhaltstyp der POST-Daten.

Hinweis: Der Parameter URLRequest.contentType wird von den Methoden FileReference.upload() und FileReference.download() nicht unterstützt.


Implementierung
    public function get contentType():String
    public function set contentType(value:String):void
dataEigenschaft 
data:Object  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Objekt, das mit der URL-Anforderung zu übertragende Daten enthält.

Diese Eigenschaft wird mit der Eigenschaft method verwendet. Wenn URLRequest.method den Wert POST aufweist, werden die Daten mit dem URLRequest-Objekt und der HTTP-Methode POST übertragen.

Wenn URLRequest.method den Wert GET aufweist, definieren die Daten Variablen, die mit dem URLRequest-Objekt und der HTTP-Methode GET gesendet werden.

Die API für "URLRequest" unterstützt binäre POST-Daten sowie URL-codierte Variablen und Strings. Das Datenobjekt kann den Typ "ByteArray", "URLVariables" oder "String" aufweisen.

Die Verwendung der Daten hängt vom Objekttyp ab:

Die Daten werden erst gesendet, wenn eine Methode (z. B. navigateToURL() oder FileReference.upload()) das URLRequest-Objekt verwendet.


Implementierung
    public function get data():Object
    public function set data(value:Object):void

Siehe auch


Beispiel

Im folgenden Beispiel wird die Remote-Anwendung unter http://www.[yourDomain].com/application.jsp in einem neuen Browserfenster geöffnet, und in einem URLVariables-Objekt erfasste Daten zu einer Benutzersitzung werden an die Anwendung übergeben.

Wichtige Beispielauszüge:

  1. Die Konstruktorfunktion erstellt eine URLRequest-Instanz mit dem Namen request, wobei die URL der Remote-Anwendung als Parameter verwendet wird.
  2. Ein URLVariables-Objekt wird erstellt, und zwei seiner Eigenschaften werden Werte zugewiesen.
  3. Das URLVariables-Objekt wird der Eigenschaft data des URLRequest-Objekts zugewiesen.
  4. Das Beispiel ruft navigateToURL auf, wodurch ein neues Browserfenster mit der URL der Remote-Anwendung geöffnet wird.

Hinweis: Zur Ausführung des Beispiels muss die URL der Remote-Anwendung durch eine gültige URL ersetzt werden. Darüber hinaus benötigen Sie Servercode, um die von Flash Player im URLVariables-Objekt erfassten Informationen auszuführen.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLVariables;

    public class URLVariablesExample extends Sprite {

        public function URLVariablesExample() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            navigateToURL(request);
        }
    }
}
methodEigenschaft 
method:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Steuert, ob als HTTP-Übertragungsmethode ein GET- oder ein POST-Vorgang verwendet wird. Gültige Werte sind URLRequestMethod.GET und URLRequestMethod.POST.

Der Standardwert lautet URLRequestMethod.GET.


Implementierung
    public function get method():String
    public function set method(value:String):void

Auslöser
ArgumentError — Der Parameter value ist nicht URLRequestMethod.GET oder URLRequestMethod.POST.

Siehe auch


Beispiel

Im folgenden Beispiel wird die Remote-Anwendung unter http://www.[yourDomain].com/application.jsp in einem neuen Browserfenster geöffnet, und in einem URLVariables-Objekt erfasste Daten zu einer Benutzersitzung werden an die Anwendung übergeben. Der Wert der Eigenschaft URLRequest.method wird explizit auf URLRequestMethod.POST gesetzt.

Wichtige Beispielauszüge:

  1. Die Konstruktorfunktion erstellt eine URLRequest-Instanz mit dem Namen request, wobei die URL der Remote-Anwendung als Parameter verwendet wird.
  2. Ein URLVariables-Objekt wird erstellt, und zwei seiner Eigenschaften werden Werte zugewiesen.
  3. Das URLVariables-Objekt wird der Eigenschaft data des URLRequest-Objekts zugewiesen.
  4. Der Wert der Eigenschaft URLRequest.method wird auf URLRequestMethod.POST gesetzt.
  5. Das Beispiel ruft navigateToURL auf, wodurch ein neues Browserfenster mit der URL der Remote-Anwendung geöffnet wird.

Hinweis: Zur Ausführung des Beispiels muss die URL der Remote-Anwendung durch eine gültige URL ersetzt werden. Darüber hinaus benötigen Sie Servercode, um die von Flash Player im URLVariables-Objekt erfassten Informationen auszuführen.

package {
    import flash.display.Sprite;
    import flash.net.navigateToURL;
    import flash.net.URLRequest;
    import flash.net.URLRequestMethod;
    import flash.net.URLVariables;

    public class URLRequest_method extends Sprite {

        public function URLRequest_method() {
            var url:String = "http://www.[yourDomain].com/application.jsp";
            var request:URLRequest = new URLRequest(url);
            
            var variables:URLVariables = new URLVariables();
            variables.exampleSessionId = new Date().getTime();
            variables.exampleUserLabel = "guest";
            request.data = variables;
            request.method = URLRequestMethod.POST;
            
            navigateToURL(request);
        }
    }
}
requestHeadersEigenschaft 
requestHeaders:Array  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Das Array der an die HTTP-Anforderung anzuhängenden HTTP-Anforderungsheader. Das Array besteht aus URLRequestHeader-Objekten. Jedes Objekt im Array muss ein URLRequestHeader-Objekt sein und einen Namens- und einen Wert-String enthalten:

  var rhArray:Array = new Array(new URLRequestHeader("Content-Type", "text/html"));
  

In Flash Player gelten bestimmte Einschränkungen für Anforderungsheader. Weitere Informationen hierzu finden Sie in der Beschreibung der URLRequestHeader-Klasse.

Die Methoden FileReference.upload() und FileReference.download() unterstützen den Parameter URLRequest.requestHeaders nicht.


Implementierung
    public function get requestHeaders():Array
    public function set requestHeaders(value:Array):void

Siehe auch

urlEigenschaft 
url:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die anzufordernde URL. In der Standardeinstellung muss sich die URL in derselben Domäne befinden wie die aufrufende SWF-Datei, einschließlich Subdomänen. Bei www.adobe.com und store.adobe.com handelt es sich beispielsweise um unterschiedliche Domänen. Legen Sie eine domänenübergreifende Richtliniendatei auf dem Server ab, auf dem sich die Daten befinden, um Daten von einer anderen Domäne zu laden. Weitere Informationen finden Sie in den Sicherheitsinformationen in der Beschreibung der URLRequest-Klasse.

Hinweis: Flash Player Update 3 und höher unterstützt IPv6 (Internet Protocol Version 6). IPv6 ist eine Internet Protocol-Version, die 128-Bit-Adressen unterstützt (eine Verbesserung gegenüber der älteren Version IPv4, die 32-Bit-Adressen unterstützt). Möglicherweise müssen Sie IPv6 für Ihre Netzwerkschnittstellen aktivieren. Weitere Informationen finden Sie in der Hilfe des Betriebssystems, unter dem die Daten gehostet werden. Wenn IPv6 vom Hostingsystem unterstützt wird, können Sie in URLs numerische IPv6-Literaladressen in eckigen Klammern angeben, wie im folgenden Beispiel:

     rtmp://[2001:db8:ccc3:ffff:0:444d:555e:666f]:1935/test
     


Implementierung
    public function get url():String
    public function set url(value:String):void
Konstruktordetail
URLRequest()Konstruktor
public function URLRequest(url:String = null)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt ein URLRequest-Objekt. Wenn System.useCodePage auf true gesetzt ist, wird die Anforderung mit der Codepage des Systems codiert. Wenn System.useCodePage auf false gesetzt ist, wird die Anforderung mit Unicode codiert.

Parameter
url:String (default = null) — Die anzufordernde URL. Sie können die URL zu einem späteren Zeitpunkt mithilfe der Eigenschaft url festlegen.

Siehe auch

Beispiele Verwendung von Beispielen
URLRequestExample.as

Im folgenden Beispiel wird ein neues Loader-Objekt erstellt und an ein URLRequest-Objekt übergeben, das den Pfad zu einer XML-Datei enthält. Bei erfolgreich ausgeführtem Ladevorgang wird ein complete-Ereignis ausgelöst, und die Daten in der XML-Datei werden in die Ausgabe geschrieben. Andere Ereignisse einschließlich Fehlerereignisse werden von zusätzlichen Ereignisprozeduren erfasst.

Legen Sie zur Ausführung dieses Beispiels eine Datei mit dem Namen "XMLFile.xml" in dem Verzeichnis ab, in dem sich die SWF-Datei befindet.


package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.*;

    public class URLRequestExample extends Sprite {

        public function URLRequestExample() {
            var loader:URLLoader = new URLLoader();
            configureListeners(loader);

            var request:URLRequest = new URLRequest("XMLFile.xml");
            try {
                loader.load(request);
            } catch (error:Error) {
                trace("Unable to load requested document.");
            }
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        }

        private function completeHandler(event:Event):void {
            var loader:URLLoader = URLLoader(event.target);
            trace("completeHandler: " + loader.data);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




 

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/URLRequest.html