Please have a look at "HornetQ Rest Guide" for details.

Howard

and the rest examples

good point!

This is exactly the point. Couldn't make it to work.

Maybe you should be asking us for help with why you couldnt get it to work.

If perhaps I could put my $0.02 in here.

I think it would be great to have some better examples on getting REST to work.  I find myself in the same boat as Yair but I think the problem here is assumed knowledge in the documentation.  It looks great on how to consume and use the REST services.  Just not set up.

For instance, one of the biggest advantages of starting out with HornetQ over ActiveMQ was that you don't need a book to help you along the way, you unarchive it, run the run.sh/bat script and away you go... this is great for people like myself that arn't experienced with Maven and the like either yet to start creating and consuming JMS.

The problem is there's no 'from scratch' about how to enable REST, a great deal on how to consume and use REST but not much getting started.  Even if it was a simple "At the time of writing you won't be able to simply use the existing run.sh script for REST support because...  You'll need to set up an application server for REST support, a simple application server you might like to try is...."

If someone wouldn't mind filling in the gaps here too that would be awesome

Having the same problem here. I'm trying to get RESTEasy setup with HornetQ on jboss-as 5.1.0 and I get exactly the same exception as Yair Ogen :

Here's what posted in the logs of jboss-as :

14:11:38,267 ERROR [0-SNAPSHOT]] Exception sending context initialized event to listener instance of class org.hornetq.rest.integration.RestMessagingBootstrapListener

java.lang.RuntimeException: HornetQException[errorCode=2 message=Cannot connect to server(s). Tried with all available servers.]

          at org.hornetq.rest.integration.RestMessagingBootstrapListener.contextInitialized(RestMessagingBootstrapListener.java:42)

          at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:3910)

          at org.apache.catalina.core.StandardContext.start(StandardContext.java:4389)

          at org.jboss.web.tomcat.service.deployers.TomcatDeployment.performDeployInternal(TomcatDeployment.java:321)

          at org.jboss.web.tomcat.service.deployers.TomcatDeployment.performDeploy(TomcatDeployment.java:145)

          at org.jboss.web.deployers.AbstractWarDeployment.start(AbstractWarDeployment.java:461)

          at org.jboss.web.deployers.WebModule.startModule(WebModule.java:118)

          at org.jboss.web.deployers.WebModule.start(WebModule.java:97)

          at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

          at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)

          at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)

          at java.lang.reflect.Method.invoke(Method.java:597)

          at org.jboss.mx.interceptor.ReflectedDispatcher.invoke(ReflectedDispatcher.java:157)

          at org.jboss.mx.server.Invocation.dispatch(Invocation.java:96)

          at org.jboss.mx.server.Invocation.invoke(Invocation.java:88)

          at org.jboss.mx.server.AbstractMBeanInvoker.invoke(AbstractMBeanInvoker.java:264)

          at org.jboss.mx.server.MBeanServerImpl.invoke(MBeanServerImpl.java:668)

          at org.jboss.system.microcontainer.ServiceProxy.invoke(ServiceProxy.java:206)

          at $Proxy38.start(Unknown Source)

          at org.jboss.system.microcontainer.StartStopLifecycleAction.installAction(StartStopLifecycleAction.java:42)

          at org.jboss.system.microcontainer.StartStopLifecycleAction.installAction(StartStopLifecycleAction.java:37)

          at org.jboss.dependency.plugins.action.SimpleControllerContextAction.simpleInstallAction(SimpleControllerContextAction.java:62)

          at org.jboss.dependency.plugins.action.AccessControllerContextAction.install(AccessControllerContextAction.java:71)

          at org.jboss.dependency.plugins.AbstractControllerContextActions.install(AbstractControllerContextActions.java:51)

          at org.jboss.dependency.plugins.AbstractControllerContext.install(AbstractControllerContext.java:348)

          at org.jboss.system.microcontainer.ServiceControllerContext.install(ServiceControllerContext.java:297)

          at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:1652)

          at org.jboss.dependency.plugins.AbstractController.incrementState(AbstractController.java:938)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:1082)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:988)

          at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:826)

          at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:556)

          at org.jboss.system.ServiceController.doChange(ServiceController.java:688)

          at org.jboss.system.ServiceController.start(ServiceController.java:460)

          at org.jboss.system.deployers.ServiceDeployer.start(ServiceDeployer.java:163)

          at org.jboss.system.deployers.ServiceDeployer.deploy(ServiceDeployer.java:99)

          at org.jboss.system.deployers.ServiceDeployer.deploy(ServiceDeployer.java:46)

          at org.jboss.deployers.spi.deployer.helpers.AbstractSimpleRealDeployer.internalDeploy(AbstractSimpleRealDeployer.java:62)

          at org.jboss.deployers.spi.deployer.helpers.AbstractRealDeployer.deploy(AbstractRealDeployer.java:55)

          at org.jboss.deployers.plugins.deployers.DeployerWrapper.deploy(DeployerWrapper.java:179)

          at org.jboss.deployers.plugins.deployers.DeployersImpl.doDeploy(DeployersImpl.java:1454)

          at org.jboss.deployers.plugins.deployers.DeployersImpl.doInstallParentFirst(DeployersImpl.java:1172)

          at org.jboss.deployers.plugins.deployers.DeployersImpl.doInstallParentFirst(DeployersImpl.java:1193)

          at org.jboss.deployers.plugins.deployers.DeployersImpl.install(DeployersImpl.java:1113)

          at org.jboss.dependency.plugins.AbstractControllerContext.install(AbstractControllerContext.java:348)

          at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:1652)

          at org.jboss.dependency.plugins.AbstractController.incrementState(AbstractController.java:938)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:1082)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:988)

          at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:826)

          at org.jboss.dependency.plugins.AbstractController.change(AbstractController.java:556)

          at org.jboss.deployers.plugins.deployers.DeployersImpl.process(DeployersImpl.java:789)

          at org.jboss.deployers.plugins.main.MainDeployerImpl.process(MainDeployerImpl.java:699)

          at org.jboss.system.server.profileservice.repository.MainDeployerAdapter.process(MainDeployerAdapter.java:117)

          at org.jboss.system.server.profileservice.repository.ProfileDeployAction.install(ProfileDeployAction.java:70)

          at org.jboss.system.server.profileservice.repository.AbstractProfileAction.install(AbstractProfileAction.java:53)

          at org.jboss.system.server.profileservice.repository.AbstractProfileService.install(AbstractProfileService.java:403)

          at org.jboss.dependency.plugins.AbstractControllerContext.install(AbstractControllerContext.java:348)

          at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:1652)

          at org.jboss.dependency.plugins.AbstractController.incrementState(AbstractController.java:938)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:1082)

          at org.jboss.dependency.plugins.AbstractController.resolveContexts(AbstractController.java:988)

          at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:778)

          at org.jboss.dependency.plugins.AbstractController.install(AbstractController.java:543)

          at org.jboss.system.server.profileservice.repository.AbstractProfileService.registerProfile(AbstractProfileService.java:308)

          at org.jboss.system.server.profileservice.ProfileServiceBootstrap.start(ProfileServiceBootstrap.java:256)

          at org.jboss.bootstrap.AbstractServerImpl.start(AbstractServerImpl.java:461)

          at org.jboss.Main.boot(Main.java:221)

          at org.jboss.Main$1.run(Main.java:556)

          at java.lang.Thread.run(Thread.java:680)

