QWebEngineUrlSchemeHandler Class

Descripción detallada

Un gestor de esquemas personalizado es, a grandes rasgos, similar a una aplicación web servida a través de HTTP. Sin embargo, como los esquemas personalizados se integran directamente en el motor web, tienen la ventaja en términos de eficiencia y seguridad: No hay necesidad de generar y analizar mensajes HTTP o de transferir datos a través de sockets, ni de interceptar o monitorizar el tráfico.

Para implementar un esquema de URL personalizado para QtWebEngine, primero hay que crear una instancia de QWebEngineUrlScheme y registrarla mediante QWebEngineUrlScheme::registerScheme().

Como los esquemas personalizados se integran directamente en el motor web, no tienen por qué seguir las normas de seguridad estándar que se aplican a los contenidos web ordinarios. Dependiendo de la configuración elegida, el contenido servido a través de un esquema personalizado puede tener acceso a recursos locales, estar configurado para ignorar las reglas de Content-Security-Policy o, por el contrario, no tener acceso a ningún otro contenido. Si va a ser accedido por contenido normal, asegúrese de que el acceso de origen cruzado está habilitado, y si se accede desde HTTPS, que está marcado como seguro.

Luego, debes crear una clase derivada de QWebEngineUrlSchemeHandler, y reimplementar el metodo requestStarted().

Por último, instanciar el objeto scheme handler mediante QWebEngineProfile::installUrlSchemeHandler() o QQuickWebEngineProfile::installUrlSchemeHandler().

class MySchemeHandler : public QWebEngineUrlSchemeHandler
{
public:
    MySchemeHandler(QObject *parent = nullptr);
    void requestStarted(QWebEngineUrlRequestJob *job)
    {
        const QByteArray method = job->requestMethod();
        const QUrl url = job->requestUrl();

        if (isValidUrl(url)) {
            if (method == QByteArrayLiteral("GET"))
                job->reply(QByteArrayLiteral("text/html"), makeReply(url));
            else // Unsupported method
                job->fail(QWebEngineUrlRequestJob::RequestDenied);
        } else {
            // Invalid URL
            job->fail(QWebEngineUrlRequestJob::UrlNotFound);
        }
    }
    bool isValidUrl(const QUrl &url) const // ....
    QIODevice *makeReply(const QUrl &url) // ....
};

int main(int argc, char **argv)
{
    QWebEngineUrlScheme scheme("myscheme");
    scheme.setSyntax(QWebEngineUrlScheme::Syntax::HostAndPort);
    scheme.setDefaultPort(2345);
    scheme.setFlags(QWebEngineUrlScheme::SecureScheme);
    QWebEngineUrlScheme::registerScheme(scheme);

    // ...
    QApplication app(argc, argv);
    // ...

    // installUrlSchemeHandler does not take ownership of the handler.
    MySchemeHandler *handler = new MySchemeHandler(parent);
    QWebEngineProfile::defaultProfile()->installUrlSchemeHandler("myscheme", handler);
}