Add a user-controlled auto-redirect policy

With this new policy, after emitting 'redirected', QNetworkReplyHttpImpl
waits for client code to decide if QNAM should follow this redirect or
not. The client can either allow this redirect by emitting 'redirectAllowed'
or abort the reply.

Task-number: QTPM-236
Change-Id: Ia04619f6bd1f0caa477833ae859b24033027b2e1
Reviewed-by: Timur Pocheptsov <timur.pocheptsov@qt.io>
Reviewed-by: Edward Welbourne <edward.welbourne@qt.io>

1 files changed, 10 insertions, 0 deletions

diff --git a/src/network/access/qnetworkrequest.cpp b/src/network/access/qnetworkrequest.cpp
index abc924d0e2..169695fa27 100644
--- a/src/network/access/qnetworkrequest.cpp
+++ b/src/network/access/qnetworkrequest.cpp
@@ -360,6 +360,16 @@ QT_BEGIN_NAMESPACE
                                         Note, http://example.com and http://example.com:80
                                         will fail with this policy (implicit/explicit ports
                                         are considered to be a mismatch).
+
+    \value UserVerifiedRedirectsPolicy  Client decides whether to follow each
+                                        redirect by handling the redirected()
+                                        signal, emitting redirectAllowed() on
+                                        the QNetworkReply object to allow
+                                        the redirect or aborting/finishing it to
+                                        reject the redirect.  This can be used,
+                                        for example, to ask the user whether to
+                                        accept the redirect, or to decide
+                                        based on some app-specific configuration.
 */
 
 class QNetworkRequestPrivate: public QSharedData, public QNetworkHeadersPrivate