QWebSocketCorsAuthenticator 类

QWebSocketCorsAuthenticator 类提供了一个跨源请求 (CORS) 的验证器对象。更多...

头文件 #include <QWebSocketCorsAuthenticator>
CMakefind_package(Qt6 REQUIRED COMPONENTS WebSockets)
target_link_libraries(mytarget PRIVATE Qt6::WebSockets)
qmakeQT += websockets

公共函数

QWebSocketCorsAuthenticator(const QString &origin)
QWebSocketCorsAuthenticator(const QWebSocketCorsAuthenticator &other)
QWebSocketCorsAuthenticator(QWebSocketCorsAuthenticator &&other)
~QWebSocketCorsAuthenticator()
boolallowed() const
QStringorigin() const
voidsetAllowed(bool allowed)
voidswap(QWebSocketCorsAuthenticator &other)
QWebSocketCorsAuthenticator &operator=(QWebSocketCorsAuthenticator &&other)
QWebSocketCorsAuthenticator &operator=(const QWebSocketCorsAuthenticator &other)

详细描述

QWebSocketCorsAuthenticator 类在 originAuthenticationRequired() 信号中使用。该类提供了一种将所需信息传递回 QWebSocketServer 的方法。它为应用程序提供了对哪些来源 URL 允许哪些不允许的精细控制。默认情况下,接受所有来源。要获得精细控制,应用程序将 originAuthenticationRequired() 信号连接到一个槽。当来源 (QWebSocketCorsAuthenticator::origin()) 被接受时,它调用 QWebSocketCorsAuthenticator::setAllowed(true)

注意:当服务器通过非浏览器客户端访问时,检查来源的意义不大,因为该客户端可以设置它喜欢的任何来源头。在浏览器客户端的情况下,服务器应检查来源的有效性。

另请参阅:WebSocket 安全性考虑QWebSocketServer

成员函数文档

[显式的] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(const QString &origin)

使用给定的 origin 构造一个新的 QCorsAuthencator 对象。

注意:默认情况下,allowed() 返回 true。这意味着默认情况下接受所有来源。

[明确] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(const QWebSocketCorsAuthenticator &其他)

构造一个 其他 的副本。

[noexcept] QWebSocketCorsAuthenticator::QWebSocketCorsAuthenticator(QWebSocketCorsAuthenticator &&其他)

移动构造 QWebSocketCorsAuthenticator,使其指向 其他 所指向的对象。

[noexcept] QWebSocketCorsAuthenticator::~QWebSocketCorsAuthenticator()

销毁对象。

bool QWebSocketCorsAuthenticator::allowed() const

如果来源被允许,返回 true,否则返回 false。

注意:默认情况下,接受所有来源。

另请参阅:setAllowed().

QString QWebSocketCorsAuthenticator::origin() const

返回此认证器处理的相关来源。

void QWebSocketCorsAuthenticator::setAllowed(bool allowed)

允许或禁止来源。将 allowed 设置为 true,将接受给定来源的连接请求。

allowed 设置为 false,将拒绝连接请求。

注意:默认情况下,接受所有来源。

另请参阅:allowed().

[noexcept] void QWebSocketCorsAuthenticator::swap(QWebSocketCorsAuthenticator &其他)

其他 交换此认证器。

此操作非常快速且从不失败。

[noexcept] QWebSocketCorsAuthenticator &QWebSocketCorsAuthenticator::operator=(QWebSocketCorsAuthenticator &&其他)

其他 移动分配给此实例。

QWebSocketCorsAuthenticator &QWebSocketCorsAuthenticator::operator=(const QWebSocketCorsAuthenticator &其他)

其他 分配给此认证器对象。

© 2024 Qt 公司有限公司。本文件中包含的文档贡献归其各自的拥有者所有。本文件提供的文档根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款进行许可。Qt 及其相关标志是芬兰的 Qt 公司及其在全球的商标。所有其他商标均为其各自所有者的财产。