jstrachan 02/05/22 08:08:17
Modified: docs messenger.html commons.html beanutils.html
logging.html charter.html cli.html sandbox.html
license.html directory.html releases.html
contributors.html modeler.html betwixt.html
versioning.html components.html index.html
collections.html digester.html
Log:
Removed the old Messenger documentation and updated the links to point to the new
Maven generated Messenger site
Revision Changes Path
1.28 +11 -879 jakarta-commons/docs/messenger.html
Index: messenger.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/messenger.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- messenger.html 21 May 2002 09:39:52 -0000 1.27
+++ messenger.html 22 May 2002 15:08:16 -0000 1.28
@@ -1,890 +1,22 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
-<!-- Content Stylesheet for Site -->
+<html>
-
-<!-- start the processing -->
- <!-- ====================================================================== -->
- <!-- Main Page Section -->
- <!-- ====================================================================== -->
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1"/>
+<head>
+ <meta http-equiv="Refresh" CONTENT="1;
URL=http://jakarta.apache.org/commons/sandbox/messenger/";>
+ <title>Commons - Messenger</title>
+</head>
- <meta name="author"
value="James Strachan">
- <meta name="email" value="[EMAIL PROTECTED]">
-
-
-
- <title>Commons - Messenger</title>
- </head>
-
- <body bgcolor="#ffffff" text="#000000" link="#525D76">
- <table border="0" width="100%" cellspacing="0">
- <!-- TOP IMAGE -->
- <tr>
- <td align="left">
-<a href="http://jakarta.apache.org";><img
src="http://jakarta.apache.org/images/jakarta-logo.gif"; border="0"/></a>
-</td>
-<td align="right">
-<a href="http://jakarta.apache.org/commons/";><img src="./images/logo.jpg"
alt="Commons" border="0"/></a>
-</td>
- </tr>
- </table>
- <table border="0" width="100%" cellspacing="4">
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
-
- <tr>
- <!-- LEFT SIDE NAVIGATION -->
- <td width="20%" valign="top" nowrap="true">
- <p><strong>Home</strong></p>
- <ul>
- <li> <a href="./index.html">Jakarta Commons</a>
-</li>
- </ul>
- <p><strong>About Us</strong></p>
- <ul>
- <li> <a href="./contributors.html">Contributors</a>
-</li>
- <li> <a href="./license.html">License</a>
-</li>
- </ul>
- <p><strong>Download</strong></p>
- <ul>
- <li> <a
href="http://jakarta.apache.org/builds/jakarta-commons/release";>Release</a>
-</li>
- <li> <a
href="http://jakarta.apache.org/builds/jakarta-commons/nightly";>Nightly</a>
-</li>
- </ul>
- <p><strong>Information</strong></p>
- <ul>
- <li> <a href="./index.html">Overview</a>
-</li>
- <li> <a href="./components.html">Components</a>
-</li>
- </ul>
- <p><strong>Components Repository</strong></p>
- <ul>
- <li> <a href="./beanutils.html">BeanUtils</a>
-</li>
- <li> <a href="./cactus/index.html">Cactus</a>
-</li>
- <li> <a href="./collections.html">Collections</a>
-</li>
- <li> <a href="./digester.html">Digester</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/dbcp/";>DBCP</a>
-</li>
- <li> <a href="./httpclient">HTTP Client</a>
-</li>
- <li> <a href="./jxpath/index.html">JXPath</a>
-</li>
- <li> <a href="./latka/index.html">Latka</a>
-</li>
- <li> <a href="./logging.html">Logging</a>
-</li>
- <li> <a href="./modeler.html">Modeler</a>
-</li>
- <li> <a href="./pool/index.html">Pool</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
-</li>
- </ul>
- <p><strong>Sandbox Components</strong></p>
- <ul>
- <li> <a href="./betwixt.html">Betwixt</a>
-</li>
- <li> <a href="./cli.html">CLI</a>
-</li>
- <li> <a
href="http://jakarta.apache.org/commons/sandbox/jelly/";>Jelly</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
-</li>
- <li> <a href="./messenger.html">Messenger</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
-</li>
- </ul>
- <p><strong>Jakarta Community</strong></p>
- <ul>
- <li> <a
href="http://jakarta.apache.org/site/getinvolved.html";>Get Involved</a>
-</li>
- <li> <a
href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a>
-</li>
- <li> <a
href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a>
-</li>
- </ul>
- <p><strong>Project Docs</strong></p>
- <ul>
- <li> <a href="./charter.html">Charter</a>
-</li>
- <li> <a href="./releases.html">Releases</a>
-</li>
- <li> <a href="./versioning.html">Versioning</a>
-</li>
- </ul>
- </td>
- <td width="80%" align="left" valign="top">
- <table
border="0" cellspacing="0" cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Messenger : a web based JMS framework"><strong>Messenger : a web
based JMS framework</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
- <ol>
-
-
-
- <li>
-
- <a href="messenger.html#Introduction">Introduction</a>
-
- </li>
-
-
-
- <li>
-
- <a href="messenger.html#Documentation">Documentation</a>
-
- </li>
-
-
-
- <li>
-
- <a href="messenger.html#Example Config">Example Configuration</a>
-
- </li>
-
-
-
- <li>
-
- <a href="messenger.html#Example Code">Example Code</a>
-
- </li>
-
-
-
- <li>
-
- <a href="messenger.html#Configuration">Configuration</a>
-
- </li>
-
-
-
- <li>
-
- <a href="messenger.html#Messagelets">Messagelets</a>
-
- </li>
-
- </ol>
-
-</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Introduction"><strong>Introduction</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
-<b>Proposed by :</b> James Strachan
-
-</p>
- <p>
-
- <b>Messenger</b> is a JMS (Java Message Service) framework
-
- which makes it very easy to use JMS in Web Service and Web Application
environments.
-
-</p>
- <p>
-
- Messenger allows much of the complexity of the JMS API to be hidden behind
-
- a simple facade API.
-
-</p>
- <p>
-
- In addition Messenger provides an XML deployment
-
- configuration file to avoid having to litter your code with complex deployment
-
- configuration details in your application code.
-
-</p>
- <p>
-
- Messenger also provides a Messagelet Engine which is a JMS based container
-
- that can be deployed in any Servlet Engine to process JMS messages
-
- via MessageListeners, Servlets or JSP.
-
-</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Documentation"><strong>Documentation</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
-The <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons-sandbox/messenger/dist/doc/api/index.html";>JavaDoc</a>
-
-from the last nightly build is available online
-
-or you can download a <a
href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-messenger/";>nightly
build</a>.
-
-</p>
- <p>
-
-There is also the
-
-<a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/messenger/STATUS.html";>status
document</a>.
-
-or the initial <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/messenger/PROPOSAL.html";>proposal</a>.
-
-</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Example Config"><strong>Example Config</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
- Here is an example <i>Messenger.xml</i> deployment configuration file.
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-<?xml version="1.0" encoding="UTF-8"?>
-
-<manager>
-
-
-
- <!-- this example Messenger XML config file should work with J2EE SDK -->
-
-
-
- <messenger name="topic">
-
- <jndi lookupName="TopicConnectionFactory">
-
- <property>
-
- <name>com.sun.jms.internal.java.naming.factory.initial</name>
-
-
<value>com.sun.enterprise.naming.SerialInitContextFactory</value>
-
- </property>
-
- </jndi>
-
- </messenger>
-
-
-
- <messenger name="queue">
-
- <jndi lookupName="QueueConnectionFactory">
-
- <property>
-
- <name>com.sun.jms.internal.java.naming.factory.initial</name>
-
-
<value>com.sun.enterprise.naming.SerialInitContextFactory</value>
-
- </property>
-
- </jndi>
-
- </messenger>
-
-
-
-</manager>
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
-It should work with the J2EE SDK to make 2 standard Messengers called
-
-<i>topic</i> and <i>queue</i> respectively.
-
-</p>
- <p>
-
- So how would we use these 2 Messengers from Java code?
-
-</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Example Code"><strong>Example Code</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
-Here's some example code to send a message on a topic.
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
-// get a Messenger and Destination
-
-Messenger messenger = MessengerManager.get( "topic" );
-
-Destination destination = messenger.getDestination( "CHAT.NEWBIES" );
-
-
-
-// now lets send a message
-
-TextMessage message = messenger.createTextMessage( "this is some text" );
-
-messenger.send( destination, message );
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
-Here's some code to receive a message on a queue, blocking until the message
arrives.
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
-// get a Messenger and Destination
-
-Messenger messenger = MessengerManager.get( "queue" );
-
-Destination destination = messenger.getDestination( "REQUEST.BUILD" );
-
-
-
-// now lets receive a message
-
-Message message = messenger.receive( destination );
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
-Notice how the construction of individual Messenger objects can be hidden behind
-
-the MessengerManager in a similar way to tools like <a
href="http://jakarta.apache.org/log4j/docs/index.html";>log4j</a>.
-
-</p>
- <p>
-
-Also notice that the Messenger API is a simple facade, no need for Topic and Queue
specific
-
-coding as well as the use of MessageConsumer, MessageProducer, TopicPublisher,
-
-TopicSubscriber, QueueSender, QueueReceiver and the plethora of Connection and
Session objects.
-
-</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Configuration"><strong>Configuration</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
- By default, Messenger will look for an XML document called <i>Messenger.xml</i>
-
- on the CLASSPATH as soon as a Messenger instance is looked up via the following
code.
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
-Messenger messenger = MessengerManager.get( "customer.orders" );
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
- An alternative approach is to define the system property
<i>org.apache.commons.messenger</i>
-
- to point to a URL of a Messenger deployment configuration document. For example
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
- $ java -Dorg.apache.commons.messenger=http://localhost/config/Messenger.xml
MyApplication
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
- In servlet environments its often a good idea to explicitly configure the
-
- singleton <i>MessengerManager</i>
-
- in a Servlet initialisation method using servlet initialisation parameters.
-
- Here's an example
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
-public class MyServlet extends HttpServlet {
+<body bgcolor="#ffffff" text="#000000" link="#525D76">
-
- public void init() throws ServletException {
-
- // initialise the Messenger connections
-
- String url = getInitParameter( "messenger" );
-
- if ( url != null ) {
-
- MessengerManager.configure( url );
-
- }
-
- }
-
-}
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- <table border="0" cellspacing="0"
cellpadding="2" width="100%">
- <tr><td bgcolor="#525D76">
- <font color="#ffffff" face="arial,helvetica,sanserif">
- <a name="Messagelets"><strong>Messagelets</strong></a>
- </font>
- </td></tr>
- <tr><td>
- <blockquote>
- <p>
-
- The Messenger project provides a Messagelet Engine which is
- a JMS based Container which runs in any Servlet Engine
- such as Tomcat 4.0.
-
- The Messagelet Engine provides a simple framework for processing JMS messages in
- a variety of ways using either regular JMS MessageListeners, Message Driven
Objects, Servlets or even JSP.
-</p>
- <p>
- In addition the Messagelet engine provides a Bridge mechanism which allows
messages
- to be consumed from one destination and connection and sent to another
destination,
- possibly using a different JMS connection and provider.
- This allows, for example, messages to be consumed on SpiritWave and sent to
MQSeries,
- possibly applying some custom transformation along the way.
-</p>
- <p>
- The Bridge mechanism is provided via the
- <a
href="messenger/api/org/apache/commons/messagelet/BridgeMDO.html">BridgeMDO</a>
- and using the <bridge> element inside a subscription deployment descriptor.
-</p>
- <p>
-
- To deploy a Messagelet Container you need to add the ManagerServlet in a web
-
- application giving it an XML configuration file describing all the various JMS
connections
-
- and an XML configuration file describing all the subscriptions.
-
-</p>
- <p>
-
- Here are example
-
- <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/messenger/src/conf/Messenger.xml?rev=1.3&content-type=text/vnd.viewcvs-markup";>connections</a>
-
- and
-
- <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/messenger/src/webapp/conf/subscriptions.xml?rev=1.6&content-type=text/vnd.viewcvs-markup";>subscriptions</a>
-
- XML configuration files.
-
- There now follows the section you need to add to your web.xml configuration file
to deploy the
-
- Messagelet Manager Servlet.
-
-</p>
- <div align="left">
- <table cellspacing="4" cellpadding="0" border="0">
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#ffffff"><pre>
-
-
-
- <servlet>
-
- <servlet-name>managerServlet</servlet-name>
-
-
<servlet-class>org.apache.commons.messagelet.ManagerServlet</servlet-class>
-
- <init-param>
-
- <param-name>connections</param-name>
-
- <param-value>/WEB-INF/Messenger.xml</param-value>
-
- </init-param>
-
- <init-param>
-
- <param-name>subscriptions</param-name>
-
- <param-value>/WEB-INF/subscriptions.xml</param-value>
-
- </init-param>
-
- <load-on-startup>1</load-on-startup>
-
- </servlet>
-
-</pre></td>
- <td bgcolor="#023264" width="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- <tr>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" height="1"><img src="/images/void.gif" width="1"
height="1" vspace="0" hspace="0" border="0"/></td>
- <td bgcolor="#023264" width="1" height="1"><img src="/images/void.gif"
width="1" height="1" vspace="0" hspace="0" border="0"/></td>
- </tr>
- </table>
- </div>
- <p>
-
- Once you've done the above and the web application is started the Messagelet
engine will
-
- subscribe to the various JMS subscriptions and then dispatch JMS messages to the
various
-
- MessageListener objects, Servlets or JSP pages.
-
-</p>
- <p>
-
- There are a variety of ways in which you can process JMS messages depending on
your requirements.
-
-</p>
- <ul>
-
-
-
-<li>
-
- A MessageListener is a standard JMS listener of messages.
-
-</li>
-
-
-
-<li>
-
- A <a
href="messenger/api/org/apache/commons/messagelet/MessageDrivenObject.html">MessageDrivenObject</a>
is-a JMS MessageListener which has
-
- extra servlet-based lifecycle methods just like a Servlet.
-
- This allows
-
- an MDO to know when its being initialised and when its being destroryed
-
- and so do some resource management (such as creating or closing database
-
- connections etc). Also on initialisation the MDO gets access to the
-
- ServletContext so that it can read some initialization parameters from
-
- the web application or perform web-app level logging and so on.
-
-</li>
-
-
-
-<li>
-
- A <a
href="messenger/api/org/apache/commons/messagelet/MessengerMDO.html">MessengerMDO</a>
is-a MessageDrivenObject
-
- but also provides a number of helper methods such as access to the Messenger to
-
- which its listening, so that responses can be sent back to the originator of the
message,
-
- as well as access to the ServletContext and some logging helper methods.
-
-</li>
-
-
-
-<li>
-
- A Servlet can be any GenericServlet or HttpServlet.
-
- If the JMS message that is being dispatched is a TextMessage then the body of the
message is
-
- available via the ServletRequest.getReader() method, in the normal Servlet way.
-
- Any output written to the ServletResponse.getWriter() will be converted into a
TextMessage
-
- and sent back to the originator.
-
- All servlets and JSP pages have access to the originating JMS message and
Messenger objects via
-
- the "message" and "messenger" request attributes respectively.
-
-</li>
-
-
-
-<li>
-
- A <a
href="messenger/api/org/apache/commons/messagelet/Messagelet.html">Messagelet</a>
-
- is a JMS specific Servlet, just like a HttpServlet is a HTTP specific Servlet. It
-
- provides access to a Messagelet specific
-
- <a
href="messenger/api/org/apache/commons/messagelet/MessageletRequest.html">MessageletRequest</a>
-
- and
-
- <a
href="messenger/api/org/apache/commons/messagelet/MessageletResponse.html">MessageletResponse</a>
-
- to allow access to the JMS Message and the Messenger for sending replies.
-
-</li>
-
-
-
-<li>
-
- A JSP page can be any piece of JSP, for example the standard JSP tag library can
be used
-
- to perform JavaScript, XPath, XSLT or SQL operations on the incoming message.
-
- The request scope "message" and "messenger" attributes can be used to access the
originating
-
- JMS Message and Messenger objects.
-
-</li>
-
-
-
-</ul>
- <p>There are some examples of an
MDO, Servlet and Messagelet
-
- <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/messenger/src/webapp/src/";>here</a>
or
-
- you can see example JSP
-
- <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/messenger/src/webapp/web/jms/";>here</a>
-
+<p>
+We have moved our Web Page. You should be redirected automatically. If not please
click the following link
</p>
- </blockquote>
- </p>
- </td></tr>
- <tr><td><br/></td></tr>
- </table>
- </td>
- </tr>
-
- <!-- FOOTER -->
- <tr><td colspan="2">
- <hr noshade="" size="1"/>
- </td></tr>
- <tr><td colspan="2">
- <div align="center"><font color="#525D76" size="-1"><em>
- Copyright © 1999-2002, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<a href="http://jakarta.apache.org/commons/sandbox/messenger";>Messenger Home
Page</a>
+</body>
+</html>
1.35 +1 -1 jakarta-commons/docs/commons.html
Index: commons.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/commons.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- commons.html 21 May 2002 09:39:52 -0000 1.34
+++ commons.html 22 May 2002 15:08:16 -0000 1.35
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.35 +1 -1 jakarta-commons/docs/beanutils.html
Index: beanutils.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/beanutils.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- beanutils.html 21 May 2002 09:39:52 -0000 1.34
+++ beanutils.html 22 May 2002 15:08:16 -0000 1.35
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.9 +1 -1 jakarta-commons/docs/logging.html
Index: logging.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/logging.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- logging.html 21 May 2002 09:39:52 -0000 1.8
+++ logging.html 22 May 2002 15:08:16 -0000 1.9
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.34 +1 -1 jakarta-commons/docs/charter.html
Index: charter.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/charter.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- charter.html 21 May 2002 09:39:52 -0000 1.33
+++ charter.html 22 May 2002 15:08:16 -0000 1.34
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.5 +1 -1 jakarta-commons/docs/cli.html
Index: cli.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/cli.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- cli.html 21 May 2002 09:39:52 -0000 1.4
+++ cli.html 22 May 2002 15:08:16 -0000 1.5
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.41 +2 -2 jakarta-commons/docs/sandbox.html
Index: sandbox.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/sandbox.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- sandbox.html 21 May 2002 09:39:52 -0000 1.40
+++ sandbox.html 22 May 2002 15:08:16 -0000 1.41
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
@@ -185,7 +185,7 @@
</li>
<li>
- <a href="messenger.html">
+ <a href="http://jakarta.apache.org/commons/sandbox/messenger/";>
Messenger</a>
proposal from James Strachan.
</li>
1.32 +1 -1 jakarta-commons/docs/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/license.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- license.html 21 May 2002 09:39:52 -0000 1.31
+++ license.html 22 May 2002 15:08:16 -0000 1.32
@@ -103,7 +103,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.32 +1 -1 jakarta-commons/docs/directory.html
Index: directory.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/directory.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- directory.html 21 May 2002 09:39:52 -0000 1.31
+++ directory.html 22 May 2002 15:08:16 -0000 1.32
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.26 +1 -1 jakarta-commons/docs/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/releases.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- releases.html 21 May 2002 09:39:52 -0000 1.25
+++ releases.html 22 May 2002 15:08:16 -0000 1.26
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.35 +1 -1 jakarta-commons/docs/contributors.html
Index: contributors.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/contributors.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- contributors.html 21 May 2002 09:39:52 -0000 1.34
+++ contributors.html 22 May 2002 15:08:16 -0000 1.35
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.4 +1 -1 jakarta-commons/docs/modeler.html
Index: modeler.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/modeler.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- modeler.html 21 May 2002 09:39:52 -0000 1.3
+++ modeler.html 22 May 2002 15:08:16 -0000 1.4
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.14 +1 -1 jakarta-commons/docs/betwixt.html
Index: betwixt.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/betwixt.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- betwixt.html 21 May 2002 09:39:52 -0000 1.13
+++ betwixt.html 22 May 2002 15:08:16 -0000 1.14
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.16 +1 -1 jakarta-commons/docs/versioning.html
Index: versioning.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/versioning.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- versioning.html 21 May 2002 09:39:52 -0000 1.15
+++ versioning.html 22 May 2002 15:08:16 -0000 1.16
@@ -106,7 +106,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.34 +2 -2 jakarta-commons/docs/components.html
Index: components.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/components.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- components.html 21 May 2002 09:39:52 -0000 1.33
+++ components.html 22 May 2002 15:08:16 -0000 1.34
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
@@ -406,7 +406,7 @@
<!-- /JJar -->
<!-- Messenger -->
- <dt><b><big><a
href="http://jakarta.apache.org/commons/messenger.html";>Messenger</a></big></b></dt>
+ <dt><b><big><a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a></big></b></dt>
<dd>
Messenger is an easy to use and lightweight framework for working with JMS in
the web tier.
</dd>
1.37 +1 -1 jakarta-commons/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/index.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- index.html 21 May 2002 09:39:52 -0000 1.36
+++ index.html 22 May 2002 15:08:16 -0000 1.37
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.25 +1 -1 jakarta-commons/docs/collections.html
Index: collections.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/collections.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- collections.html 21 May 2002 09:39:52 -0000 1.24
+++ collections.html 22 May 2002 15:08:16 -0000 1.25
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
1.21 +1 -1 jakarta-commons/docs/digester.html
Index: digester.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/digester.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- digester.html 21 May 2002 09:39:52 -0000 1.20
+++ digester.html 22 May 2002 15:08:16 -0000 1.21
@@ -102,7 +102,7 @@
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/";>JJar</a>
</li>
- <li> <a href="./messenger.html">Messenger</a>
+ <li> <a
href="http://jakarta.apache.org/commons/sandbox/messenger/";>Messenger</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/workflow/";>Workflow</a>
</li>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}