Paquete | flash.net |
Clase | public final class URLRequestHeader |
Herencia | URLRequestHeader Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders
de la clase URLRequest.
In Adobe® AIR®, el contenido del entorno limitado de seguridad de la aplicación (por ejemplo, el contenido instalado con la aplicación de AIR) puede utilizar cualquier encabezado de petición, sin errores. No obstante, el contenido ejecutado en Adobe AIR que se encuentre en un entorno limitado de seguridad distinto, o el contenido ejecutado en Flash® Player, que utilice los siguientes encabezados de petición puede provocar la emisión de un error de tiempo de ejecución. Las palabras clave no distinguen entre mayúsculas y minúsculas (por ejemplo, Get
, get
y GET
sólo son uno):
En Flash Player y en el contenido de Adobe AIR fuera del entorno limitado de seguridad de la aplicación, no se pueden utilizar los siguientes encabezados de petición. Las palabras clave no distinguen entre mayúsculas y minúsculas (por ejemplo, Get
, get
y GET
sólo son uno). Además, los términos con guión se aplican siempre que se utilice un carácter de guión bajo (por ejemplo, no se admiten las dos versiones Content-Length
y Content_Length
):
Accept-Charset
, Accept-Encoding
, Accept-Ranges
, Age
, Allow
, Allowed
, Authorization
, Charge-To
, Connect
, Connection
, Content-Length
, Content-Location
, Content-Range
, Cookie
, Date
, Delete
, ETag
, Expect
, Get
, Head
, Host
, If-Modified-Since
, Keep-Alive
, Last-Modified
, Location
, Max-Forwards
, Options
, Origin
, Post
, Proxy-Authenticate
, Proxy-Authorization
, Proxy-Connection
, Public
, Put
, Range
, Referer
, Request-Range
, Retry-After
, Server
, TE
, Trace
, Trailer
, Transfer-Encoding
, Upgrade
, URI
, User-Agent
, Vary
, Via
, Warning
, WWW-Authenticate
, x-flash-version
.
Los objetos URLRequestHeader tienen restricciones de longitud. Si la longitud acumulada de un objeto URLRequestHeader (la longitud de la propiedad name
más la propiedad value
) o la de un conjunto de objetos URLRequestHeader utilizado en la propiedad URLRequest.requestHeaders
supera la longitud aceptable, se emite una excepción.
El contenido ejecutado en Adobe AIR define el encabezado ACCEPT
del modo siguiente, a no ser que se especifique un ajuste para el encabezado ACCEPT
de la propiedad requestHeaders
de la clase URLRequest:
text/xml, application/xml, application/xhtml+xml, text/html;q=0.9, text/plain;q=0.8, image/png, application/x-shockwave-flash, video/mp4;q=0.9, flv-application/octet-stream;q=0.8, video/x-flv;q=0.7, audio/mp4, */*;q=0.5
No todos los métodos que aceptan los parámetros URLRequest admiten la propiedad requestHeaders
; consulte la documentación del método que vaya a llamar. Por ejemplo, los métodos FileReference.upload()
y FileReference.download()
no admiten la propiedad URLRequest.requestHeaders
.
Debido a las limitaciones del navegador, los encabezados de petición HTTP personalizados sólo se admiten para peticiones POST
y no para peticiones GET
.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
name : String
Un nombre de encabezado de solicitud HTTP (por ejemplo, Content-Type o SOAPAction). | URLRequestHeader | ||
value : String
El valor asociado a la propiedad name (por ejemplo, text/plain). | URLRequestHeader |
Método | Definido por | ||
---|---|---|---|
Crea un nuevo objeto URLRequestHeader que encapsula un único encabezado de solicitud HTTP. | URLRequestHeader | ||
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 de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
Devuelve la representación de cadena del objeto especificado. | Object | ||
Devuelve el valor simple del objeto especificado. | Object |
name | propiedad |
public var name:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un nombre de encabezado de solicitud HTTP (por ejemplo, Content-Type
o SOAPAction
).
value | propiedad |
public var value:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El valor asociado a la propiedad name
(por ejemplo, text/plain
).
URLRequestHeader | () | Información sobre |
public function URLRequestHeader(name:String = "", value:String = "")
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuevo objeto URLRequestHeader que encapsula un único encabezado de solicitud HTTP. Los objetos URLRequestHeader se utilizan en la propiedad requestHeaders
de la clase URLRequest.
name:String (default = " ") — Un nombre de encabezado de solicitud HTTP (por ejemplo, Content-Type o SOAPAction ).
| |
value:String (default = " ") — El valor asociado a la propiedad name (por ejemplo, text/plain ).
|
header
al conjunto de la propiedad requestHeaders
. El encabezado indica que la aplicación debe reenviar la petición al servidor de origen, incluso si ha capturado una copia de lo que se solicita.
package { import flash.display.Sprite; import flash.events.*; import flash.net.URLLoader; import flash.net.URLRequest; import flash.net.URLRequestHeader; import flash.net.URLRequestMethod; import flash.net.URLVariables; public class URLRequestHeaderExample extends Sprite { private var loader:URLLoader; public function URLRequestHeaderExample() { loader = new URLLoader(); configureListeners(loader); var header:URLRequestHeader = new URLRequestHeader("pragma", "no-cache"); var request:URLRequest = new URLRequest("http://www.[yourdomain].com/greeting.cfm"); request.data = new URLVariables("name=John+Doe"); request.method = URLRequestMethod.POST; request.requestHeaders.push(header); 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); } } }
Tue Jun 12 2018, 02:12 PM Z