Caucho Technology

jms messaging in quercus - sending messages


Files in this tutorial

WEB-INF/resin-web.xmlresin-web.xml configuration
WEB-INF/classes/META-INF/beans.xmlJava Injection marker file to start bean scanning
send-message.phpPHP script sending the message.
WEB-INF/classes/example/MyListener.javaJava message bean listener receiving the message.
WEB-INF/classes/example/MessageStore.javaSingleton service bean storing the received messages.

Using JMS in Quercus

Quercus offers a simplified messaging interface built upon JMS. This functionality makes it possible to send and receive messages using either the Resin JMS implementation or any other messaging service with a JMS implementation. Many features of JMS are designed for message-driven services which make sense in the Java world, but are not appropriate for PHP. This tutorial focuses on sending messages.

Sending JMS messages from a PHP script

In this example, the script checks a POST variable "message" and if it is set, sends the value of that variable to a JMS queue. A Message Driven Bean (MDB) receives these messages and records them. The record is displayed by a servlet.

Example: PHP sending script

if (isset($_POST["message"])) {
  $queue = java_bean("Queue");

  if (! $queue) {
    echo "Unable to get message queue!\n";
  } else {
    if ($queue->offer($_POST["message"]) == TRUE) {
      echo "Successfully sent message '" . $_POST["message"] . "'";
    } else {
      echo "Unable to send message '" . $_POST["message"] . "'";


The programming model of the Quercus JMS interface is first to get access to the queue using thejava_bean()call.java_beanwill look for the named bean in the resin-web.xml, in this case our queue. Since the Queue implements thejava.util.concurrent.BlockingQueueAPI, the PHP script can send data to the queue directly usingoffer()and receive messages withpoll().

Configuring JMS for PHP and Java

JMS requires two resources: AQueueand aConnectionFactory. Both are configured inWEB-INF/resin-web.xml. TheConnectionFactoryis used to connect to all theQueues and only one of them needs to be set up.

MemoryQueue configuration

The example uses the queue namedQueue.

Example: Queue configuration in resin-web.xml
<web-app xmlns=""



ConnectionFactory configuration

Example: ConnectionFactory configuration in resin-web.xml
<web-app xmlns=""



The complete configuration is inWEB-INF/resin-web.xml.

Message Bean configuration

Example: MyListener configuration in resin-web.xml
<web-app xmlns=""

  <ejb-message-bean class="example.MyListener">



Copyright © 1998-2011 Caucho Technology, Inc. All rights reserved.
Resin ® is a registered trademark, and Quercustm, Ambertm, and Hessiantm are trademarks of Caucho Technology.