| Pacote | flash.events |
| Classe | public class HTTPStatusEvent |
| Herança | HTTPStatusEvent  Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Objetos HTTPStatusEvent são sempre despachados antes de eventos de erro ou conclusão. Um objeto HTTPStatusEvent não indica necessariamente uma condição de erro; simplesmente reflete o código de status HTTP (se houver algum) fornecido pela pilha de rede. Alguns ambientes Flash Player talvez não consigam detectar códigos de status HTTP; um código de status de 0 é sempre reportado nesses casos.
No Flash Player, há somente um tipo de evento HTTPStatus: httpStatus. No tempo de execução do AIR, um FileReference, URLLoader ou URLStream pode se registrar para ouvir um httpResponseStatus, que inclui as propriedades responseURL e responseHeaders. Essas propriedades estão indefinidas em um evento httpStatus.
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
| cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| redirected : Boolean
Indica se a solicitação foi redirecionada. | HTTPStatusEvent | ||
| responseHeaders : Array
Os cabeçalhos de resposta que a resposta retornou, como uma matriz de objetos URLRequestHeader. | HTTPStatusEvent | ||
| responseURL : String
O URL do qual a resposta foi retornada. | HTTPStatusEvent | ||
| status : int [somente leitura]
O código de status HTTP retornado pelo servidor. | HTTPStatusEvent | ||
| target : Object [somente leitura]
O destino de evento. | Event | |
| type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Cria um objeto Event que contém informações específicas sobre eventos de status http. | HTTPStatusEvent | ||
[substituir]
Cria uma cópia do objeto HTTPStatusEvent e define o valor de cada propriedade para corresponder ao do original. | HTTPStatusEvent | ||
|
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Verifica se o método preventDefault() foi chamado no evento. | Event | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
|
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto HTTPStatusEvent. | HTTPStatusEvent | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [estático]
Ao contrário do evento httpStatus, o evento httpResponseStatus é entregue antes de qualquer dado de resposta. | HTTPStatusEvent | ||
| HTTP_STATUS : String = "httpStatus" [estático]
A constante HTTPStatusEvent.HTTP_STATUS define o valor da propriedade type de um objeto de evento httpStatus. | HTTPStatusEvent | ||
redirected | propriedade |
responseHeaders | propriedade |
responseHeaders:Array| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Os cabeçalhos de resposta que a resposta retornou, como uma matriz de objetos URLRequestHeader.
Implementação
public function get responseHeaders():Array public function set responseHeaders(value:Array):voidElementos da API relacionados
responseURL | propriedade |
responseURL:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
O URL do qual a resposta foi retornada. No caso de redirecionamentos, isso será diferente da solicitação de URL.
Implementação
public function get responseURL():String public function set responseURL(value:String):voidstatus | propriedade |
status:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O código de status HTTP retornado pelo servidor. Por exemplo, um valor de 404 indica que o servidor não localizou uma correspondência para o URI solicitado. Os códigos de status de HTTP podem ser encontrados nas seções 10.4 e 10.5 da especificação HTTP em http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Se o Flash Player ou AIR não puder obter um código de status do servidor ou se não puder se comunicar com o servidor, o valor padrão de 0 será transmitido para seu código. Um valor 0 pode ser gerado em qualquer player (por exemplo, se um URL malformado for solicitado), e um valor 0 é sempre gerado pelo plug-in Flash Player quando ele é executado nos seguintes navegadores, que não transmitem códigos de status HTTP para o player: Netscape, Mozilla, Safari, Opera e Internet Explorer para Macintosh.
Implementação
public function get status():intHTTPStatusEvent | () | Construtor |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um objeto Event que contém informações específicas sobre eventos de status http. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
Parâmetrostype:String — O tipo de evento. Ouvintes de eventos podem acessar essas informações por meio da propriedade type herdada. Só existe um tipo de evento HTTPStatus: HTTPStatusEvent.HTTP_STATUS.
| |
bubbles:Boolean (default = false)bubbles herdada.
| |
cancelable:Boolean (default = false)cancelable herdada.
| |
status:int (default = 0)status.
| |
redirected:Boolean (default = false)redirecionado.
|
Elementos da API relacionados
clone | () | método |
override public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria uma cópia do objeto HTTPStatusEvent e define o valor de cada propriedade para corresponder ao do original.
RetornaEvent — Um novo objeto HTTPStatusEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma string que contém todas as propriedades do objeto HTTPStatusEvent. A string está no seguinte formato:
[HTTPStatusEvent type=value bubbles=value cancelable=value status=value]
String — Uma string que contém todas as propriedades do objeto HTTPStatusEvent.
|
HTTP_RESPONSE_STATUS | Constante |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Ao contrário do evento httpStatus, o evento httpResponseStatus é entregue antes de qualquer dado de resposta. O evento httpResponseStatus inclui valores para as propriedades responseHeaders e responseURL (que estão indefinidas para um evento httpStatus. Observe que o evento httpResponseStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.
A constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define o valor da propriedade type de um objeto de evento httpResponseStatus.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
responseURL | O URL do qual a resposta foi retornada. |
responseHeaders | Os cabeçalhos de resposta que a resposta retornou, como uma matriz de objetos URLRequestHeader. |
status | O código de status HTTP retornado pelo servidor. |
redirecionado | Se a resposta for o resultado de um redirecionamento. |
target | O objeto de rede que recebe o código de status HTTP. |
Elementos da API relacionados
HTTP_STATUS | Constante |
public static const HTTP_STATUS:String = "httpStatus"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante HTTPStatusEvent.HTTP_STATUS define o valor da propriedade type de um objeto de evento httpStatus.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
status | O código de status HTTP retornado pelo servidor. |
target | O objeto de rede que recebe o código de status HTTP. |
Elementos da API relacionados
httpStatusHandler com um status de 404, indicando que o arquivo não foi localizado. O evento httpStatusHandler é manipulado pelo httpStatusHandler(), que simplesmente imprime duas linhas de informações sobre o evento.
Observações:
- Você precisa compilar o arquivo SWF com "Segurança de reprodução local" definida como "Acessar somente a rede" para gerar um evento
securityErrorneste exemplo. - Você precisa de um servidor em execução em http://www.[yourDomain].com e escuta na porta 80 ou você receberá um evento
httpStatusHandlercom código de status 0 em vez de 404. - Você não deve ter um arquivo com o nome MissingFile.html no diretório web raiz de http://www.[yourDomain].com ou você não receberá o evento
httpStatusHandlercorreto.
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);
}
}
}
Wed Jun 13 2018, 11:10 AM Z