From 30c69f182049d456ce8d37df72a9c4456afab789 Mon Sep 17 00:00:00 2001
From: Jeremy Lainé <jeremy.laine@m4x.org>
Date: Thu, 26 Aug 2010 11:27:41 +0000
Subject: remove experimental QXmppClient::elementReceived() in favour of an
 extension mechanisms

---
 src/QXmppClient.h | 31 +++++++++++++++++--------------
 1 file changed, 17 insertions(+), 14 deletions(-)

(limited to 'src/QXmppClient.h')

diff --git a/src/QXmppClient.h b/src/QXmppClient.h
index 8698f7d5..e6360037 100644
--- a/src/QXmppClient.h
+++ b/src/QXmppClient.h
@@ -25,14 +25,14 @@
 #define QXMPPCLIENT_H
 
 #include <QObject>
-#include <QTcpSocket>
-#include <QHash>
+#include <QAbstractSocket>
 #include <QVariant>
 
 #include "QXmppConfiguration.h"
 #include "QXmppLogger.h"
 #include "QXmppPresence.h"
 
+class QXmppClientExtension;
 class QXmppClientPrivate;
 class QXmppPresence;
 class QXmppMessage;
@@ -42,6 +42,7 @@ class QXmppInvokable;
 class QXmppRpcInvokeIq;
 class QXmppRemoteMethod;
 struct QXmppRemoteMethodResult;
+class QXmppStream;
 
 // managers
 class QXmppArchiveManager;
@@ -91,6 +92,9 @@ public:
 
     QXmppClient(QObject *parent = 0);
     ~QXmppClient();
+
+    void addExtension(QXmppClientExtension *extension);
+
     void connectToServer(const QString& host,
                          const QString& user,
                          const QString& passwd,
@@ -200,18 +204,6 @@ signals:
     /// know the error.
     void error(QXmppClient::Error);
 
-    /// This signal is emitted when a raw XML element is received. You can
-    /// connect to this signal if you want to handle raw XML elements yourself.
-    ///
-    /// WARNING: this signal is experimental and you can seriously disrupt
-    /// packet handling when using it, so use with care and at your own risk.
-    /// 
-    /// Set 'handled' to true if you handled the element yourself and you wish
-    /// to bypass normal handling for the element. If you do this, QXmpp will
-    /// do absolutely no processing itself, so do not expect the usual signals
-    /// to be emitted.
-    void elementReceived(const QDomElement &element, bool &handled);
-
     /// Notifies that an XMPP message stanza is received. The QXmppMessage
     /// parameter contains the details of the message sent to this client.
     /// In other words whenever someone sends you a message this signal is
@@ -241,6 +233,7 @@ public slots:
     void sendMessage(const QString& bareJid, const QString& message);
 
 private slots:
+    void slotElementReceived(const QDomElement &element, bool &handled);
     void invokeInterfaceMethod( const QXmppRpcInvokeIq &iq );
     void xmppConnected();
 
@@ -248,4 +241,14 @@ private:
     QXmppClientPrivate * const d;
 };
 
+/// \brief The QXmppClientExtension is the base class for QXmppClient
+/// extensions.
+///
+
+class QXmppClientExtension
+{
+public:
+    virtual bool handleStanza(QXmppStream *stream, const QDomElement &stanza) = 0;
+};
+
 #endif // QXMPPCLIENT_H
-- 
cgit v1.2.3