| Paquete | flash.net.dns |
| Clase | public class DNSResolver |
| Herencia | DNSResolver  EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos móviles. No se admite parcialmente en dispositivos de AIR para TV. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad DNSResolver.isSupported. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Puede buscar los siguientes tipos de registros de recursos:
- ARecord: dirección IPv4 para un host.
- AAAARecord: dirección IPv6 para un host.
- MXRecord: registro de intercambio de correo para un host.
- PTRRecord: nombre del host para una dirección IP.
- SRVRecord: registro de servicio para un servicio
En la siguiente tabla se indica la compatibilidad de búsqueda DNS en dispositivos de AIR para TV. Las peticiones no admitidas hacen que el objeto DNSResolver distribuya un objeto flash.events.ErrorEvent.
Tipo de registro especificado en DNSResolver.lookup()
| Soporte |
|---|---|
| ARecord | Total compatibilidad |
| AAAARecord | Total compatibilidad |
| MXRecord | No se admite |
| PTRRecord | Se admite sólo para las direcciones IPv4, no para las direcciones IPv6 |
| SRVRecord | No se admite |
Elementos de API relacionados
Propiedades públicas
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| isSupported : Boolean [estática] [solo lectura]
Indica si las búsquedas DNS se admiten en el sistema del cliente. | DNSResolver | ||
Métodos públicos
| Método | Definido por | ||
|---|---|---|---|
Crea un objeto DNSResolverDNSResolver. | DNSResolver | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Busca un registro de recursos DNS basado en una cadena de consulta. | DNSResolver | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Elimina un detector del objeto EventDispatcher. | EventDispatcher | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
Eventos
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | ||
| [evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | ||
| Se distribuye cuando se produce un error durante una búsqueda DNS. | DNSResolver | |||
| Se distribuye cuando finaliza una búsqueda DNS. | DNSResolver | |||
Información sobre propiedades
isSupported | propiedad |
Información sobre constructores
DNSResolver | () | Información sobre |
public function DNSResolver()| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Crea un objeto DNSResolverDNSResolver.
Información sobre métodos
lookup | () | método |
public function lookup(host:String, recordType:Class):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Busca un registro de recursos DNS basado en una cadena de consulta.
El método lookup() lleva a cabo una búsqueda DNS asíncrona. Detecte el evento de búsqueda para obtener los resultados de la búsqueda. Detecte el evento de error para recibir errores. Los resultados se distribuyen en un objeto DNSResolverEvent.
Para especificar el tipo de registro de recursos que se busca, transfiera la clase correspondiente en el parámetro recordType. (Transfiera el nombre de clase y no una cadena que lo contenga.)
El contenido de la cadena de consulta que se transfiere al método depende del tipo de registro de recursos que se busque. La siguiente lista ilustra la cadena de consulta para utilizar con cada tipo de registro.
| Tipo de registro | Cadena de consulta | Ejemplo |
|---|---|---|
| ARecord | nombre del host | "example.com" |
| AAAARecord | nombre del host | "example.com" |
| MXRecord | nombre del host | "example.com" |
| PTRRecord | Dirección IP | "208.77.188.166" |
| SRVRecord | _service._protocol.host. | "_sip._tcp.example.com." |
Parámetros
host:String — la cadena de consulta, como por ejemplo, un nombre de host, una dirección IP o un servicio localizador.
| |
recordType:Class — La clase que representa el tipo de registro de recursos DNS que se busca.
|
Eventos
lookup: — se distribuye cuando la búsqueda se ha completado correctamente.
| |
error: — se distribuye cuando falla la búsqueda (incluso cuando no existen registros).
|
Emite
ArgumentError — El valor del parámetro host no es el una cadena de consulta adecuada o la clase recordType no se reconoce.
|
Elementos de API relacionados
Información sobre eventos
error | Evento |
Tipo de objeto de evento:
propiedad ErrorEvent.type =
flash.events.ErrorEventpropiedad ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Se distribuye cuando se produce un error durante una búsqueda DNS.
Define el valor de la propiedadtype de un objeto de evento error.
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. |
target | El objeto en el que se produce un error de operación de red. |
text | Texto que se mostrará como mensaje de error. |
lookup | Evento |
Tipo de objeto de evento:
propiedad DNSResolverEvent.type =
flash.events.DNSResolverEventpropiedad DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Se distribuye cuando finaliza una búsqueda DNS.
Define el valor de la propiedadtype de un objeto de evento lookup.
Ejemplos Cómo utilizar este ejemplo
DNSResolverExample.as
En el ejemplo siguiente, se muestra cómo buscar los tipos admitidos de registros 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 );
}
}
}
Tue Jun 12 2018, 02:12 PM Z