| Pacote | flash.net.dns |
| Classe | public class DNSResolver |
| Herança | DNSResolver  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Suporte a perfil do AIR: esse recurso possui suporte para todos os sistemas operacionais de computador, mas não tem suporte para dispositivos móveis. Há suporte parcial em dispositivos AIR for TV. Você pode testar o suporte para tempo de execução utilizando a propriedadeDNSResolver.isSupported. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Você pode pesquisar os seguintes tipos de registros de recurso:
- ARecord: endereço IPv4 para um host.
- AAAARecord: endereço IPv6 para um host.
- MXRecord: registro de troca de correio para um host.
- PTRRecord: nome de host de um endereço IP.
- SRVRecord: registro de serviço para um serviço
A tabela a seguir indica o suporte a busca DNS em dispositivos AIR for TV. As solicitações sem suporte resultam na emissão pelo objeto DNSResolver de um objeto flash.events.ErrorEvent.
Tipo de registo especificado em DNSResolver.lookup()
| Suporte |
|---|---|
| ARecord | Suporte total |
| AAAARecord | Suporte total |
| MXRecord | Sem suporte |
| PTRRecord | Compatível somente com endereços IPv4, e não com endereços IPv6 |
| SRVRecord | Sem suporte |
Elementos da API relacionados
Propriedades públicas
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| isSupported : Boolean [estático] [somente leitura]
Indica se as buscas de DNS são suportadas no sistema cliente. | DNSResolver | ||
Métodos públicos
| Método | Definido por | ||
|---|---|---|---|
Cria um objeto DNSResolver. | DNSResolver | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | |
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Procura um registro de recurso DNS com base em uma string de consulta. | DNSResolver | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher | |
Eventos
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| [transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | ||
| Despachado quando um erro ocorreu durante uma busca DNS. | DNSResolver | |||
| Despachado quando uma busca DNS é concluída. | DNSResolver | |||
Detalhes da propriedade
isSupported | propriedade |
Detalhes do construtor
DNSResolver | () | Construtor |
public function DNSResolver()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Cria um objeto DNSResolver.
Detalhes do método
lookup | () | método |
public function lookup(host:String, recordType:Class):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Procura um registro de recurso DNS com base em uma string de consulta.
O método lookup() realiza uma pesquisa DNS assincronamente. Escute o evento de busca para adquirir os resultados da pesquisa. Escute o evento de erro para receber erros. Os resultados são despachados em um objeto DNSResolverEvent.
Para especificar o tipo do registro de recurso para pesquisar, passe a classe correspondente no parâmetro recordType. (Passe o próprio nome da classe e não uma string que contém o nome da classe.)
O conteúdo da string de consulta passado ao método depende do tipo do registro de recurso que é procurado. A seguinte lista ilustra a string de consulta a ser usada para cada tipo de registro.
| Tipo de registro | String de consulta | Exemplo |
|---|---|---|
| ARecord | nome de host | "exemplo.com" |
| AAAARecord | nome de host | "exemplo.com" |
| MXRecord | nome de host | "exemplo.com" |
| PTRRecord | Endereço IP | "208.77.188.166" |
| SRVRecord | _service._protocol.host. | "_sip._tcp.example.com." |
Parâmetros
host:String — a string de consulta, como um nome de host, endereço IP, ou localizador de serviço.
| |
recordType:Class — A classe que representa o tipo de registro de recurso DNS para pesquisar.
|
Eventos
lookup: — despachado quando a busca é concluída com sucesso.
| |
error: — despachado quando a busca falha (inclusive quando nenhum registro existe).
|
Lança
ArgumentError — O valor do parâmetro host não é uma string de consulta apropriada, ou a classe recordType não é reconhecida.
|
Elementos da API relacionados
Detalhe do evento
error | Evento |
Tipo do objeto de evento:
propriedade ErrorEvent.type =
flash.events.ErrorEventpropriedade ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Despachado quando um erro ocorreu durante uma busca DNS.
Define o valor da propriedadetype de um objeto de evento error.
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. |
target | O objeto que está passando por uma falha de operação na rede. |
text | Texto a ser exibido como uma mensagem de erro. |
lookup | Evento |
Tipo do objeto de evento:
propriedade DNSResolverEvent.type =
flash.events.DNSResolverEventpropriedade DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Despachado quando uma busca DNS é concluída.
Define o valor da propriedadetype de um objeto de evento lookup.
Exemplos Como usar este exemplo
DNSResolverExample.as
O exemplo a seguir mostra como buscar os tipos suportados de registros de DNS:
package
{
import flash.desktop.NativeApplication;
import flash.display.Sprite;
import flash.events.DNSResolverEvent;
import flash.events.ErrorEvent;
import flash.events.Event;
import flash.events.MouseEvent;
import flash.net.dns.AAAARecord;
import flash.net.dns.ARecord;
import flash.net.dns.DNSResolver;
import flash.net.dns.MXRecord;
import flash.net.dns.PTRRecord;
import flash.net.dns.SRVRecord;
import flash.utils.getQualifiedClassName;
public class DNSResolverExample extends Sprite
{
private var resolver:DNSResolver = new DNSResolver();
public function DNSResolverExample()
{
resolver.addEventListener( DNSResolverEvent.LOOKUP, lookupComplete );
resolver.addEventListener( ErrorEvent.ERROR, lookupError );
//Look up records
resolver.lookup( "www.example.com", ARecord );
resolver.lookup( "example.com", AAAARecord );
resolver.lookup( "example.com", MXRecord );
resolver.lookup( "208.77.188.166", PTRRecord );
resolver.lookup( "127.0.0.1", PTRRecord );
resolver.lookup( "2001:1890:110b:1e19:f06b:72db:7026:3d7a", PTRRecord );
resolver.lookup( "_sip._tcp.example.com.", SRVRecord );
resolver.lookup( "www.example.com", ARecord );
this.stage.nativeWindow.activate();
}
private function lookupComplete( event:DNSResolverEvent ):void
{
trace( "Query string: " + event.host );
trace( "Record type: " + flash.utils.getQualifiedClassName( event.resourceRecords[0] ) +
", count: " + event.resourceRecords.length );
for each( var record in event.resourceRecords )
{
if( record is ARecord ) trace( record.name + " : " + record.address );
if( record is AAAARecord ) trace( record.name + " : " + record.address );
if( record is MXRecord ) trace( record.name + " : " + record.exchange + ", " + record.preference );
if( record is PTRRecord ) trace( record.name + " : " + record.ptrdName );
if( record is SRVRecord ) trace( record.name + " : " + record.target + ", " + record.port +
", " + record.priority + ", " + record.weight );
}
}
private function lookupError( error:ErrorEvent ):void
{
trace("Error: " + error.text );
}
}
}
Wed Jun 13 2018, 11:10 AM Z