Класс QDnsLookup

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

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

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

Свойства

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

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

Сигналы

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

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

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

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

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

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

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

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

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

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

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

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

Создаёт объект QDnsLookup для заданного типа type и имени 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.

[virtual] 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

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