QXmppStanza::Error: Add redirection URI from RFC6120

The error conditions <gone/> and <redirect/> can contain an XMPP URI to
redirect to as defined in RFC6120.

2 files changed, 57 insertions, 5 deletions

diff --git a/src/base/QXmppStanza.cpp b/src/base/QXmppStanza.cpp
index 1a870935..c4fae8de 100644
--- a/src/base/QXmppStanza.cpp
+++ b/src/base/QXmppStanza.cpp
@@ -165,6 +165,7 @@ public:
     QXmppStanza::Error::Type type;
     QXmppStanza::Error::Condition condition;
     QString text;
+    QString redirectionUri;
 
     // XEP-0363: HTTP File Upload
     bool fileTooLarge;
@@ -255,6 +256,9 @@ void QXmppStanza::Error::setCode(int code)
 ///
 /// Returns the error condition.
 ///
+/// The conditions QXmppStanza::Error::Gone and QXmppStanza::Error::Redirect
+/// can be used in combination with redirectUri().
+///
 QXmppStanza::Error::Condition QXmppStanza::Error::condition() const
 {
     return d->condition;
@@ -263,6 +267,9 @@ QXmppStanza::Error::Condition QXmppStanza::Error::condition() const
 ///
 /// Sets the error condition.
 ///
+/// The conditions QXmppStanza::Error::Gone and QXmppStanza::Error::Redirect
+/// can be used in combination with setRedirectUri().
+///
 void QXmppStanza::Error::setCondition(QXmppStanza::Error::Condition cond)
 {
     d->condition = cond;
@@ -284,6 +291,32 @@ void QXmppStanza::Error::setType(QXmppStanza::Error::Type type)
     d->type = type;
 }
 
+///
+/// Returns the optionally included redirection URI for the error conditions
+/// QXmppStanza::Error::Gone and QXmppStanza::Error::Redirect.
+///
+/// \sa setRedirectionUri()
+///
+/// \since QXmpp 1.3
+///
+QString QXmppStanza::Error::redirectionUri() const
+{
+    return d->redirectionUri;
+}
+
+///
+/// Sets the optional redirection URI for the error conditions
+/// QXmppStanza::Error::Gone and QXmppStanza::Error::Redirect.
+///
+/// \sa redirectionUri()
+///
+/// \since QXmpp 1.3
+///
+void QXmppStanza::Error::setRedirectionUri(const QString &redirectionUri)
+{
+    d->redirectionUri = redirectionUri;
+}
+
 /// Returns true, if an HTTP File Upload failed, because the file was too
 /// large.
 ///
@@ -395,12 +428,22 @@ void QXmppStanza::Error::parse(const QDomElement &errorElement)
     QDomElement element = errorElement.firstChildElement();
     while (!element.isNull()) {
         if (element.namespaceURI() == ns_stanza) {
-            if (element.tagName() == QStringLiteral("text"))
+            if (element.tagName() == QStringLiteral("text")) {
                 setText(element.text());
-            else
+            } else {
                 setConditionFromStr(element.tagName());
-            // XEP-0363: HTTP File Upload
+
+                // redirection URI
+                if (d->condition == Gone || d->condition == Redirect) {
+                    d->redirectionUri = element.text();
+
+                    // .text() returns empty string if nothing was set
+                    if (d->redirectionUri.isEmpty())
+                        d->redirectionUri.clear();
+                }
+            }
         } else if (element.namespaceURI() == ns_http_upload) {
+            // XEP-0363: HTTP File Upload
             // file is too large
             if (element.tagName() == QStringLiteral("file-too-large")) {
                 d->fileTooLarge = true;
@@ -434,6 +477,12 @@ void QXmppStanza::Error::toXml(QXmlStreamWriter *writer) const
     if (!cond.isEmpty()) {
         writer->writeStartElement(cond);
         writer->writeDefaultNamespace(ns_stanza);
+
+        // redirection URI
+        if (!d->redirectionUri.isEmpty() && (d->condition == Gone || d->condition == Redirect)) {
+            writer->writeCharacters(d->redirectionUri);
+        }
+
         writer->writeEndElement();
     }
     if (!d->text.isEmpty()) {
diff --git a/src/base/QXmppStanza.h b/src/base/QXmppStanza.h
index a25a138e..8d1c8860 100644
--- a/src/base/QXmppStanza.h
+++ b/src/base/QXmppStanza.h
@@ -123,7 +123,7 @@ public:
             Conflict,               ///< The request conflicts with another.
             FeatureNotImplemented,  ///< The feature is not implemented.
             Forbidden,              ///< The requesting entity does not posses the necessary privileges to perform the request.
-            Gone,                   ///< The user or server can not be contacted at the address.
+            Gone,                   ///< The user or server can not be contacted at the address. This is used in combination with a redirection URI.
             InternalServerError,    ///< The server has expierienced an internal error and can not process the request.
             ItemNotFound,           ///< The requested item could not be found.
             JidMalformed,           ///< The given JID is not valid.
@@ -135,7 +135,7 @@ public:
             QT_DEPRECATED_X("The <payment-required/> error was removed in RFC6120")
             PaymentRequired,
             RecipientUnavailable,   ///< The recipient is unavailable.
-            Redirect,               ///< The requested resource is available elsewhere.
+            Redirect,               ///< The requested resource is available elsewhere. This is used in combination with a redirection URI.
             RegistrationRequired,   ///< The requesting entity needs to register first.
             RemoteServerNotFound,   ///< The remote server could not be found.
             RemoteServerTimeout,    ///< The connection to the server could not be established or timed out.
@@ -167,6 +167,9 @@ public:
         void setType(Type type);
         Type type() const;
 
+        QString redirectionUri() const;
+        void setRedirectionUri(const QString &redirectionUri);
+
         // XEP-0363: HTTP File Upload
         bool fileTooLarge() const;
         void setFileTooLarge(bool);