QWebEngineHttpRequest 类
QWebEngineHttpRequest 类用于持有与 WebEngine 发送请求。 更多...
头文件 | #include <QWebEngineHttpRequest> |
CMake | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore) target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
qmake | QT += webenginecore |
公共类型
枚举 | 方法 { 获取, 提交 } |
公共函数
QWebEngineHttpRequest(const QUrl &url = QUrl(), const QWebEngineHttpRequest::Method &method = QWebEngineHttpRequest::Get) | |
QWebEngineHttpRequest(const QWebEngineHttpRequest &other) | |
~QWebEngineHttpRequest() | |
bool | hasHeader(const QByteArray &headerName) const |
QByteArray | header(const QByteArray &headerName) const |
QList<QByteArray> | headers() const |
QWebEngineHttpRequest::Method | method() const |
QByteArray | postData() const |
void | setHeader(const QByteArray &headerName, const QByteArray &headerValue) |
void | setMethod(QWebEngineHttpRequest::Method method) |
void | setPostData(const QByteArray &postData) |
void | setUrl(const QUrl &url) |
void | swap(QWebEngineHttpRequest &other) |
void | unsetHeader(const QByteArray &key) |
QUrl | url() const |
bool | operator!=(const QWebEngineHttpRequest &other) const |
QWebEngineHttpRequest & | operator=(const QWebEngineHttpRequest &other) |
bool | operator==(const QWebEngineHttpRequest &other) const |
静态公共成员
QWebEngineHttpRequest | postRequest(const QUrl &url, const QMap<QString, QString> &postData) |
详细描述
QWebEngineHttpRequest 表示 WebEngine 网络堆栈中的 HTTP 请求。它包含发送网络请求所需的所有信息。它包含了一个 URL 以及可以被用来修改请求的一些辅助信息。QWebEnginePage::load() 和 QWebEngineView::load() 接受 QWebEngineHttpRequest 作为参数。
成员类型文档
枚举 QWebEngineHttpRequest::Method
此枚举类型描述了发送 HTTP 请求所使用的方法
常量 | 值 | 描述 |
---|---|---|
QWebEngineHttpRequest::Get | 0 | GET 方法。 |
QWebEngineHttpRequest::Post | 1 | POST 方法。 |
成员函数文档
[显式생성자]
QWebEngineHttpRequest::QWebEngineHttpRequest(const QUrl &url = QUrl(), const QWebEngineHttpRequest::Method &method = QWebEngineHttpRequest::Get)
构造一个带有 url (请求的 URL)和 method (使用的请求方法)的 QWebEngineHttpRequest 对象。
QWebEngineHttpRequest::QWebEngineHttpRequest(const QWebEngineHttpRequest &other)
创建 other 的副本。
[noexcept]
QWebEngineHttpRequest::~QWebEngineHttpRequest()
处理 QWebEngineHttpRequest 对象。
bool QWebEngineHttpRequest::hasHeader(const QByteArray &headerName) const
如果此 WebEngine 请求中存在 headerName 所指定的标头,则返回 true
。
参见setHeader(),header(),unsetHeader(),和 headers()。
QByteArray QWebEngineHttpRequest::header(const QByteArray &headerName) const
返回由 headerName 指定的标头。如果不存在此类标头,则返回一个空的 QByteArray,这可能与存在但内容为空的标头不可区分(使用 hasHeader() 来确定标头是否存在)。
标头可以使用 setHeader() 来设置。
参见setHeader(),hasHeader(),unsetHeader(),和 headers()。
QList<QByteArray> QWebEngineHttpRequest::headers() const
返回此 WebEngine 请求中设置的全体标头列表。列表按标头的设定顺序排列。
另请参阅 setHeader(),header(),hasHeader(),和 unsetHeader()。
QWebEngineHttpRequest::Method QWebEngineHttpRequest::method() const
返回此 WebEngine 请求所使用的 方法。
另请参阅 setMethod()。
QByteArray QWebEngineHttpRequest::postData() const
返回此 WebEngine 请求包含的 (原始) POST 数据。
另请参阅 setPostData()。
[静态]
QWebEngineHttpRequest QWebEngineHttpRequest::postRequest(const QUrl &url, const QMap<QString, QString> &postData)
构建一个指向 url 的 QWebEngineHttpRequest,该请求使用 POST 方法。
注意: postData 可能包含任意字符串。它们被转换成适当的原始数据。
另请参阅 postData 和 setPostData()。
void QWebEngineHttpRequest::setHeader(const QByteArray &headerName, const QByteArray &headerValue)
将标题 headerName 设置为值 headerValue。
注意: 重复设置相同的标题会覆盖前面的设置。为了实现具有相同名称的多个 HTTP 标头的功能,您应该将两个值连接起来,并用逗号 (",") 分隔,然后设置一个单独的标题。
另请参阅 header(),hasHeader(),unsetHeader(),以及 headers()。
void QWebEngineHttpRequest::setMethod(QWebEngineHttpRequest::Method method)
将此 WebEngine 请求使用的方法设置为 method。
另请参阅 method()。
void QWebEngineHttpRequest::setPostData(const QByteArray &postData)
将此 WebEngine 请求包含的 (原始) POST 数据设置为 postData。
另请参阅 postData()。
void QWebEngineHttpRequest::setUrl(const QUrl &url)
将此 WebEngine 请求的 URL 设置为 url。
另请参阅 url()。
[noexcept]
void QWebEngineHttpRequest::swap(QWebEngineHttpRequest &other)
与 other 交换此 WebEngine 请求。此函数非常快,永远不会失败。
void QWebEngineHttpRequest::unsetHeader(const QByteArray &key)
如果存在,则移除由 key 指定的头。
另请参阅 setHeader(),header(),hasHeader() 和 headers()。
QUrl QWebEngineHttpRequest::url() const
返回此 WebEngine 请求引用的 URL。
另请参阅 setUrl()。
bool QWebEngineHttpRequest::operator!=(const QWebEngineHttpRequest &other) const
如果此对象与 other 不相同,则返回 false
。
另请参阅 operator==()。
QWebEngineHttpRequest &QWebEngineHttpRequest::operator=(const QWebEngineHttpRequest &other)
创建 other 的副本。
bool QWebEngineHttpRequest::operator==(const QWebEngineHttpRequest &other) const
如果此对象与 other 相同(即它们具有相同的方法、URL 和头),则返回 true
。
另请参阅 operator!=()。
© 2024 The Qt Company Ltd. 本文件中包含的文档贡献是各自所有者的版权。本文件中提供的文档是根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 条款许可的。Qt 及相关标志是芬兰和/或全球其他国家的 The Qt Company Ltd. 的商标。所有其他商标均为其各自所有者的财产。