| Paquete | flash.net |
| Clase | public final class URLRequest |
| Herencia | URLRequest Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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:
Véase también
| Propiedad | Definido por | ||
|---|---|---|---|
![]() | constructor : 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 | ||
![]() | prototype : 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étodo | Definido por | ||
|---|---|---|---|
|
URLRequest(url:String = null)
Crea un objeto URLRequest.
| URLRequest | ||
![]() |
Indica si un objeto tiene definida una propiedad especificada.
| Object | |
![]() |
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
| Object | |
![]() |
Indica si existe la propiedad especificada y si es enumerable.
| Object | |
![]() |
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
| Object | |
![]() |
Devuelve la representación de cadena del objeto especificado.
| Object | |
![]() |
Devuelve el valor simple del objeto especificado.
| Object | |
| contentType | propiedad |
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.
public function get contentType():String
public function set contentType(value:String):void
| data | propiedad |
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:
POST. En el caso de GET, no se admiten los datos de tipo ByteArray. Asimismo, los datos de tipo ByteArray no con compatibles con FileReference.upload() y FileReference.download().POST, las variables se codifican con formato x-www-form-urlencoded y la cadena resultante se utiliza como datos POST. Una excepción es la llamada a FileReference.upload(), en la que las variables se envían como campos separados en un envío multipart/form-data.GET, el objeto URLVariables define las variables que se enviarán con el objeto URLRequest.POST o GET.Los datos no se envían hasta que un método (por ejemplo, navigateToURL() o FileReference.upload()) utilice el objeto URLRequest.
public function get data():Object
public function set data(value:Object):void
Véase también
A continuación se detallan los fragmentos más importantes del ejemplo:
request y toma la URL de la aplicación remota como parámetro.data del objeto URLRequest.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);
}
}
}| method | propiedad |
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.
public function get method():String
public function set method(value:String):void
ArgumentError — Si el parámetro value no es URLRequestMethod.GET ni URLRequestMethod.POST.
|
Véase también
URLRequest.method como URLRequestMethod.POST.
A continuación se detallan los fragmentos más importantes del ejemplo:
request y toma la URL de la aplicación remota como parámetro.data del objeto URLRequest.URLRequest.method se define como URLRequestMethod.POST.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);
}
}
}| requestHeaders | propiedad |
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.
public function get requestHeaders():Array
public function set requestHeaders(value:Array):void
Véase también
| url | propiedad |
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
public function get url():String
public function set url(value:String):void
| 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.
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
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