flash.net.dnsAAAARecord Класс AAAARecord представляет запись ресурса AAAA системы доменных имен (DNS), содержащую адрес IPv6.flash.net.dns:ResourceRecord Класс AAAARecord представляет запись ресурса AAAA системы доменных имен (DNS), содержащую адрес IPv6.

Записи ресурсов AAAA возвращаются объектом DNSResolver в результате поиска DNS для определения имени домена.

Класс DNSResolverКласс ARecordКласс SRVRecordКласс MXRecordКласс PTRRecordAAAARecord Создает запись ресурса AAAA. Создает запись ресурса AAAA.

Записи AAAA получаются в результате поиска DNS с использованием класса DNSResolver. Код приложения не должен создавать объекты AAAARecord.

address Адрес IPv6.String Адрес IPv6.
PTRRecord Класс PTRRecord представляет запись ресурса PTR системы доменных имен (DNS), содержащую каноническое имя домена.flash.net.dns:ResourceRecord Класс PTRRecord представляет запись ресурса PTR системы доменных имен (DNS), содержащую каноническое имя домена.

Записи ресурсов PTR возвращаются объектом DNSResolver в результате поиска DNS для определения IP-адреса.

Класс DNSResolverКласс ARecordКласс AAAARecordКласс MXRecordКласс SRVRecordPTRRecord Создает запись ресурса PTR. Создает запись ресурса PTR.

Записи PTR получаются в результате поиска DNS с использованием класса DNSResolver. Код приложения не должен создавать объекты PTRRecord.

ptrdName Каноническое имя домена, назначенное IP-адресу запроса.String Каноническое имя домена, назначенное IP-адресу запроса.
ResourceRecord Класс ResourceRecord является базовым классом для классов записей ресурсов DNS.Object Класс ResourceRecord является базовым классом для классов записей ресурсов DNS.

Записи ресурсов DNS возвращаются объектом DNSResolver в результате поиска DNS.

Класс DNSResolvername Строка запроса, используемая для поиска данной записи ресурса.String Строка запроса, используемая для поиска данной записи ресурса. ttl Значение времени существования ресурса.int Значение времени существования ресурса.

Отрезок времени (в секундах), в течение которого запись ресурса является действительной. Записи не должны сохраняться в кэше дольше этого значения. Если время существования равно нулю, значит запись ресурса не следует сохранять в кэше. Если время существования меньше нуля, значит запись ресурса недействительна.

DNSResolver Класс DNSResolver позволяет выполнять поиск записей ресурсов DNS.flash.events:EventDispatcher Класс DNSResolver позволяет выполнять поиск записей ресурсов DNS.

Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах, но не поддерживается на мобильных устройствах. Частично поддерживается в среде AIR для телевизионных устройств. Используйте свойство DNSResolver.isSupported, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».

Можно выполнять поиск следующих записей ресурсов:

  • ARecord: IPv4-адрес для хоста
  • AAAARecord: IPv6-адрес для хоста
  • MXRecord: запись почтового обменника для хоста
  • PTRRecord: имя хоста для IP-адреса
  • SRVRecord: запись обслуживания для службы

В следующей таблице показана поддержка поиска DNS в среде AIR для телевизионных устройств. Неподдерживаемые запросы приводят к отправке объекта flash.events.ErrorEvent объектом DNSResolver.

Тип записи, указанный в DNSResolver.lookup()ПоддержкаARecordПолная поддержкаAAAARecordПолная поддержкаMXRecordНе поддерживаетсяPTRRecordПоддерживается только для адресов IPv4, но не для адресов IPv6SRVRecordНе поддерживается
Следующий пример демонстрирует поиск поддерживаемых типов записей 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 ); } } }
ARecordAAAARecordMXRecordPTRRecordSRVRecorderror Отправляется, когда возникает ошибка при поиске DNS.flash.events.ErrorEvent.ERRORflash.events.ErrorEvent Отправляется, когда возникает ошибка при поиске DNS. lookup Отправляется после завершения поиска DNS.flash.events.DNSResolverEvent.LOOKUPflash.events.DNSResolverEvent Отправляется после завершения поиска DNS. DNSResolver Создает объект DNSResolver. Создает объект DNSResolver. lookup Выполняет поиск записи ресурса DNS на основе строки запроса.Значение параметра host не является допустимой строкой запроса или класс recordType не распознается. ArgumentErrorArgumentErrorhostStringстрока запроса, например имя хоста, IP-адрес или указатель службы. recordTypeClassКласс, представляющий тип записи ресурса DNS для поиска. Выполняет поиск записи ресурса DNS на основе строки запроса.

