Packageflash.net
Classepublic final class URLRequest
HéritageURLRequest Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe URLRequest capture toutes les informations dans une même requête HTTP. Les objets URLRequest sont transmis aux méthodes load() des opérations de chargement URLStream, URLLoader, Loader et autres pour lancer les téléchargements d'URL, ainsi qu’aux méthodes upload() et download() de la classe FileReference.

Pour utiliser cette classe, tenez compte du modèle de sécurité d’Adobe® Flash® Player :

Pour plus d'informations, consultez les références suivantes :

Consulter les exemples

Voir aussi

URLRequestHeader
URLLoader
URLStream
FileReference
Utilisation de données externes


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  contentType : String
Type de contenu MIME des données POST.
URLRequest
  data : Object
Objet contenant des données à transmettre avec la demande d’URL.
URLRequest
  method : String
Détermine si la méthode de soumission du formulaire HTTP est une opération GET ou POST.
URLRequest
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  requestHeaders : Array
Tableau d'en-tête de requête HTTP à ajouter à la fin de la requête HTTP.
URLRequest
  url : String
URL à demander.
URLRequest
Méthodes publiques
 MéthodeDéfini par
  
URLRequest(url:String = null)
Crée un objet URLRequest.
URLRequest
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
contentTypepropriété
contentType:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Type de contenu MIME de n'importe quelles données POST.

Remarque : les méthodes FileReference.upload() et FileReference.download() ne prennent pas en charge le paramètre URLRequest.contentType.


Implémentation
    public function get contentType():String
    public function set contentType(value:String):void
datapropriété 
data:Object  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Objet contenant des données à transmettre avec la demande d’URL.

Cette propriété s’utilise avec la propriété method. Si la valeur de URLRequest.method correspond à POST, les données sont transmises avec l’objet URLRequest par le biais de la méthode HTTP POST.

Si la valeur de URLRequest.method correspond à GET, les données définissent des variables à envoyer avec l’objet URLRequest par le biais de la méthode HTTP GET.

L'API URLRequest offre une prise en charge POST binaire et gère les variables de code URL, ainsi que les chaînes. Les objets de données peuvent être de type ByteArray, URLVariables ou String.

L’utilisation des données varie en fonction du type d’objet :

Les données ne sont pas envoyées tant qu’une méthode, telle que navigateToURL() ou FileReference.upload(), utilise l’objet URLRequest.


Implémentation
    public function get data():Object
    public function set data(value:Object):void

Voir aussi


Exemple

L’exemple suivant ouvre l’application distante hébergée à l’adresse http://www.[yourDomain].com/application.jsp dans une nouvelle fenêtre de navigateur et transmet à l'application des données relatives à une session utilisateur, capturées dans un objet URLVariables.

Vous trouverez ci-dessous des extraits de l’exemple :

  1. La fonction constructeur crée une occurrence de URLRequest nommée request, en utilisant l’URL de l’application distante comme paramètre.
  2. Un objet URLVariables est créé et des valeurs sont attribuées à deux de ses propriétés.
  3. L’objet URLVariables est affecté à la propriété data de l'objet URLRequest.
  4. L’exemple appelle navigateToURL, qui ouvre une nouvelle fenêtre de navigateur vers l’URL de l’application distante.

Remarque : pour exécuter l’exemple, l’URL de l'application distante de l'exemple doit être remplacée par une URL opérationnelle. En outre, du code serveur serait nécessaire pour traiter les informations capturées par Flash Player dans l’objet URLVariables.

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);
        }
    }
}
methodpropriété 
method:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Détermine si la méthode de soumission du formulaire HTTP est une opération GET ou POST. Les valeurs gérées sont URLRequestMethod.GET ou URLRequestMethod.POST.

La valeur par défaut est URLRequestMethod.GET.


Implémentation
    public function get method():String
    public function set method(value:String):void

Lance
ArgumentError — Si le paramètre value n'est pas URLRequestMethod.GET ou URLRequestMethod.POST.

Voir aussi


Exemple

