8 files changed, 315 insertions, 0 deletions
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/.gitignore b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/.gitignore
new file mode 100644
index 0000000..28275ad
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/.gitignore
@@ -0,0 +1,2 @@
+EchoBot?
+*.cpp.xml
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot1.cpp b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot1.cpp
new file mode 100644
index 0000000..584ec9d
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot1.cpp
@@ -0,0 +1,20 @@
+/*
+ * Copyright (c) 2010 Remko Tronçon
+ * Licensed under the GNU General Public License v3.
+ * See Documentation/Licenses/GPLv3.txt for more information.
+ */
+
+#include "Swiften/Swiften.h"
+
+using namespace Swift;
+
+int main(int, char*) {
+	SimpleEventLoop eventLoop;
+
+	Client client(JID("echobot@wonderland.lit"), "mypass");
+	client.connect();
+
+	eventLoop.run();
+
+	return 0;
+}
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot2.cpp b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot2.cpp
new file mode 100644
index 0000000..a03c3db
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot2.cpp
@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2010 Remko Tronçon
+ * Licensed under the GNU General Public License v3.
+ * See Documentation/Licenses/GPLv3.txt for more information.
+ */
+
+#include <iostream>
+#include <boost/bind.hpp>
+
+#include "Swiften/Swiften.h"
+
+using namespace Swift;
+using namespace boost;
+
+Client* client;
+
+void handleConnected() {
+	std::cout << "Connected" << std::endl;
+}
+
+void handleMessageReceived(Message::ref message) {
+	// Echo back the incoming message
+	message->setTo(message->getFrom());
+	message->setFrom(JID());
+	client->sendMessage(message);
+}
+
+int main(int, char*) {
+	SimpleEventLoop eventLoop;
+
+	client = new Client(JID("echobot@wonderland.lit"), "mypass");
+	client->onConnected.connect(&handleConnected);
+	client->onMessageReceived.connect(bind(&handleMessageReceived, _1));
+	client->connect();
+
+	eventLoop.run();
+
+	delete client;
+	return 0;
+}
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot3.cpp b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot3.cpp
new file mode 100644
index 0000000..a9c611f
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot3.cpp
@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2010 Remko Tronçon
+ * Licensed under the GNU General Public License v3.
+ * See Documentation/Licenses/GPLv3.txt for more information.
+ */
+
+#include <iostream>
+#include <boost/bind.hpp>
+
+#include "Swiften/Swiften.h"
+
+using namespace Swift;
+using namespace boost;
+
+class EchoBot {
+	public:
+		EchoBot() {
+			client = new Client(JID("echobot@wonderland.lit"), "mypass");
+			client->onConnected.connect(bind(&EchoBot::handleConnected, this));
+			client->onMessageReceived.connect(
+					bind(&EchoBot::handleMessageReceived, this, _1));
+			tracer = new ClientXMLTracer(client);
+			client->connect();
+		}
+
+		~EchoBot() {
+			delete tracer;
+			delete client;
+		}
+	
+	private:
+		void handleConnected() {
+			std::cout << "Connected" << std::endl;
+		}
+
+		void handleMessageReceived(Message::ref message) {
+			// Echo back the incoming message
+			message->setTo(message->getFrom());
+			message->setFrom(JID());
+			client->sendMessage(message);
+		}
+	
+	private:
+		Client* client;
+		ClientXMLTracer* tracer;
+};
+
+int main(int, char*) {
+	SimpleEventLoop eventLoop;
+	EchoBot bot;
+	eventLoop.run();
+	return 0;
+}
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot4.cpp b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot4.cpp
new file mode 100644
index 0000000..b01fecd
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot4.cpp
@@ -0,0 +1,89 @@
+/*
+ * Copyright (c) 2010 Remko Tronçon
+ * Licensed under the GNU General Public License v3.
+ * See Documentation/Licenses/GPLv3.txt for more information.
+ */
+
+//...
+#include <iostream>
+#include <boost/bind.hpp>
+
+#include "Swiften/Swiften.h"
+
+using namespace Swift;
+using namespace boost;
+//...
+class EchoBot {
+	public:
+		EchoBot() {
+			//...
+			client = new Client(JID("echobot@wonderland.lit"), "mypass");
+			client->onConnected.connect(bind(&EchoBot::handleConnected, this));
+			client->onMessageReceived.connect(
+					bind(&EchoBot::handleMessageReceived, this, _1));
+			//...
+			client->onPresenceReceived.connect(
+					bind(&EchoBot::handlePresenceReceived, this, _1));
+			//...
+			tracer = new ClientXMLTracer(client);
+			client->connect();
+			//...
+		}
+
+		//...
+		~EchoBot() {
+			delete tracer;
+			delete client;
+		}
+	
+	private:
+		//...
+		void handlePresenceReceived(Presence::ref presence) {
+			// Automatically approve subscription requests
+			if (presence->getType() == Presence::Subscribe) {
+				Presence::ref response = Presence::create();
+				response->setTo(presence->getFrom());
+				response->setType(Presence::Subscribed);
+				client->sendPresence(response);
+			}
+		}
+
+		void handleConnected() {
+			// Request the roster
+			GetRosterRequest::ref rosterRequest = 
+					GetRosterRequest::create(client->getIQRouter());
+			rosterRequest->onResponse.connect(
+					bind(&EchoBot::handleRosterReceived, this, _2));
+			rosterRequest->send();
+		}
+
+		void handleRosterReceived(const optional<ErrorPayload>& error) {
+			if (error) {
+				std::cerr << "Error receiving roster. Continuing anyway.";
+			}
+			// Send initial available presence
+			client->sendPresence(Presence::create("Send me a message"));
+		}
+		//...
+		
+		void handleMessageReceived(Message::ref message) {
+			// Echo back the incoming message
+			message->setTo(message->getFrom());
+			message->setFrom(JID());
+			client->sendMessage(message);
+		}
+
+	private:
+		Client* client;
+		ClientXMLTracer* tracer;
+		//...
+};
+//...
+
+int main(int, char*) {
+	SimpleEventLoop eventLoop;
+	EchoBot bot;
+	eventLoop.run();
+	return 0;
+}
+//...
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot5.cpp b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot5.cpp
new file mode 100644
index 0000000..72d0eb1
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/EchoBot5.cpp
@@ -0,0 +1,95 @@
+/*
+ * Copyright (c) 2010 Remko Tronçon
+ * Licensed under the GNU General Public License v3.
+ * See Documentation/Licenses/GPLv3.txt for more information.
+ */
+
+//...
+#include <iostream>
+#include <boost/bind.hpp>
+
+#include "Swiften/Swiften.h"
+
+using namespace Swift;
+using namespace boost;
+//...
+class EchoBot {
+	public:
+		EchoBot() {
+			//...
+			client = new Client(JID("echobot@wonderland.lit"), "mypass");
+			client->onConnected.connect(bind(&EchoBot::handleConnected, this));
+			client->onMessageReceived.connect(
+					bind(&EchoBot::handleMessageReceived, this, _1));
+			client->onPresenceReceived.connect(
+					bind(&EchoBot::handlePresenceReceived, this, _1));
+			tracer = new ClientXMLTracer(client);
+			//...
+			softwareVersionResponder = new SoftwareVersionResponder(
+					"EchoBot", "1.0", client->getIQRouter());
+			//...
+			client->connect();
+			//...
+		}
+
+		~EchoBot() {
+			delete softwareVersionResponder;
+			//...
+			delete tracer;
+			delete client;
+			//...
+		}
+		//...
+	
+	private:
+		void handlePresenceReceived(Presence::ref presence) {
+			// Automatically approve subscription requests
+			if (presence->getType() == Presence::Subscribe) {
+				Presence::ref response = Presence::create();
+				response->setTo(presence->getFrom());
+				response->setType(Presence::Subscribed);
+				client->sendPresence(response);
+			}
+		}
+
+		void handleConnected() {
+			// Request the roster
+			GetRosterRequest::ref rosterRequest = 
+					GetRosterRequest::create(client->getIQRouter());
+			rosterRequest->onResponse.connect(
+					bind(&EchoBot::handleRosterReceived, this, _2));
+			rosterRequest->send();
+		}
+
+		void handleRosterReceived(const optional<ErrorPayload>& error) {
+			if (error) {
+				std::cerr << "Error receiving roster. Continuing anyway.";
+			}
+			// Send initial available presence
+			client->sendPresence(Presence::create("Send me a message"));
+		}
+		
+		void handleMessageReceived(Message::ref message) {
+			// Echo back the incoming message
+			message->setTo(message->getFrom());
+			message->setFrom(JID());
+			client->sendMessage(message);
+		}
+
+		//...
+	private:
+		//...
+		Client* client;
+		ClientXMLTracer* tracer;
+		//...
+		SoftwareVersionResponder* softwareVersionResponder;
+};
+//...
+
+int main(int, char*) {
+	SimpleEventLoop eventLoop;
+	EchoBot bot;
+	eventLoop.run();
+	return 0;
+}
+//...
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/SConscript b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/SConscript
new file mode 100644
index 0000000..ceead6b
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/EchoBot/SConscript
@@ -0,0 +1,15 @@
+Import("env")
+
+example_env = env.Clone()
+example_env.MergeFlags(example_env["SWIFTEN_FLAGS"])
+example_env.MergeFlags(example_env["LIBIDN_FLAGS"])
+example_env.MergeFlags(example_env["BOOST_FLAGS"])
+example_env.MergeFlags(example_env.get("SQLITE_FLAGS", {}))
+example_env.MergeFlags(example_env["ZLIB_FLAGS"])
+example_env.MergeFlags(example_env["OPENSSL_FLAGS"])
+example_env.MergeFlags(example_env.get("LIBXML_FLAGS", ""))
+example_env.MergeFlags(example_env.get("EXPAT_FLAGS", ""))
+example_env.MergeFlags(example_env["PLATFORM_FLAGS"])
+
+for i in range(1,6) :
+	example_env.Program("EchoBot" + str(i), ["EchoBot" + str(i) + ".cpp"])
diff --git a/Documentation/SwiftenDevelopersGuide/Examples/SConscript b/Documentation/SwiftenDevelopersGuide/Examples/SConscript
new file mode 100644
index 0000000..1284b34
--- /dev/null
+++ b/Documentation/SwiftenDevelopersGuide/Examples/SConscript
@@ -0,0 +1 @@
+SConscript(dirs = ["EchoBot"])