Метод lookup() выполняет поиск DNS в асинхронном режиме. Чтобы получить результаты поиска необходимо прослушивать события поиска. Для получения ошибок необходимо прослушивать события ошибок. Результаты отправляются в объекте DNSResolverEvent.

Чтобы определить тип записи ресурса для поиска, передайте соответствующий класс в параметре recordType. (Передайте само имя класса непосредственно, а не содержащую его строку.)

Содержимое строки запроса, передаваемое методу, зависит от типа искомой записи ресурса. В следующей таблице приводится пример строки запроса для каждого типа записи.

Тип записиСтрока запросаПримерARecordимя хоста"example.com"AAAARecordимя хоста"example.com"MXRecordимя хоста"example.com"PTRRecordIP-адрес"208.77.188.166"SRVRecord_service._protocol.host."_sip._tcp.example.com."
DNSResolverEventlookupflash.events:DNSResolverEventотправляется после успешного завершения поиска. отправляется после успешного завершения поиска.errorflash.events:ErrorEventотправляется после неудачного завершения поиска (в том числе когда запись не существует). отправляется после неудачного завершения поиска (в том числе когда запись не существует).
isSupported Указывает, поддерживается ли поиск DNS в клиентской системе.Boolean Указывает, поддерживается ли поиск DNS в клиентской системе.
MXRecord Класс MXRecord представляет запись ресурса MX системы доменных имен (DNS), содержащую адрес сервера почтового обменника.flash.net.dns:ResourceRecord Класс MXRecord представляет запись ресурса MX системы доменных имен (DNS), содержащую адрес сервера почтового обменника.

Записи ресурсов MX возвращаются объектом DNSResolver в результате поиска DNS для определения имени домена. В ходе одного поиска может быть возвращено несколько записей, если имеется несколько почтовых обменников.

Класс DNSResolverКласс ARecordКласс AAAARecordКласс PTRRecordКласс SRVRecordMXRecord Создает запись ресурса MX. Создает запись ресурса MX.

Записи MX получаются в результате поиска DNS с использованием класса DNSResolver. Код приложения не должен создавать объекты MXRecord.

exchange Имя хоста службы почтового обменника.String Имя хоста службы почтового обменника. preference Приоритет почтового обмена, указанный в этой записи.int Приоритет почтового обмена, указанный в этой записи.

Чем меньше значение, тем выше приоритет.

ARecord Класс ARecord представляет запись ресурса A системы доменных имен (DNS), содержащую адрес IPv4.flash.net.dns:ResourceRecord Класс ARecord представляет запись ресурса A системы доменных имен (DNS), содержащую адрес IPv4.

Записи ресурсов A возвращаются объектом DNSResolver в результате поиска DNS для определения имени домена.

Класс DNSResolverКласс AAAARecordКласс MXRecordКласс PTRRecordКласс SRVRecordARecord Создает запись ресурса А. Создает запись ресурса А.

Записи А получаются в результате поиска DNS с использованием класса DNSResolver. Код приложения не должен создавать объекты ARecord.

address Адрес IPv4.String Адрес IPv4.
SRVRecord Класс SRVRecord представляет запись ресурса SRV доменной системы имен, содержащую хост службы.flash.net.dns:ResourceRecord Класс SRVRecord представляет запись ресурса SRV доменной системы имен, содержащую хост службы.

Записи ресурсов SRV возвращаются объектом DNSResolver в результате поиска DNS для определения идентификатора службы. В ходе одного поиска может быть возвращено несколько записей, если имеется несколько хостов службы.

Класс DNSResolverКласс ARecordКласс AAAARecordКласс MXRecordКласс PTRRecordSRVRecord Создает запись ресурса SRV. Создает запись ресурса SRV.

Записи SRV получаются в результате поиска DNS с использованием класса DNSResolver. Код приложения не должен создавать объекты SRVRecord.

port Порт сервера, используемый службой.int Порт сервера, используемый службой. priority Приоритет хоста службы, указанный в этой записи.int Приоритет хоста службы, указанный в этой записи.

Чем меньше значение, тем выше приоритет.

target Каноническое имя хоста сервера, предоставляющего службу.String Каноническое имя хоста сервера, предоставляющего службу. weight Относительный вес, который должен использоваться при выборе хостов служб с одинаковым приоритетом.int Относительный вес, который должен использоваться при выборе хостов служб с одинаковым приоритетом.