| Pacchetto | flash.net.dns |
| Classe | public class DNSResolver |
| Ereditarietà | DNSResolver  EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop ma non nei dispositivi mobili. Inoltre, è parzialmente supportato nei dispositivi AIR per TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà DNSResolver.isSupported. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Potete cercare i seguenti tipi di record di risorsa:
- ARecord: indirizzo IPv4 per un host.
- AAAARecord: indirizzo IPv6 per un host.
- MXRecord: record mail exchange (MX) per un host.
- PTRRecord: nome host per un indirizzo IP.
- SRVRecord: record di servizio per un servizio
La tabella seguente indica il supporto della ricerca DNS nei dispositivi AIR per TV. Le richieste non supportate determinano l'invio di un oggetto flash.events.ErrorEvent da parte dell'oggetto DNSResolver.
Tipo di record specificato in DNSResolver.lookup()
| Supporto |
|---|---|
| ARecord | Supporto completo |
| AAAARecord | Supporto completo |
| MXRecord | Non supportati |
| PTRRecord | Supportato solo per gli indirizzi IPv4 e non per quelli IPv6 |
| SRVRecord | Non supportati |
Altri esempi
Elementi API correlati
Proprietà pubbliche
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
Indica se le ricerche DNS sono supportate nel sistema client. | DNSResolver | ||
Metodi pubblici
| Metodo | Definito da | ||
|---|---|---|---|
Crea un oggetto DNSResolver. | DNSResolver | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Ricerca un record di risorsa DNS in base a una stringa di query. | DNSResolver | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
Eventi
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato quando si è verifica un errore durante una ricerca DNS. | DNSResolver | |||
| Inviato quando una ricerca DNS è stata completata. | DNSResolver | |||
Descrizione delle proprietà
isSupported | proprietà |
Descrizione della funzione di costruzione
DNSResolver | () | Funzione di costruzione |
public function DNSResolver()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Crea un oggetto DNSResolver.
Descrizione dei metodi
lookup | () | metodo |
public function lookup(host:String, recordType:Class):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Ricerca un record di risorsa DNS in base a una stringa di query.
Il metodo lookup() esegue una ricerca DNS in modo asincrono. Intercettate l'evento di ricerca per ottenere i risultati della ricerca. Intercettate l'evento di errore per ricevere gli errori. I risultati vengono inviati in un oggetto DNSResolverEvent.
Per specificare il tipo di record di risorsa da cercare, passate la classe corrispondente nel parametro recordType. (Passate il nome stesso della classe, non una stringa contenente il nome della classe).
Il contenuto della stringa di query passata al metodo dipende dal tipo di record di risorsa che state cercando. Nell'elenco seguente è illustrata la stringa di query da utilizzare per ogni tipo di record.
| Tipo di record | Stringa di query | Esempio |
|---|---|---|
| ARecord | Nome host | "example.com" |
| AAAARecord | Nome host | "example.com" |
| MXRecord | Nome host | "example.com" |
| PTRRecord | Indirizzo IP | "208.77.188.166" |
| SRVRecord | _service._protocol.host. | "_sip._tcp.example.com." |
Parametri
host:String — La stringa di query, ad esempio un nome host, un indirizzo IP o un Service Locator.
| |
recordType:Class — La classe che rappresenta il tipo di record di risorsa DNS da cercare.
|
Eventi
lookup: — Inviato quando la ricerca è stata completata correttamente.
| |
error: — Inviato quando la ricerca ha esito negativo (incluso il caso in cui non esistano record).
|
Genera
ArgumentError — Il valore del parametro host non è una stringa di query appropriata oppure la classe recordType non è stata riconosciuta.
|
Elementi API correlati
Descrizione degli eventi
error | Evento |
Tipo di oggetto evento:
proprietà ErrorEvent.type =
flash.events.ErrorEventproprietà ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Inviato quando si è verifica un errore durante una ricerca DNS.
Definisce il valore della proprietàtype di un oggetto evento error.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto interessato da un errore di funzionamento di rete. |
text | Testo da visualizzare come messaggio di errore. |
lookup | Evento |
Tipo di oggetto evento:
proprietà DNSResolverEvent.type =
flash.events.DNSResolverEventproprietà DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Inviato quando una ricerca DNS è stata completata.
Definisce il valore della proprietàtype di un oggetto evento lookup.
DNSResolverExample.as
L'esempio seguente mostra come verificare i tipi di record DNS supportati:
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 );
}
}
}
Tue Jun 12 2018, 02:44 PM Z