| Pakiet | flash.net.dns |
| Klasa | public class DNSResolver |
| Dziedziczenie | DNSResolver  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Obsługa profilów aplikacji AIR: Ta funkcja jest obsługiwana na wszystkich stacjonarnych systemach operacyjnych, ale nie jest obsługiwana na urządzeniach mobilnych. Jest częściowo obsługiwana na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość DNSResolver.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Istnieje możliwość wyszukiwania następujących typów rekordów zasobów:
- ARecord: adres IPv4 hosta.
- AAAARecord: adres IPv6 hosta.
- MXRecord: rekord wymiany poczty hosta.
- PTRRecord: nazwa hosta dla adresu IP.
- SRVRecord: rekord usługi.
W następującej tabeli podano, które urządzenia telewizyjne ze środowiskiem AIR obsługują wyszukiwanie DNS. Nieobsługiwane żądania powodują, że obiekt DNSResolver wywołuje obiekt flash.events.ErrorEvent.
Typ rekordu określony w metodzie DNSResolver.lookup()
| Obsługa |
|---|---|
| ARecord | Pełna obsługa |
| AAAARecord | Pełna obsługa |
| MXRecord | Brak obsługi |
| PTRRecord | Obsługa tylko w przypadku adresów IPv4; brak obsługi dla adresów IPv6 |
| SRVRecord | Brak obsługi |
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| isSupported : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy na systemie klienckim jest obsługiwane wyszukiwanie DNS. | DNSResolver | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy obiekt DNSResolver. | DNSResolver | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Wyszukuje rekord zasobu DNS na podstawie ciągu znaków zapytania. | DNSResolver | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane, gdy w trakcie wyszukiwania DNS wystąpi błąd. | DNSResolver | |||
| Wywoływane po zakończeniu wyszukiwania DNS. | DNSResolver | |||
isSupported | właściwość |
DNSResolver | () | Konstruktor |
public function DNSResolver()| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Tworzy obiekt DNSResolver.
lookup | () | metoda |
public function lookup(host:String, recordType:Class):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Wyszukuje rekord zasobu DNS na podstawie ciągu znaków zapytania.
Metoda lookup() przeprowadza wyszukiwanie DNS w sposób asynchroniczny. Aby odebrać wyniki wyszukiwania, należy wykrywać zdarzenie lookup. Aby odbierać informacje o błędach, należy wykrywać zdarzenie error. Wyniki przekazywane są w obiekcie zdarzenia DNSResolverEvent.
Aby określić typ rekordu zasobu do wyszukiwania, należy przekazać odpowiednią klasę w parametrze recordType. (Należy przekazać wprost nazwę klasy, a nie ciąg znaków zawierający nazwę klasy.)
Treść ciągu znaków zapytania przekazanego do metody zależy od typu wyszukiwanego zasobu. Na poniższej liście podano przykłady ciągów znaków zapytania odpowiednich dla poszczególnych typów rekordów.
| Typ rekordu | Ciąg znaków zapytania | Przykład |
|---|---|---|
| ARecord | nazwa hosta | "example.com" |
| AAAARecord | nazwa hosta | "example.com" |
| MXRecord | nazwa hosta | "example.com" |
| PTRRecord | adres IP | "208.77.188.166" |
| SRVRecord | _usługa._protokół.host. | "_sip._tcp.example.com." |
Parametry
host:String — Ciąg znaków zapytania, taki jak nazwa hosta, adres IP lub lokalizacja usługi.
| |
recordType:Class — Klasa reprezentująca typ wyszukiwanego rekordu DNS.
|
Zdarzenia
lookup: — Wywoływane po pomyślnym zakończeniu wyszukiwania.
| |
error: — Wywoływane, gdy wyszukiwanie nie powiedzie się (także w przypadku, gdy nie istnieją odpowiednie rekordy).
|
Zgłasza
ArgumentError — Wartość parametru host nie jest dokładnym ciągiem znaków zapytania lub nie rozpoznano klasy recordType.
|
Powiązane elementy interfejsu API
error | Zdarzenie |
flash.events.ErrorEventwłaściwość ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Wywoływane, gdy w trakcie wyszukiwania DNS wystąpi błąd.
Definiuje wartość właściwościtype obiektu zdarzenia error.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt, w którym wystąpiło niepowodzenie operacji sieciowej. |
text | Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. |
lookup | Zdarzenie |
flash.events.DNSResolverEventwłaściwość DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2 |
Wywoływane po zakończeniu wyszukiwania DNS.
Definiuje wartość właściwościtype obiektu zdarzenia 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, 12:06 PM Z