Paqueteflash.net
Clasepublic final class URLRequest
HerenciaURLRequest Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase URLRequest captura toda la información en una sola solicitud HTTP. Los objetos URLRequest se transmiten a los métodos load() de URLStream, URLLoader, Loader y otras operaciones de carga para iniciar descargas URL, así como a los métodos upload() y download() de la clase FileReference.

Cuando utilice esta clase, puede ser conveniente usar el modelo de seguridad de Adobe® Flash® Player:

Para más información, consulte las siguientes secciones:

Ver los ejemplos

Véase también

URLRequestHeader
URLLoader
URLStream
FileReference
Utilización de datos externos


Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  contentType : String
El tipo de contenido MIME de cualquier dato POST.
URLRequest
  data : Object
Un objeto que contiene datos que se van a transmitir con la solicitud URL.
URLRequest
  method : String
Controla si el método de envío HTTP es una operación GET o POST.
URLRequest
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  requestHeaders : Array
La matriz de encabezados de solicitud HTTP que se añadirán a la solicitud HTTP.
URLRequest
  url : String
La URL que se va a solicitar.
URLRequest
Métodos públicos
 MétodoDefinido por
  
URLRequest(url:String = null)
Crea un objeto URLRequest.
URLRequest
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
contentTypepropiedad
contentType:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

El tipo de contenido MIME de cualquier dato POST.

Nota: los métodos FileReference.upload() y FileReference.download() no admiten el parámetro URLRequest.contentType.


Implementación
    public function get contentType():String
    public function set contentType(value:String):void
datapropiedad 
data:Object  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Un objeto que contiene datos que se van a transmitir con la solicitud URL.

Esta propiedad se utiliza con la propiedad method. Si el valor de URLRequest.method es POST, los datos se transmiten con el objeto URLRequest y con el método HTTP POST.

Si el valor de URLRequest.method es GET, los datos definen variables que se enviarán con el objeto URLRequest y con el método HTTP GET.

La API URLRequest ofrece compatibilidad POST binaria y admite variables con codificación URL, así como compatibilidad con cadenas. El objeto de datos puede ser de tipo ByteArray, URLVariables o String.

El modo en que se utilicen los datos dependerá del tipo de objeto empleado:

Los datos no se envían hasta que un método (por ejemplo, navigateToURL() o FileReference.upload()) utilice el objeto URLRequest.


Implementación
    public function get data():Object
    public function set data(value:Object):void

Véase también


Ejemplo

En el ejemplo siguiente, se abre la aplicación remota alojada en http://www.[yourDomain].com/application.jsp en una nueva ventana del navegador y transfiere los datos sobre una sesión de usuario, capturados en un objeto URLVariables, en el servidor Web.

A continuación se detallan los fragmentos más importantes del ejemplo:

  1. La función constructora crea una instancia de URLRequest llamada request y toma la URL de la aplicación remota como parámetro.
  2. Se crea un objeto URLVariables y dos de sus propiedades son valores asignados.
  3. Se asigna el objeto URLVariables a la propiedad data del objeto URLRequest.
  4. El ejemplo llama a navigateToURL, que abre una nueva ventana del navegador con la URL de la aplicación remota.

Nota: para ejecutar el ejemplo, la URL de la aplicación remota del ejemplo debe sustituirse por una URL que funcione. Además, necesitará código de servidor para procesar la información capturada por Flash Player en el objeto 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);
        }
    }
}
methodpropiedad 
method:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Controla si el método de envío HTTP es una operación GET o POST. Los valores válidos son URLRequestMethod.GET o URLRequestMethod.POST.

El valor predeterminado es URLRequestMethod.GET.


Implementación
    public function get method():String
    public function set method(value:String):void

Emite
ArgumentError — Si el parámetro value no es URLRequestMethod.GET ni URLRequestMethod.POST.

Véase también


Ejemplo

