就业培训     下载中心     Wiki     联络 登录   注册
  1. 首页
  2. Qt 6.2.1
  3. Qt Network
  4. C++ 类
  5. QDnsLookup

内容

QDnsLookup 类

QDnsLookup 类表示 DNS (域名系统) 查找。 更多...

头： #include <QDnsLookup>
CMake: find_package(Qt6 COMPONENTS Network REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Since: Qt 5.0
继承： QObject

公共类型

enum Error { NoError, ResolverError, OperationCancelledError, InvalidRequestError, InvalidReplyError, …, NotFoundError }
enum Type { A, AAAA, ANY, CNAME, MX, …, TXT }

特性

公共函数

  QDnsLookup (QDnsLookup::Type type , const QString & name , const QHostAddress & nameserver , QObject * parent = nullptr)
  QDnsLookup (QDnsLookup::Type type , const QString & name , QObject * parent = nullptr)
  QDnsLookup (QObject * parent = nullptr)
virtual ~QDnsLookup ()
QList<QDnsDomainNameRecord> canonicalNameRecords () const
QDnsLookup::Error error () const
QString errorString () const
QList<QDnsHostAddressRecord> hostAddressRecords () const
bool isFinished () const
QList<QDnsMailExchangeRecord> mailExchangeRecords () const
QString name () const
QList<QDnsDomainNameRecord> nameServerRecords () const
QHostAddress nameserver () const
QList<QDnsDomainNameRecord> pointerRecords () const
QList<QDnsServiceRecord> serviceRecords () const
void setName (const QString & name )
void setNameserver (const QHostAddress & nameserver )
void setType (QDnsLookup::Type)
QList<QDnsTextRecord> textRecords () const
QDnsLookup::Type type () const

公共槽

void abort ()
void lookup ()

信号

void finished ()
void nameChanged (const QString & name )
void nameserverChanged (const QHostAddress & nameserver )
void typeChanged (QDnsLookup::Type type )

详细描述

QDnsLookup 使用由操作系统提供的机制来履行 DNS 查找。要履行查找需要指定 name and type 然后援引 lookup() 槽。 finished() 信号会被发射当完成时。

例如，可以确定给定域的 XMPP 聊天客户端应该连接到哪些服务器采用： 

void MyObject::lookupServers()
{
    // Create a DNS lookup.
    dns = new QDnsLookup(this);
    connect(dns, SIGNAL(finished()),
            this, SLOT(handleServers()));
    // Find the XMPP servers for gmail.com
    dns->setType(QDnsLookup::SRV);
    dns->setName("_xmpp-client._tcp.gmail.com");
    dns->lookup();
}

一旦请求完成，可以处理结果采用： 

void MyObject::handleServers()
{
    // Check the lookup succeeded.
    if (dns->error() != QDnsLookup::NoError) {
        qWarning("DNS lookup failed");
        dns->deleteLater();
        return;
    }
    // Handle the results.
    const auto records = dns->serviceRecords();
    for (const QDnsServiceRecord &record : records) {
        ...
    }
    dns->deleteLater();
}

注意： 若仅仅希望查找与主机名关联的 IP 地址 (或与 IP 地址关联的主机名)，应该使用 QHostInfo 代替。

成员类型文档编制

enum QDnsLookup:: Error

指示在 DNS 查找处理过程中发现的所有可能的错误条件。

常量 值 描述
QDnsLookup::NoError 0 没有错误条件。
QDnsLookup::ResolverError 1 初始化系统的 DNS 解析器时出错。
QDnsLookup::OperationCancelledError 2 查找被中止使用 abort () 方法。
QDnsLookup::InvalidRequestError 3 请求的 DNS 查找无效。
QDnsLookup::InvalidReplyError 4 由服务器返回的回复无效。
QDnsLookup::ServerFailureError 5 服务器遭遇内部故障当处理请求时 (SERVFAIL)。
QDnsLookup::ServerRefusedError 6 服务器出于安全或策略原因拒绝处理请求 (REFUSED)。
QDnsLookup::NotFoundError 7 请求的域名不存在 (NXDOMAIN)。

enum QDnsLookup:: Type

指示所履行的 DNS 查找类型。

常量 值 描述
QDnsLookup::A 1 IPv4 地址记录。
QDnsLookup::AAAA 28 IPv6 地址记录。
QDnsLookup::ANY 255 任何记录。
QDnsLookup::CNAME 5 典型名称记录。
QDnsLookup::MX 15 邮件交换记录。
QDnsLookup::NS 2 名称服务器记录。
QDnsLookup::PTR 12 指针记录。
QDnsLookup::SRV 33 服务记录。
QDnsLookup::TXT 16 文本记录。

特性文档编制

[read-only] error : const Error

此特性保持出现错误的类型若 DNS 查找失败，或 NoError .

访问函数：

QDnsLookup::Error error () const

通知程序信号：

void finished ()

[read-only] errorString : const QString

此特性保持错误的人类可读描述，若 DNS 查找失败。

访问函数：

QString errorString () const

通知程序信号：

void finished ()

[bindable] name : QString

注意： 此特性支持 QProperty 绑定。

此特性保持要查找的名称。

注意： 名称将使用 IDNA 编码，这意味着它不适合查询兼容 DNS-SD 规范的 SRV 记录。

[bindable] nameserver : QHostAddress

注意： 此特性支持 QProperty 绑定。

此特性保持用于 DNS 查找的名称服务器。

[bindable] type : Type

注意： 此特性支持 QProperty 绑定。

此特性保持 DNS 查找的类型。

成员函数文档编制

[since 5.4] QDnsLookup:: QDnsLookup ( QDnsLookup::Type type , const QString & name , const QHostAddress & nameserver , QObject * parent = nullptr)

构造 QDnsLookup 对象为给定 type , name and nameserver 并设置 parent 作为父级对象。

该函数在 Qt 5.4 引入。

QDnsLookup:: QDnsLookup ( QDnsLookup::Type type , const QString & name , QObject * parent = nullptr)

构造 QDnsLookup 对象为给定 type and name 并设置 parent 作为父级对象。

QDnsLookup:: QDnsLookup ( QObject * parent = nullptr)

构造 QDnsLookup 对象并设置 parent 作为父级对象。

type 特性默认为 QDnsLookup::A .

[slot] void QDnsLookup:: abort ()

中止 DNS 查找操作。

若查找已完成，什么都不做。

[signal] void QDnsLookup:: finished ()

此信号被发射，当回复已处理完成。

注意： 通知程序信号对于特性 error 。通知程序信号对于特性 errorString .

[slot] void QDnsLookup:: lookup ()

履行 DNS 查找。

finished() 信号被发射当完成时。

[signal] void QDnsLookup:: nameChanged (const QString & name )

此信号被发射当查找 name 改变。 name 是新的查找名称。

注意： 通知程序信号对于特性 name .

[signal] void QDnsLookup:: typeChanged ( QDnsLookup::Type type )

此信号被发射当查找 type 改变。 type 是新的查找类型。

注意： 通知程序信号对于特性 type .

[虚拟] QDnsLookup:: ~QDnsLookup ()

销毁 QDnsLookup 对象。

它是安全的删除 QDnsLookup 对象即使它尚未完成，简而言之，也从不会收到其结果。

QList < QDnsDomainNameRecord > QDnsLookup:: canonicalNameRecords () const

返回关联此查找的典型名称记录列表。

QList < QDnsHostAddressRecord > QDnsLookup:: hostAddressRecords () const

返回关联此查找的主机地址记录列表。

bool QDnsLookup:: isFinished () const

返回回复是已完成还是被中止。

QList < QDnsMailExchangeRecord > QDnsLookup:: mailExchangeRecords () const

返回关联此查找的邮件交换记录列表。

记录的排序是根据 RFC 5321 ，因此，若使用它们连接到服务器，应按照列表它们的次序尝试。

QList < QDnsDomainNameRecord > QDnsLookup:: nameServerRecords () const

返回关联此查找的名称服务器记录列表。

QList < QDnsDomainNameRecord > QDnsLookup:: pointerRecords () const

返回关联此查找的指针记录列表。

QList < QDnsServiceRecord > QDnsLookup:: serviceRecords () const

返回关联此查找的服务记录列表。

记录的排序是根据 RFC 2782 ，因此，若使用它们连接到服务器，应按照列表它们的次序尝试。

QList < QDnsTextRecord > QDnsLookup:: textRecords () const

返回关联此查找的文本记录列表。