Класс QDnsLookup

Класс QDnsLookup представляет собой запрос DNS. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Открытые типы

Свойства

• 1 свойство унаследовано от QObject

Открытые функции

• 31 открытая функция унаследована от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 2 сигнала унаследованы от QObject

Статические открытые члены

• 9 статических публичных членов, унаследованных от QObject

Дополнительные унаследованные члены

• 9 защищённых функций, унаследованных от QObject

Подробное описание

Класс QDnsLookup представляет собой запрос DNS.

QDnsLookup использует механизмы операционной системы для выполнения запросов DNS. Для выполнения запроса необходимо указать имя (name) и тип (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.

Документация типов членов

перечисление QDnsLookup::Error

Указывает все возможные условия ошибки, обнаруженные во время обработки запроса DNS.

перечисление QDnsLookup::Type

Указывает тип запроса DNS, который был выполнен.

Документация по членам-функциям

QDnsLookup::QDnsLookup(QObject *parent = nullptr)

Создаёт объект QDnsLookup и устанавливает parent в качестве родительского объекта.

Свойство type будет по умолчанию равно QDnsLookup::A.

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

Создаёт объект QDnsLookup для указанного типа type и имени name и устанавливает parent в качестве родительского объекта.

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

Создаёт объект QDnsLookup для указанного типа type, имени name и сервера имён nameserver и устанавливает parent в качестве родительского объекта.

Эта функция была добавлена в Qt 5.4.

[virtual] QDnsLookup::~QDnsLookup()

Удаляет объект QDnsLookup.

Безопасно удалять объект QDnsLookup, даже если он не завершён, вы просто никогда не получите его результаты.

[slot] void QDnsLookup::abort()

Прерывает операцию поиска DNS.

Если поиск уже завершён, ничего не делает.

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

Возвращает список записей канонических имён, связанных с этим поиском.

[signal] void QDnsLookup::finished()

Этот сигнал испускается, когда обработка ответа завершается.

Примечание: Сигнал оповещения для свойства error. Сигнал оповещения для свойства errorString.

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

Возвращает список записей адресов хоста, связанных с этим поиском.

bool QDnsLookup::isFinished() const

Возвращает значение, указывающее, завершён ли ответ или прерван.

[slot] void QDnsLookup::lookup()

Выполняет поиск DNS.

Сигнал finished() испускается по завершении.

QList<QDnsMailExchangeRecord> QDnsLookup::mailExchangeRecords() const

Возвращает список записей обмена почтой, связанных с этим поиском.

Записи отсортированы в соответствии с RFC 5321, поэтому при подключении к серверам их следует пробовать в порядке списка.

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

Этот сигнал испускается, когда имя поиска name изменяется. name — новое имя поиска.

Примечание: Сигнал оповещения для свойства name.

QList<QDnsDomainNameRecord> QDnsLookup::nameServerRecords() const

Возвращает список записей серверов имён, связанных с этим поиском.

QList<QDnsDomainNameRecord> QDnsLookup::pointerRecords() const

Возвращает список указательных записей, связанных с этим поиском.

QList<QDnsServiceRecord> QDnsLookup::serviceRecords() const

Возвращает список записей служб, связанных с этим поиском.

Записи отсортированы в соответствии с RFC 2782, поэтому при подключении к серверам их следует пробовать в порядке списка.

QList<QDnsTextRecord> QDnsLookup::textRecords() const

Возвращает список записей текстовых записей, связанных с этим запросом.

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

Этот сигнал излучается, когда изменяется тип запроса type. type — новый тип запроса.

Примечание: Сигнал уведомления для свойства type.