L’exemple suivant ouvre l’application distante hébergée à l’adresse http://www.[yourDomain].com/application.jsp dans une nouvelle fenêtre de navigateur et transmet à l'application des données relatives à une session utilisateur, capturées dans un objet URLVariables. Il définit explicitement la valeur de la propriété URLRequest.method sur URLRequestMethod.POST.

Vous trouverez ci-dessous des extraits de l’exemple :

  1. La fonction constructeur crée une occurrence de URLRequest nommée request, en utilisant l’URL de l’application distante comme paramètre.
  2. Un objet URLVariables est créé et des valeurs sont attribuées à deux de ses propriétés.
  3. L’objet URLVariables est affecté à la propriété data de l'objet URLRequest.
  4. La valeur de la propriété URLRequest.method est définie sur URLRequestMethod.POST.
  5. L’exemple appelle navigateToURL, qui ouvre une nouvelle fenêtre de navigateur vers l’URL de l’application distante.

Remarque : pour exécuter l’exemple, l’URL de l'application distante de l'exemple doit être remplacée par une URL opérationnelle. En outre, du code serveur serait nécessaire pour traiter les informations capturées par Flash Player dans l’objet URLVariables.

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);
        }
    }
}
requestHeaderspropriété 
requestHeaders:Array  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Tableau d'en-tête de requête HTTP à ajouter à la fin de la requête HTTP. Le tableau se compose d’objets URLRequestHeader. Tous les objets du tableau doivent être de type URLRequestHeader et contenir une chaîne de nom et une chaîne de valeur, comme suit :

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

Flash Player impose certaines restrictions sur les en-têtes de requête. Pour en savoir plus, consultez la description de la classe URLRequestHeader.

Les méthodes FileReference.upload() et FileReference.download() ne prennent pas en charge le paramètre URLRequest.requestHeaders.


Implémentation
    public function get requestHeaders():Array
    public function set requestHeaders(value:Array):void

Voir aussi

urlpropriété 
url:String  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

URL à demander. Par défaut, l’URL doit se trouver dans exactement le même domaine que le fichier SWF appelant, sous-domaines compris. Les fichiers SWF qui figurent aux adresses www.adobe.com et store.adobe.com, par exemple, sont dans des domaines différents. Pour charger des données à partir d'un autre domaine, placez un fichier de régulation interdomaines dans le serveur qui héberge le fichier SWF. Pour plus d’informations, reportez-vous aux informations relatives à la sécurité dans la description de la classe URLRequest.

Remarque : Flash Player Mise à jour 3 et les versions ultérieures supportent IPv6 (Internet Protocol version 6). IPv6 est une version du protocole IP (Internet Protocol) qui prend en charge les adresses 128 bits (amélioration du protocole IPv4 précédent qui prend en charge les adresses 32 bits). Vous devrez peut-être activer IPv6 sur vos interfaces de mise en réseau. Pour plus d'informations, consultez l'Aide du système d'exploitation hébergeant les données. Si IPv6 est pris en charge sur le système hébergeant, vous pouvez spécifier des adresses littérales IPv6 numériques dans les URL entre crochets ([]), comme suit :

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


Implémentation
    public function get url():String
    public function set url(value:String):void
Détails du constructeur
URLRequest()Constructeur
public function URLRequest(url:String = null)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée un objet URLRequest. Si System.useCodePage correspond à true, la requête est codée via la page de code système, plutôt que le format Unicode. Si System.useCodePage correspond à false, la requête est codée via le format Unicode, plutôt que la page de code système.

Paramètres
url:String (default = null) — URL à demander. Vous pourrez définir l’URL ultérieurement à l'aide de la propriété url.

Voir aussi

Exemples Utilisation des exemples
URLRequestExample.as

L'exemple suivant crée un nouvel objet Loader et lui transmet un objet URLRequest contenant le chemin vers un fichier XML. Si le chargement réussit, un événement complete est distribué et les données du fichier XML sont écrites dans le résultat. Des gestionnaires d'événements supplémentaires capturent d’autres événements, y compris des événements d'erreur.

Pour exécuter cet exemple, placez un fichier nommé XMLFile.xml dans le même répertoire que votre fichier SWF.


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);
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/net/URLRequest.html