compile-activemq-with-gcj.html

<div class="wiki-content maincontent">
<p>You can use <a shape="rect" class="external-link" href="http://gcc.gnu.org/java/" rel="nofollow">GCJ</a> to build ActiveMQ as a shared library you can reuse from C++.</p>

<h3 id="CompileActiveMQwithGCJ-NativecompileActiveMQHOWTO">Native compile ActiveMQ HOWTO</h3>

<h4 id="CompileActiveMQwithGCJ-Abstract">Abstract</h4>
<p>This document describes how to native compile ActiveMQ for use in a C++ environment. The version of ActiveMQ used is 3.2 in this howto. To compile you'll need GCC 4.0.2, or later, with both Java, and C/C++ support.</p>

<h4 id="CompileActiveMQwithGCJ-ToolsSetup">Tools Setup</h4>
<p>If you don't already have GCC 4.0.2 installed you need to download and build it. See GCC manuals for complete instructions on how to build GCC but below is a short descriptions of the steps involved. The GCC build steps assumes that you already have an older GCC compiler installed.</p>

<ul><li>Unpack GCC into an arbitrary directory, for example /opt/gccbuild, and then create a separate output directory. Your directory structure should look similar to this;
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>        /opt/gccbuild/gcc-4.0.2
        /opt/gccbuild/output
</pre>
</div></div></li><li>Go to the output directory and run configure.
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>        cd /opt/gccbuild/output
        ../gcc-4.0.2/configure --prefix=/opt/gcc402
                               --enable-shared
                               --enable-threads=posix
                               --enable-languages=c,c++,java
</pre>
</div></div></li><li>Run make.
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>        make bootstrap
        make install
</pre>
</div></div></li></ul>


<ul><li>Download ActiveMQ and copy the JARs to a new empty directory /opt/app, including
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>        activeio-1.1.jar
        activemq-core-3.2.jar
        commons-logging-1.0.3.jar
        concurrent-1.3.4.jar
        geronimo-spec-j2ee-jacc-1.0-rc4.jar
        geronimo-spec-j2ee-management-1.0-rc4.jar
        geronimo-spec-jms-1.1-rc4.jar
        geronimo-spec-jta-1.0.1B-rc4.jar
        log4j-1.2.8.jar
</pre>
</div></div></li></ul>


<h4 id="CompileActiveMQwithGCJ-WritetheGlueCode">Write the Glue Code</h4>
<p>Either access the ActiveMQ classes directly from C++ or write a facade object in Java that handles all startup and shutdown logic of ActiveMQ. Save the glue files in the same directory as for the ActiveMQ jars.</p>

<p>An CNI example using a Java object starting the MQ.</p>

<h5 id="CompileActiveMQwithGCJ-Bootstrap.cpp">Bootstrap.cpp</h5>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>#include &lt;gcj/cni.h&gt;
#include &lt;iostream&gt;
#include &lt;java/lang/System.h&gt;
#include &lt;java/lang/Throwable.h&gt;
#include &lt;java/io/PrintStream.h&gt;
#include "MQAdapter.h"

using namespace std;

int main(int argc, char* argv[])
{
    cout &lt;&lt; "Entering main" &lt;&lt; endl;
    using namespace java::lang;

    try
    {
        // Create and startup Java VM
        JvCreateJavaVM(NULL) ;
        JvAttachCurrentThread(NULL, NULL) ;

        System::out-&gt;println(JvNewStringLatin1("Java println")) ;

        // Start ActiveMQ
        MQAdapter* pAdapter = new MQAdapter() ;
        pAdapter-&gt;start() ;

        // Send a message
        pAdapter-&gt;send(JvNewStringLatin1("Hello World!")) ;

        // Shutdown ActiveMQ
        pAdapter-&gt;stop() ;
     
        JvDetachCurrentThread() ;
    }
    catch( Throwable *t )
    {
        System::err-&gt;println(JvNewStringLatin1("Exception")) ;
        t-&gt;printStackTrace() ;
    }
}
</pre>
</div></div>
<h5 id="CompileActiveMQwithGCJ-MQAdapter.java">MQAdapter.java</h5>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>import org.activemq.*;
import java.util.Hashtable ;
import javax.jms.*;
import javax.naming.*;

public class MQAdapter
{
    private InitialContext         jndiContext ;
    private QueueConnectionFactory factory ;
    private QueueConnection        connection ;
    private QueueSession           session ;
    private QueueSender            sender ;
    private Queue                  queue ;

    public MQAdapter()
    {
    }

