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.
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.
The programming model of the Quercus JMS interface is first to create
a connection to a queue by instantiating a
To create a
JMSQueue object, pass in the JNDI name of the
JMS queue to be used.
JMSQueue objects have two methods:
receive(). This example shows
send() is as simple as passing in a PHP value.
JMS requires that two resources be set up: A
ConnectionFactory and a
Queue. Both are
ConnectionFactory is used to connect to all the
Queues and only one of them needs to be set up. The default
JNDI name is
jms/ConnectionFactory - Quercus automatically
uses this connection factory. Another connection factory may be used by
setting the PHP ini variable
The example above uses the queue
The complete configuration is in