Package | flash.net.dns |
Classe | public class DNSResolver |
Héritage | DNSResolver EventDispatcher Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur les périphériques mobiles. Elle est partiellement prise en charge sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété DNSResolver.isSupported
. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.
Vous pouvez rechercher les types d’enregistrements de ressource suivants :
- ARecord : adresse IPv4 pour un hôte.
- AAAARecord : adresse IPv6 pour un hôte.
- MXRecord : enregistrement de courrier Exchange pour un hôte.
- PTRRecord : nom d’hôte pour une adresse IP.
- SRVRecord : enregistrement de service pour un service
Le tableau ci-dessous indique la prise en charge de la recherche DNS sur les périphériques AIR pour TV. Résultats des demandes non prises en charge dans l’objet DNSResolver distribuant un objet flash.events.ErrorEvent.
Type d’enregistrement spécifié dans DNSResolver.lookup()
| Support |
---|---|
ARecord | Prise en charge complète |
AAAARecord | Prise en charge complète |
MXRecord | Non pris en charge |
PTRRecord | Prise en charge uniquement pour les adresses IPv4 et non pour les adresses IPv6 |
SRVRecord | Non pris en charge |
Plus d’exemples
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
isSupported : Boolean [statique] [lecture seule]
Indique si les recherches DNS sont prises en charge sur le système client. | DNSResolver |
Méthode | Défini par | ||
---|---|---|---|
Crée un objet DNSResolver. | DNSResolver | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Recherche un enregistrement de ressource DNS en fonction d’une chaîne de requête. | DNSResolver | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
Evénement | Synthèse | Défini par | ||
---|---|---|---|---|
[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | |||
[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | |||
Distribué lorsqu’une erreur se produit lors d’une recherche DNS. | DNSResolver | |||
Distribué lorsqu’une recherche DNS est terminée. | DNSResolver |
isSupported | propriété |
DNSResolver | () | Constructeur |
public function DNSResolver()
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Crée un objet DNSResolver.
lookup | () | méthode |
public function lookup(host:String, recordType:Class):void
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Recherche un enregistrement de ressource DNS en fonction d’une chaîne de requête.
La méthode lookup()
effectue une recherche DNS de façon asynchrone. Ecoutez l’événement lookup pour obtenir les résultats de la recherche. Ecoutez l’événement error pour recevoir les erreurs. Les résultats sont distribués dans l’objet DNSResolverEvent.
Pour spécifier le type d’enregistrement de ressource à rechercher, transmettez la classe correspondante dans le paramètre recordType
. (Transmettez le nom de la classe lui-même et non pas une chaîne contenant le nom de la classe.)
Le contenu de la chaîne de requête transmis à la méthode dépend du type d’enregistrement de ressource faisant l’objet de la recherche. La liste suivante illustre la chaîne de requête à utiliser pour chaque type d’enregistrement.
Type d’enregistrement | Chaîne de requête | Exemple |
---|---|---|
ARecord | nom d’hôte | "example.com" |
AAAARecord | nom d’hôte | "example.com" |
MXRecord | nom d’hôte | "example.com" |
PTRRecord | adresse IP | "208.77.188.166" |
SRVRecord | _service._protocol.host. | "_sip._tcp.example.com." |
Paramètres
host:String — Chaîne de requête, telle que le nom d’hôte, l’adresse IP ou le localisateur de services.
| |
recordType:Class — Classe représentant le type d’enregistrement de ressource DNS à rechercher.
|
Evénements
lookup: — distribué lorsque la recherche a abouti.
| |
error: — distribué lorsque la recherche a échoué (notamment lorsqu’il n’existe aucun enregistrement).
|
Valeur émise
ArgumentError — La valeur du paramètre host n’est pas une chaîne de requête appropriée ou la classe recordType n’est pas reconnue.
|
Eléments de l’API associés
error | Evénement |
flash.events.ErrorEvent
propriété ErrorEvent.type =
flash.events.ErrorEvent.ERROR
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Distribué lorsqu’une erreur se produit lors d’une recherche DNS.
Définit la valeur de la propriététype
d’un objet d’événement error
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet qui subit l’échec de l’opération réseau. |
text | Texte à afficher en tant que message d’erreur. |
lookup | Evénement |
flash.events.DNSResolverEvent
propriété DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2 |
Distribué lorsqu’une recherche DNS est terminée.
Définit la valeur de la propriététype
d’un objet d’événement lookup
.
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, 09:30 AM Z