Added example/test application to demonstrate boost asio io_service handler.

include/libboostasio.h

@@ -3,9 +3,11 @@
  *
  *  Implementation for the AMQP::TcpHandler that is optimized for boost::asio. You can
  *  use this class instead of a AMQP::TcpHandler class, just pass the boost asio service
- *  to the constructor and you're all set
+ *  to the constructor and you're all set.  See tests/libboostasio.cpp for example.
  *
  *  @author Gavin Smith <gavin.smith@coralbay.tv>
+ *
+ *
  */
 
 /**
@@ -19,9 +21,10 @@
 #include <memory>
 
 #include <boost/asio/io_service.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/deadline_timer.hpp>
 #include <boost/asio/posix/stream_descriptor.hpp>
 #include <boost/bind.hpp>
-#include <boost/function.hpp>
 
 
 ///////////////////////////////////////////////////////////////////

tests/libboostasio.cpp

@@ -0,0 +1,59 @@
+/**
+ *  LibBoostAsio.cpp
+ * 
+ *  Test program to check AMQP functionality based on Boost's asio io_service.
+ * 
+ *  @author Gavin Smith <gavin.smith@coralbay.tv>
+ *
+ *  Compile with g++ libboostasio.cpp -o boost_test -lpthread -lboost_system -lamqpcpp
+ */
+
+/**
+ *  Dependencies
+ */
+#include <boost/asio/io_service.hpp>
+#include <boost/asio/strand.hpp>
+#include <boost/asio/deadline_timer.hpp>
+
+
+#include <amqpcpp.h>
+#include <amqpcpp/libboostasio.h>
+
+/**
+ *  Main program
+ *  @return int
+ */
+int main()
+{
+
+    // access to the boost asio handler
+    // note: we suggest use of 2 threads - normally one is fin (we are simply demonstrating thread safety).
+    boost::asio::io_service service(4);
+
+    // create a work object to process our events.
+    boost::asio::io_service::work work(service);
+    
+    // handler for libev
+    AMQP::LibBoostAsioHandler handler(service);
+    
+    // make a connection
+    AMQP::TcpConnection connection(&handler, AMQP::Address("amqp://guest:guest@localhost/"));
+    
+    // we need a channel too
+    AMQP::TcpChannel channel(&connection);
+    
+    // create a temporary queue
+    channel.declareQueue(AMQP::exclusive).onSuccess([&connection](const std::string &name, uint32_t messagecount, uint32_t consumercount) {
+        
+        // report the name of the temporary queue
+        std::cout << "declared queue " << name << std::endl;
+        
+        // now we can close the connection
+        connection.close();
+    });
+    
+    // run the handler
+    // a t the moment, one will need SIGINT to stop.  In time, should add signal handling through boost API.
+    return service.run();
+}
+