| -------------------------------------------------------------------------- |
| ActiveMQ CPP Library |
| -------------------------------------------------------------------------- |
| |
| This library provides a JMS like interface to an ActiveMQ broker in c++. |
| |
| Currently the Library only supports the Stomp protocol, future versions |
| will contain support for openwire. |
| |
| UNIT Tests |
| -------------------------------------------------------------------------- |
| |
| The package contains a complete set of cppunit tests. In order for you |
| to build an run the tests, you will need to download and install the |
| cppunit suite. |
| |
| http://cppunit.sourceforge.net/cppunit-wiki |
| |
| or on Fedora type |
| |
| yum install cppunit* |
| |
| Make sure that the path to the installed cpp unit library and includes is |
| visible in your current shell before you try building the tets. |
| |
| Integration Tests |
| -------------------------------------------------------------------------- |
| |
| The library also contains a set of tests that are run against a real AMQ |
| broker. Running these without a broker will result in failed tests. |
| The tests currently hardcode the broker url to be tcp://127.0.0.1:61613, |
| you can change this by changing the declaration in IntegrationCommon.cpp |
| in the test-integration src tree. |
| |
| Developers Building on Unix/Linux/OS X/Cygwin from an SVN Checkout |
| -------------------------------------------------------------------------- |
| |
| To Generate the ./configure script use to create the Makefiles, you need |
| the following software installed: |
| |
| * autoconf version 2.59 |
| * automake version 1.9.6 |
| * libtool version 1.5.22 |
| * cppunit version 1.10.2 |
| |
| Later versions will probably work too with a little tweaking. Once that's |
| installed, run: |
| |
| ./autogen.sh |
| |
| You should run this anytime you chance configure.ac or any of the |
| Makefile.am files. Now that the configure script is generated follow |
| the directions in the next section to complete the build |
| |
| Solaris 10 note: CPP_UNIT might not build until you correct the file |
| libstdc++.la to contain the correct data, see this discussion. |
| http://forum.sun.com/jive/thread.jspa?threadID=73150 |
| |
| |
| Users Building on Unix/Linux/OS X/Cygwin |
| -------------------------------------------------------------------------- |
| |
| Use the supplied configure script to configure the software. The configure |
| script will customize the way the software is built and installed into |
| your system along with detecting the available libraries that have been |
| installed. To use the default configuration just run: |
| |
| ./configure |
| |
| For more help on how to customize the build configuration, run: |
| |
| ./configure --help |
| |
| Once the configure script has run successfully, you are ready to build. Run |
| |
| make |
| |
| To compile the ActiveMQ libraries and examples. If you have cppunit installed |
| on your system you can also run: |
| |
| make check |
| |
| This will verify that the library is functioning correctly and also generate the |
| integration tests binary. |
| |
| To generate the doxygen documentation for the project, just run: |
| |
| make doxygen-run |
| |
| Notes for Windows users |
| -------------------------------------------------------------------------- |
| |
| The builds support using the GNU compiler on Windows, we used the Cygwin |
| package. However we also support using the MSVC compiler on Windows. |
| |
| There are a couple or things that you will need to setup to ensure that the |
| MSVC compile succeeds. |
| |
| * You need to download and install the Platform SDK if you don't have it |
| installed already. |
| * Ensure that the path to you MSVC install is set in the PATH env variable. |
| you can tests this buy typing cl.exe at the command line, if you get an |
| error complaining that its not found, then setup you PATH correctly. |
| * Set the INCLUDE env variable to include the path to your MSVC includes, |
| and the platform SDK includes. |
| |
| i.e. INCLUDE = D:\Program Files\Microsoft Visual Studio 8\VC\include;D:\Program Files\Microsoft Platform SDK\Include |
| |
| * Set the LIB env variable to include the path to your MSVC libs, and the |
| Platform SDK libs. |
| |
| i.e. LIB = D:\Program Files\Microsoft Visual Studio 8\VC\lib;D:\Program Files\Microsoft Platform SDK\Lib |