Класс QWebEngineUrlRequestJob

Класс QWebEngineUrlRequestJob представляет пользовательский запрос к URL. Подробнее...

Этот класс был представлен в Qt 5.6.

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

Типы публичного доступа

Функции публичного доступа

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

QWebEngineUrlRequestJob передается в QWebEngineUrlSchemeHandler::requestStarted() и должен обрабатываться производными реализациями класса. Обработка задания может выполняться с помощью вызова reply(), redirect() или fail().

Класс принадлежит веб-движку и не требует удаления. Однако веб-движок может удалить задание, когда оно больше не нужно, и поэтому следует отслеживать сигнал QObject::destroyed(), если указатель на объект хранится.

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

перечисление QWebEngineUrlRequestJob::Ошибка

Этот тип перечисления содержит тип ошибки, которая произошла:

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

void QWebEngineUrlRequestJob::fail(QWebEngineUrlRequestJob::Ошибка r)

Отправляет запрос с ошибкой r.

См. также Ошибка.

QUrl QWebEngineUrlRequestJob::initiator() const

Возвращает сериализованное происхождение содержимого, которое инициировало запрос.

В общем случае происхождение состоит из схемы, имени хоста и порта. Например, "http://localhost:8080" — это допустимое происхождение. Порт опускается, если он является стандартным для схемы (80 для http, 443 для https). Имя хоста опускается для схем, не относящихся к сети, таких как file и qrc.

Однако также существует специальное значение "null", представляющее уникальное происхождение. Например, это происхождение вложенной области iframe с защитой от нежелательных действий. Цель этого специального происхождения — всегда отличаться от всех других источников при проверке соответствия домена. Другими словами, содержимое с уникальным происхождением никогда не должно иметь привилегированный доступ к другому содержимому.

Наконец, если запрос не был инициирован веб-содержимым, функция возвращает пустой QUrl. Это происходит, например, при вызове QWebEnginePage::setUrl().

Это значение можно использовать для реализации безопасных проверок соответствия домена.

Эта функция была представлена в Qt 5.11.

void QWebEngineUrlRequestJob::redirect(const QUrl &url)

Перенаправляет запрос на url.

void QWebEngineUrlRequestJob::reply(const QByteArray &contentType, QIODevice *device)

Отвечает на запрос с помощью device и MIME-типа contentType.

Пользователь должен быть осведомлен о том, что device будет использоваться в другом потоке до удаления задания. В случае одновременного доступа из основного потока пользователь отвечает за обеспечение потокобезопасности доступа к device, например, с помощью QMutex. Обратите внимание, что объект device не принадлежит веб-движку. Следовательно, следует отслеживать сигнал QObject::destroyed() объекта QWebEngineUrlRequestJob.

Устройство должно оставаться доступным по крайней мере до тех пор, пока существует задание. При вызове этого метода с вновь созданным устройством одним из решений является создание устройства как дочернего элемента задания или удаление устройства при удалении задания, например так:

connect(job, &QObject::destroyed, device, &QObject::deleteLater);

QMap<QByteArray, QByteArray> QWebEngineUrlRequestJob::requestHeaders() const

Возвращает любые HTTP-заголовки, добавленные в запрос.

Эта функция была представлена в Qt 5.13.

QByteArray QWebEngineUrlRequestJob::requestMethod() const

Возвращает HTTP-метод запроса (например, GET или POST).

QUrl QWebEngineUrlRequestJob::requestUrl() const

Возвращает запрашиваемый URL.