    public void start()
    {
        try
        {
            Hashtable props = new Hashtable() ;
            props.put(Context.INITIAL_CONTEXT_FACTORY, "org.activemq.jndi.ActiveMQInitialContextFactory") ;
            props.put(Context.PROVIDER_URL, "tcp://localhost:61616") ;
            props.put("queue.MyQueue", "example.MyQueue") ;

            jndiContext = new InitialContext(props) ;
        
            // Create and configure JMS connection factory
            factory = (QueueConnectionFactory)jndiContext.lookup("ConnectionFactory") ;

            // Lookup Queue
            queue = (Queue)jndiContext.lookup("MyQueue") ;

            // Create a JMS connection
            connection = (QueueConnection)factory.createQueueConnection() ;
            System.out.println("Created connection: " + connection) ;

            // Create a JMS session
            session = connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE) ;
            System.out.println("Created session: " + session) ;

            // Create JMS sender
            sender  = session.createSender(queue) ;
        }
        catch( Exception e )
        {
            e.printStackTrace() ;

            try
            {
                if( connection != null )
                    connection.close() ;
            } catch( JMSException jmse )
            { /* ignore */ }
        }
    }

    public void stop()
    {
        try
        {
            if( connection != null )
                connection.close() ;
        } catch( JMSException e )
        { /* ignore */ }
    }

    public void send(String msg)
    {
        TextMessage message ;

        try
        {
            message = session.createTextMessage(msg) ;
            sender.send(message) ;
        }
        catch( JMSException e )
        {
            e.printStackTrace() ;
        }
    }
}
</pre>
</div></div>

<h4 id="CompileActiveMQwithGCJ-CompiletheJavaandC++Code">Compile the Java and C++ Code</h4>
<p>The Java code must be BC compiled to be able to dynamically link required classes as needed, see reference for more information on BC compilation. Use the suggested script to compile all ActiveMQ JARs and create a class map database.</p>

<div class="confluence-information-macro confluence-information-macro-information"><p class="title">Note</p><span class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span><div class="confluence-information-macro-body">
<p>Using -Bsymbolic does not seem to work, use -symbolic instead.</p></div></div>

<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>    compile.sh:

    #!/bin/sh

    # Create new classmap database
    gcj-dbtool -n classmap.db

    for JAR_FILE in `find -iname "*.jar"`
    do
        echo "Compiling ${JAR_FILE} to native"
        gcj -shared -findirect-dispatch -fjni -fPIC -Wl,-symbolic -o ${JAR_FILE}.so ${JAR_FILE}
        gcj-dbtool -a classmap.db ${JAR_FILE} ${JAR_FILE}.so
    done
</pre>
</div></div>

<ul><li>Run the above script and set environment property GCJ_PROPERTIES.
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           ./compile.sh
           export GCJ_PROPERTIES="gnu.gcj.precompiled.db.path=/opt/app/classmap.db"
</pre>
</div></div></li></ul>


<ul><li>Java compile MQAdapter.java
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           gcj --classpath=./geronimo-spec-jms-1.1-rc4.jar:./activemq-core-3.2.jar -C MQAdapter.java
</pre>
</div></div></li></ul>


<ul><li>Generate CNI header for MQAdapter.class
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           gcjh MQAdapter
</pre>
</div></div></li></ul>


<ul><li>JAR the Java glue code
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           fastjar cf MQAdapter.jar MQAdapter.class
</pre>
</div></div></li></ul>


<ul><li>Native compile the Java JAR into a shared library, add output directory to LD_LIBRARY_PATH.
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           gcj -shared -findirect-dispatch -fjni -fPIC -Wl,-symbolic -o MQAdapter.so MQAdapter.jar
           export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/app

</pre>
</div></div></li></ul>


<ul><li>Compile the C++ code
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           g++ -c Bootstrap.cpp
</pre>
</div></div></li></ul>


<ul><li>Link Bootstrap with the Java code
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>           gcj -o Bootstrap Bootstrap.o -L /opt/app -lgcj -lstdc++ activeio-1.1.jar.so activemq-core-3.2.jar.so
               commons-logging-1.0.3.jar.so concurrent-1.3.4.jar.so geronimo-spec-jms-1.1-rc4.jar.so
               geronimo-spec-j2ee-management-1.0-rc4.jar.so geronimo-spec-j2ee-jacc-1.0-rc4.jar.so
               geronimo-spec-jta-1.0.1B-rc4.jar.so log4j-1.2.8.jar.so MQAdapter.so
</pre>
</div></div></li></ul>


<p>Now, if everything went ok you should be able to run the app. with ./Bootstrap.</p>

<h4 id="CompileActiveMQwithGCJ-References">References</h4>

<p><a shape="rect" class="external-link" href="http://gcc.gnu.org/wiki/How%20to%20BC%20compile%20with%20GCJ" rel="nofollow">How to BC compile with GCJ</a></p>

<p><a shape="rect" class="external-link" href="http://www.redhat.com/magazine/012oct05/features/java/" rel="nofollow">The state of Java on Linux</a></p></div>