BoostStomp - a STOMP (Simple Text Oriented Messaging Protocol) client
----------------------------------------------------

A simple C++ STOMP client ( http://stomp.github.com ), 
written with standard STL and boost ( http://www.boost.org )

For Debian, the packages you'll be needing in order to compile are:

libboost1.xx-dev (Boost base files)
libboost_system1.xx (1.xx==depending on your Debian version) 
libboost_system1.xx-dev
libboost_thread1.xx (thread support)
libboost_thread1.xx-dev

For Ubuntu, the naming of the packages differs slightly, 
try searching for them in Synaptic or aptitude. 
Any Boost's version over 1.35 will do.

EXAMPLE OF USAGE
============
There is an example of usage, in Main.cpp. It gets built by default, 
along with the shared & static versions of the booststomp library.
A more advanced example can be found in Thrift4OZW's Main.cpp
https://github.com/ekarak/Thrift4OZW/blob/master/Main.cpp

Usage is simple, include the BoostStomp.hpp header in your program,

    #include "BoostStomp.hpp"

then you can construct a BoostStomp object passing it the hostname 
and port of the STOMP server:

    string  stomp_host = "localhost";
    int     stomp_port = 61613;
    stomp_client = new BoostStomp(stomp_host, stomp_port);

..then, start it to initiate the TCP & STOMP connection:

    stomp_client->start();
    
..then, subscribe to a channel, and pass in a callback for the handling of any messages of interest:

    string  notifications_topic = "/queue/zwave/monitor";
    stomp_client->subscribe(*notifications_topic, (STOMP::pfnOnStompMessage_t) &subscription_callback);

..then you can construct STOMP frames, adding in any headers you like, and add them to the send queue:
 
        STOMP::hdrmap headers;
        headers["header1"] = string("value1");
        headers["header2:withcolon"] = string("value2");
        headers["header3"] = string("value3");
        string body = string("this is the main message body");

        // add an outgoing message to the queue
        stomp_client->send(*notifications_topic, headers, body);
	
You must remember at all times that since we are using an asynchronous i/o
model,  any messages sent via BoostStomp are _not_ guaranteed to succeed.
Future versions of the library will support overloaded versions with completion
callbacks (following th boost::asio model).

1) Compile the library with:
make

2) Install it into your system with:
sudo make install

Copyright (c) 2012-2013 Elias Karakoulakis <[email protected]>

SOFTWARE NOTICE AND LICENSE

BoostStomp is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published
by the Free Software Foundation, either version 3 of the License,
or (at your option) any later version.

BoostStomp is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with BoostStomp.  If not, see <http://www.gnu.org/licenses/>.

for more information on the LGPL, see:
http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License