En el ejemplo siguiente, se abre la aplicación remota alojada en http://www.[yourDomain].com/application.jsp en una nueva ventana del navegador y transfiere los datos sobre una sesión de usuario, capturados en un objeto URLVariables, en el servidor Web. Establece de forma explícita el valor de la propiedad URLRequest.method como URLRequestMethod.POST.

A continuación se detallan los fragmentos más importantes del ejemplo:

  1. La función constructora crea una instancia de URLRequest llamada request y toma la URL de la aplicación remota como parámetro.
  2. Se crea un objeto URLVariables y dos de sus propiedades son valores asignados.
  3. Se asigna el objeto URLVariables a la propiedad data del objeto URLRequest.
  4. El valor de la propiedad URLRequest.method se define como URLRequestMethod.POST.
  5. El ejemplo llama a navigateToURL, que abre una nueva ventana del navegador con la URL de la aplicación remota.

Nota: para ejecutar el ejemplo, la URL de la aplicación remota del ejemplo debe sustituirse por una URL que funcione. Además, necesitará código de servidor para procesar la información capturada por Flash Player en el objeto 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);
        }
    }
}
requestHeaderspropiedad 
requestHeaders:Array  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La matriz de encabezados de solicitud HTTP que se añadirán a la solicitud HTTP. La matriz está formada por objetos URLRequestHeader. Cada objeto de la matriz debe ser un objeto URLRequestHeader que contenga una cadena de nombre y de valor, del modo siguiente:

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

Flash Player impone ciertas restricciones a los encabezados de solicitud ; para más información, consulte la descripción de la clase URLRequestHeader.

Los métodos FileReference.upload() y FileReference.download() no admiten el parámetro URLRequest.requestHeaders.


Implementación
    public function get requestHeaders():Array
    public function set requestHeaders(value:Array):void

Véase también

urlpropiedad 
url:String  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La URL que se va a solicitar. De forma predeterminada, la URL debe encontrarse exactamente en el mismo dominio que el archivo SWF que realiza la llamada, incluidos los subdominios. Por ejemplo, los archivos SWF de www.adobe.com y store.adobe.com se encuentran en dominios distintos. Para cargar datos desde un dominio distinto, coloque un archivo de política entre distintos dominios en el servidor que aloja el archivo SWF. Para obtener más información consulte la documentación sobre seguridad descrita en la clase URLRequest.

Nota: Flash Player Update 3 y las versiones posteriores admiten IPv6 (versión 6 del Protocolo de Internet). IPv6 es una versión del Protocolo de Internet que admite direcciones de 128 bits (una mejora con respecto al protocolo anterior IPv4 que admite direcciones de 32 bits). Es posible que tenga que activar IPv6 en sus interfaces de red. Para más información, consulte la Ayuda del sistema operativo que aloja los datos. Si se admite IPv6 en el sistema de host, puede especificar direcciones literales numéricas de IPv6 en URL entre corchetes ([]), como se muestra a continuación:

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


Implementación
    public function get url():String
    public function set url(value:String):void
Información sobre constructores
URLRequest()constructor
public function URLRequest(url:String = null)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto URLRequest. Si System.useCodePage es true, la solicitud se codifica con la página de códigos del sistema y no con Unicode. Si System.useCodePage es false, la solicitud se codifica con Unicode, y no con la página de códigos del sistema.

Parámetros
url:String (default = null) — La URL que se va a solicitar. Se puede establecer la URL más adelante con la propiedad url.

Véase también

Ejemplos Cómo utilizar los ejemplos
URLRequestExample.as

En el ejemplo siguiente, se crea un nuevo objeto Loader y se transmite a un objeto URLRequest que contiene la ruta a un archivo XML. Si la operación de carga es correcta, se distribuye un evento complete y se realiza un seguimiento de los datos del archivo XML hasta el resultado. Los controladores de eventos adicionales capturan otros eventos, incluidos los eventos de error.

Para ejecutar el ejemplo, coloque un archivo llamado XMLFile.xml en el mismo directorio que el archivo 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);
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/net/URLRequest.html