Caused by: HornetQException[errorCode=2 message=Cannot connect to server(s). Tried with all available servers.]

          at org.hornetq.core.client.impl.ServerLocatorImpl.createSessionFactory(ServerLocatorImpl.java:619)

          at org.hornetq.rest.MessageServiceManager.start(MessageServiceManager.java:154)

          at org.hornetq.rest.integration.RestMessagingBootstrapListener.contextInitialized(RestMessagingBootstrapListener.java:36)

          ... 69 more

 

Any help on this will be appreciated.

I'm going to try to respond to a number of questions and points raised on this thread...

I've been using a stand-alone hornet server using JMS interface.

 

I now want to add to the same server some REST capabilities. I assume that is not possible as the REST API needs a HTTP container for running.

Your assumption is correct.  You cannot add REST support to a stand-alone HornetQ server.  REST functionality requires an HTTP server.

The explanations on how to create such a server are not clear.

As the HornetQ REST documentation indicates, you can do this with JBoss AS or ostensibly with a different container. 

To do this, for example, in JBoss AS7 (which is what I would recommend at this point in terms of JBoss AS versions) which comes with HornetQ pre-configured you just need to create a WAR file with the web.xml specified in the documentation and the hornetq-rest.jar in WEB-INF/lib. Since AS7 classloading semantics are a bit different than in previous versions you'll also nee the MANIFEST.MF in the WAR file to include this:

  Dependencies: org.hornetq, org.jboss.netty

Is it possible to run Tomcat, for example, so that both JMS and REST interfaces are exposed in the same server process?

I have tried this out and have not been able to make HornetQ REST work within Tomcat yet.

I would like for users to send messages via HTTP REST and receive using JMS subscription.

 

Any exmaples out there?

Check this out.

Isn't there anywhere a ready-to-use war I can just drop in Tomcat?

There is no ready-made WAR you can just drop-in to any container.  However, it should be fairly simple to construct using the example pom.xml files in the documentation.

Also, it is not clear if such a war can also serve as the jms server for a regular client connecting to it with a connection factory.

If configured properly, JBoss AS7 will have HornetQ running which will expose all the normal JMS resources (e.g. connection factories, destinations, etc.).  Deploying HornetQ REST will add the REST interface to that.  Since I haven't been able to make HornetQ REST work in Tomcat I can't comment on whether or not all the normal JMS resources would be exposed.  My guess is that they wouldn't.

The problem is there's no 'from scratch' about how to enable REST

The documentation does cover this point, although it's not perfect.  I can vouch that it works in AS7 given you add the proper dependency entry to the WAR's MANIFEST.MF.  I'll see if I can't clean it up a bit and make things more clear for AS7 (HORNETQ-823). 

I'll also try to track down the Tomcat issue as well (HORNETQ-824).

I was able to get HornetQ REST (including the embedded HornetQ server) working on Tomcat by paying closer attention to the documentation.  Once I added the org.hornetq.rest.integration.HornetqBootstrapListener to my web.xml along with hornetq-configuration.xml, hornetq-jms.xml, and hornetq-users.xml in WEB-INF/classes everything worked appropriately.