Stomp Integration Layer and Transaction Server
Java JavaScript Other
Latest commit 6ba81d4 Nov 26, 2013 @bobmcwhirter bobmcwhirter Merge pull request #16 from Burgestrand/patch-1
Allow passing username and password to .connect() in JS client
Permalink
Failed to load latest commit information.
conduit-jms Remove logging to System.err. Fix info logging noise on server side Sep 9, 2011
conduit-server-core [maven-release-plugin] prepare for next development iteration Aug 27, 2013
conduit-server-spi [maven-release-plugin] prepare for next development iteration Aug 27, 2013
example/deploy Reorg files locally. Jun 20, 2011
stomp-api [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomp-client-js Merge pull request #16 from Burgestrand/patch-1 Nov 26, 2013
stomp-client-rb [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomp-client [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomp-common [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomp-server-core [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomp-server-spi [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomplet-api [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomplet-server-bundle-tests [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomplet-server-bundle [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomplet-server-cdi [maven-release-plugin] prepare for next development iteration Aug 27, 2013
stomplet-server-core [maven-release-plugin] prepare for next development iteration Aug 27, 2013
support Fix up support/settings.xml for bees Aug 14, 2013
.gitignore Break connectors apart from server, so a single server can have both … Mar 1, 2013
LICENSE.txt Adjust the header inclusion. Jun 21, 2011
README.md Add README.md Sep 8, 2011
pom.xml [maven-release-plugin] prepare for next development iteration Aug 27, 2013

README.md

Stilts - STOMP Integration Layer

http://stilts.projectodd.org/

Building

To build, you need Maven 3 and the appropriate entries in your ~/.m2/settings.xml to use the JBoss maven artifact repositories.

Alternatively, you may use the included support/settings.xml via

    mvn -s ./support/settings.xml install

JBossAS Integration

Make sure you have a JBossAS version that supports the jboss netty bundle. Check if this pull request already made it upstream. If not, use this branch.

Add the the netty bundle to the list of auto installed bundles.

    <modules>
        ...
        <module identifier="org.jboss.netty" startlevel="2"/>
        ...
    </modules>

Set the JBOSS_HOME environment variable and copy the stilts-stomplet-server-bundle.jar to the deployments folder.

    $ export JBOSS_HOME=~/git/.../build/target/jboss-as-7.1.0.Alpha1-SNAPSHOT
	$ mvn install
	$ cp stomplet-server-bundle/target/stilts-stomplet-server-bundle.jar $JBOSS_HOME/standalone/deployments/

Startup the server. You should see

	20:02:42,327 INFO  [org.jboss.osgi.framework.internal.BundleManager] (MSC service thread 1-3) Install bundle: stilts-stomplet-server-bundle:0.1.16.SNAPSHOT
	20:02:42,473 INFO  [org.jboss.as.server.controller] (DeploymentScanner-threads - 2) Deployed "stilts-stomplet-server-bundle.jar"
	20:02:42,527 INFO  [org.projectodd.stilts.stomplet.bundle.StompletServerActivator] (MSC service thread 1-4) start: BundleContext[stilts-stomplet-server-bundle:0.1.16.SNAPSHOT]
	20:02:42,546 INFO  [org.projectodd.stilts.stomplet.bundle.StompletServerActivator] (MSC service thread 1-4) adding transaction manager: com.arjuna.ats.jbossatx.jta.TransactionManagerDelegate@cbbaf
	20:02:42,628 INFO  [org.jboss.osgi.framework.internal.HostBundleState] (MSC service thread 1-4) Bundle started: stilts-stomplet-server-bund

Now you can run the integration tests

	$ mvn -Djbossas install
	...
	Running org.projectodd.stilts.stomplet.StompletServerTestCase
    Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 4.292 sec

How does it work?

The stilts-stomplet-server-bundle has a BundleActivator that

The test bundle has a BundleActivator that registers a Stomplet service

    public void start(BundleContext context) throws Exception {
        log.infof("start: %s", context);
        Dictionary props = new Hashtable();
        props.put("destinationPattern", DESTINATION_QUEUE_ONE);
        registration = context.registerService(Stomplet.class.getName(), new SimpleTestStomplet(), props);
    }

When this service gets tracked, the stilts-stomplet-server-bundle adds it to the running container

        public Object addingService(ServiceReference reference) {
            Stomplet stomplet = (Stomplet) super.addingService(reference);
            log.infof("adding: %s", stomplet);
            try {
                // Copy string properties
                Map props = new HashMap();
                for (String key : reference.getPropertyKeys()) {
                    Object value = reference.getProperty(key);
                    if (value instanceof String) {
                        props.put(key, (String) value);
                    }
                }
                String destinationPattern = props.get("destinationPattern");
                log.infof("adding: %s -> %s", destinationPattern, stomplet);
                container.addStomplet(destinationPattern, stomplet, props);
            } catch (StompException ex) {
                log.errorf(ex, "Cannot add stomplet: %s", stomplet);
            }
            return stomplet;
        }

The test client code should be obvious.

        StompClient client = new StompClient("stomp://localhost");
        client.connect();

        final CountDownLatch latch = new CountDownLatch(3);
        SubscriptionBuilder builder = client.subscribe(DESTINATION_QUEUE_ONE);
        builder.withMessageHandler(new MessageHandler() {
            public void handle(StompMessage message) {
                latch.countDown();
            }
        });
        ClientSubscription subscription = builder.start();
        
        client.send(StompMessages.createStompMessage(DESTINATION_QUEUE_ONE, "start"));

        assertTrue("No latch timeout", latch.await(10, TimeUnit.SECONDS));

        client.send(StompMessages.createStompMessage(DESTINATION_QUEUE_ONE, "stop"));

        subscription.unsubscribe();
        client.disconnect();