Paquete | flash.events |
Clase | public class HTTPStatusEvent |
Herencia | HTTPStatusEvent Event Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Los objetos HTTPStatusEvent siempre se envían antes de los eventos de error o de finalización. Un HTTPStatusEvent no indica necesariamente una situación de error; simplemente refleja el código de estado HTTP (si existe) proporcionado por la pila de la red. Es posible que algunos entornos de Flash Player no puedan detectar códigos de estado HTTP; en ese caso, siempre se emite un código de estado con valor 0.
En Flash Player, sólo hay un tipo de evento HTTPStatus: httpStatus
. En el motor de ejecución de AIR, se puede registrar un objeto FileReference, URLLoader o URLStream para que detecte un evento httpResponseStatus
, que incluye las propiedades responseURL
y responseHeaders
. Estas propiedades son undefined en un evento httpStatus
.
Propiedad | Definido por | ||
---|---|---|---|
bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | ||
cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | ||
eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | ||
redirected : Boolean
Indica si la solicitud se ha redirigido. | HTTPStatusEvent | ||
responseHeaders : Array
Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader. | HTTPStatusEvent | ||
responseURL : String
URL desde la que se devolvió la respuesta. | HTTPStatusEvent | ||
status : int [solo lectura]
El código de estado HTTP que devuelve el servidor. | HTTPStatusEvent | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
type : String [solo lectura]
El tipo de evento. | Event |
Método | Definido por | ||
---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Crea un objeto de evento que contiene información concreta sobre eventos de estado HTTP. | HTTPStatusEvent | ||
[override]
Crea una copia del objeto HTTPStatusEvent y define el valor de cada propiedad para que coincida con el del objeto original. | HTTPStatusEvent | ||
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Comprueba si se ha llamado a preventDefault() en el evento. | Event | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | ||
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
Devuelve una cadena con todas las propiedades del objeto HTTPStatusEvent. | HTTPStatusEvent | ||
Devuelve el valor simple del objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [estática]
Al contrario que httpStatus, el evento httpResponseStatus se envía antes de cualquier dato de respuesta. | HTTPStatusEvent | ||
HTTP_STATUS : String = "httpStatus" [estática]
La constante HTTPStatusEvent.HTTP_STATUS define el valor de la propiedad type de un objeto de evento httpStatus. | HTTPStatusEvent |
redirected | propiedad |
responseHeaders | propiedad |
responseHeaders:Array
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader.
Implementación
public function get responseHeaders():Array
public function set responseHeaders(value:Array):void
Elementos de API relacionados
responseURL | propiedad |
responseURL:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
URL desde la que se devolvió la respuesta. En el caso de redirecciones, no coincide con la petición de URL.
Implementación
public function get responseURL():String
public function set responseURL(value:String):void
status | propiedad |
status:int
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El código de estado HTTP que devuelve el servidor. Por ejemplo, 404 indica que el servidor no encontró nada que coincida con el URI solicitado. Los códigos de estado HTTP se encuentran en las secciones 10.4 y 10.5 de la especificación HTTP en http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Si Flash Player o AIR no puede obtener el código de estado del servidor o si no puede comunicarse con el servidor, se pasa el valor predeterminado 0 al código. Es posible generar un valor 0 en cualquier reproductor (por ejemplo, si se solicita una dirección URL mal formada) y el plug-in de Flash Player siempre genera un valor 0 cuando se ejecuta en los navegadores siguientes, ya que no pasan códigos de estado HTTP al reproductor: Netscape, Mozilla, Safari, Opera e Internet Explorer para Macintosh.
Implementación
public function get status():int
HTTPStatusEvent | () | Información sobre |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un objeto de evento que contiene información concreta sobre eventos de estado HTTP. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type heredada. Sólo hay un tipo de evento HTTPStatus: HTTPStatusEvent.HTTP_STATUS .
| |
bubbles:Boolean (default = false ) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad bubbles heredada.
| |
cancelable:Boolean (default = false ) — Determina si se puede cancelar el objeto Event. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable heredada.
| |
status:int (default = 0 ) — Estado numérico. Los detectores de eventos pueden acceder a esta información a través de la propiedad status .
| |
redirected:Boolean (default = false ) — Indica si la solicitud se ha redirigido. Los detectores de eventos pueden acceder a esta información a través de la propiedad redirected .
|
Elementos de API relacionados
clone | () | método |
override public function clone():Event
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea una copia del objeto HTTPStatusEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto HTTPStatusEvent con valores de propiedades que coinciden con los del objeto original.
|
toString | () | método |
override public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve una cadena con todas las propiedades del objeto HTTPStatusEvent. La cadena tiene el siguiente formato:
[HTTPStatusEvent type=value bubbles=value cancelable=value status=value]
String — Una cadena que contiene todas las propiedades del objeto HTTPStatusEvent.
|
HTTP_RESPONSE_STATUS | Constante |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Al contrario que httpStatus
, el evento httpResponseStatus
se envía antes de cualquier dato de respuesta. Asimismo, el evento httpResponseStatus
incluye valores para las propiedades responseHeaders
y responseURL
(que son undefined en un evento httpStatus
). Tenga en cuenta que se enviará el evento httpResponseStatus
(si existe) antes que (y además de) cualquier evento complete
o error
.
La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS
define el valor de la propiedad type
de un objeto de evento httpResponseStatus
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
responseURL | URL desde la que se devolvió la respuesta. |
responseHeaders | Encabezados de respuesta devueltos por la respuesta como un conjunto de objeto URLRequestHeader. |
status | El código de estado HTTP que devuelve el servidor. |
redirected | Indica si la respuesta es el resultado de una redirección. |
target | El objeto de red que recibe el código de estado HTTP. |
Elementos de API relacionados
HTTP_STATUS | Constante |
public static const HTTP_STATUS:String = "httpStatus"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La constante HTTPStatusEvent.HTTP_STATUS
define el valor de la propiedad type
de un objeto de evento httpStatus
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
status | El código de estado HTTP que devuelve el servidor. |
target | El objeto de red que recibe el código de estado HTTP. |
Elementos de API relacionados
httpStatusHandler
con estado 404 para indicar que no se ha podido encontrar el archivo. El evento httpStatusHandler
se gestiona con httpStatusHandler()
, que simplemente imprime dos líneas de información sobre el evento.
Notas:
- Necesitará compilar el archivo SWF con la opción "Seguridad de reproducción local" establecida como "Acceso sólo a la red" para generar un evento
securityError
en este ejemplo. - Necesitará un servidor ejecutándose en http://www.[yourDomain].com y detectando en el puerto 80; de lo contrario, recibirá un evento
httpStatusHandler
con código de estado 0 en vez de 404. - No debe tener ningún archivo llamado MissingFile.html en el directorio raíz web de http://www.[yourDomain].com; de lo contrario no recibirá el evento
httpStatusHandler
correcto.
package { import flash.display.Sprite; import flash.net.URLLoader; import flash.net.URLRequest; import flash.events.HTTPStatusEvent; public class HTTPStatusEventExample extends Sprite { public function HTTPStatusEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html"); loader.load(request); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); trace("status: " + event.status); } } }
Tue Jun 12 2018, 02:12 PM Z