rwaldhoff 02/04/22 17:22:46
Modified: docs beanutils.html betwixt.html charter.html
collections.html commons.html components.html
contributors.html digester.html directory.html
index.html jelly.html license.html logging.html
messenger.html releases.html sandbox.html
versioning.html
Added: docs/pool contributors.html downloads.html index.html
docs/pool/images jakarta-logo.gif logo.jpg
Log:
add pool site docs
Revision Changes Path
1.29 +1 -1 jakarta-commons/docs/beanutils.html
Index: beanutils.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/beanutils.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- beanutils.html 4 Mar 2002 04:27:26 -0000 1.28
+++ beanutils.html 23 Apr 2002 00:22:45 -0000 1.29
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.8 +34 -1 jakarta-commons/docs/betwixt.html
Index: betwixt.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/betwixt.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- betwixt.html 4 Mar 2002 04:27:26 -0000 1.7
+++ betwixt.html 23 Apr 2002 00:22:45 -0000 1.8
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -132,17 +132,29 @@
<tr><td>
<blockquote>
<p>
+
<ol>
+
+
<li>
+
<a href="betwixt.html#Introduction">Introduction</a>
+
</li>
+
+
<li>
+
<a href="betwixt.html#Documentation">Documentation</a>
+
</li>
+
+
</ol>
+
</p>
</blockquote>
</p>
@@ -158,20 +170,32 @@
<tr><td>
<blockquote>
<p>
+
<b>Proposed by :</b> James Strachan
+
</p>
<p>
+
<b>Betwixt</b>
+
</p>
<p>
+
The Betwixt library provides an XML introspection mechanism
+
for mapping beans to XML in a flexible way. It is implemented using an
+
XMLIntrospector and XMLBeanInfo classes which are similar to the standard
+
Introspector and BeanInfo from the Java Beans specification.</p>
<p>
+
Betwixt provides a way of turning beans into XML as well as automatically
+
generating digester rules in a way that can be customized on a per type
+
manner in the same way that the BeanInfo mechanism can be used to customize
+
the default introspection on a java object.</p>
</blockquote>
</p>
@@ -187,15 +211,24 @@
<tr><td>
<blockquote>
<p>
+
There is an <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/betwixt/OVERVIEW.html";>Overview</a>
document.
+
There is also the
+
<a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/betwixt/STATUS.html";>status
document</a>.
+
or the initial <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/betwixt/PROPOSAL.html";>proposal</a>.
+
</p>
<p>
+
The <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons-sandbox/betwixt/dist/docs/api/";>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-betwixt/";>nightly
build</a>.
+
</p>
</blockquote>
</p>
1.29 +1 -1 jakarta-commons/docs/charter.html
Index: charter.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/charter.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- charter.html 4 Mar 2002 04:27:26 -0000 1.28
+++ charter.html 23 Apr 2002 00:22:45 -0000 1.29
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.20 +1 -1 jakarta-commons/docs/collections.html
Index: collections.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/collections.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- collections.html 10 Apr 2002 16:30:30 -0000 1.19
+++ collections.html 23 Apr 2002 00:22:45 -0000 1.20
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.29 +22 -1 jakarta-commons/docs/commons.html
Index: commons.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/commons.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- commons.html 4 Mar 2002 04:27:26 -0000 1.28
+++ commons.html 23 Apr 2002 00:22:45 -0000 1.29
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -166,7 +166,9 @@
<tr><td>
<blockquote>
<p>
+
The following proposals for new Commons Proper projects are currently pending :
+
</p>
<ul>
@@ -174,25 +176,44 @@
<b>BeanUtils Package</b> : Craig McClanahan
</li>
+
<li>
+
<b>Database Connection Pool Package</b> : Rodney Waldhoff
+
</li>
+
+
<li>
+
<b>Object Pooling Package</b> : Rodney Waldhoff
+
</li>
+
+
<li>
+
<b>Collections Package</b> : Rodney Waldhoff
+
</li>
+
+
<li>
+
<b> Cactus, the renamed J2EEUnit</b> : Vincent Massol
+
</li>
+
+
</ul>
<p>
+
Please see the jakarta-commons mail list for further details.
+
</p>
</blockquote>
</p>
1.24 +2 -2 jakarta-commons/docs/components.html
Index: components.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/components.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- components.html 5 Apr 2002 18:37:08 -0000 1.23
+++ components.html 23 Apr 2002 00:22:45 -0000 1.24
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -292,7 +292,7 @@
<!-- /JXPath -->
<!-- Pool -->
- <dt><b><big><a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a></big></b></dt>
+ <dt><b><big><a href="./pool/index.html">Pool</a></big></b></dt>
<dd>
Commons-Pool provides generic object pooling services.
</dd>
1.30 +2 -1 jakarta-commons/docs/contributors.html
Index: contributors.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/contributors.html,v
retrieving revision 1.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- contributors.html 4 Mar 2002 04:27:26 -0000 1.29
+++ contributors.html 23 Apr 2002 00:22:45 -0000 1.30
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -134,6 +134,7 @@
<p>We are the participants in Commons:</p>
<ul>
<li>Morgan Delagrange</li>
+ <li>dIon Gillard</li>
<li>B.C. Holmes</li>
<li>Ted Husted</li>
<li>Conor MacNeill</li>
1.15 +1 -1 jakarta-commons/docs/digester.html
Index: digester.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/digester.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- digester.html 4 Mar 2002 04:27:26 -0000 1.14
+++ digester.html 23 Apr 2002 00:22:45 -0000 1.15
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.27 +1 -1 jakarta-commons/docs/directory.html
Index: directory.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/directory.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- directory.html 4 Mar 2002 04:27:26 -0000 1.26
+++ directory.html 23 Apr 2002 00:22:45 -0000 1.27
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.32 +1 -1 jakarta-commons/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/index.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- index.html 4 Mar 2002 04:27:26 -0000 1.31
+++ index.html 23 Apr 2002 00:22:45 -0000 1.32
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.3 +33 -1 jakarta-commons/docs/jelly.html
Index: jelly.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/jelly.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- jelly.html 4 Mar 2002 04:27:26 -0000 1.2
+++ jelly.html 23 Apr 2002 00:22:45 -0000 1.3
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -132,17 +132,29 @@
<tr><td>
<blockquote>
<p>
+
<ol>
+
+
<li>
+
<a href="jelly.html#Introduction">Introduction</a>
+
</li>
+
+
<li>
+
<a href="jelly.html#Documentation">Documentation</a>
+
</li>
+
+
</ol>
+
</p>
</blockquote>
</p>
@@ -158,19 +170,30 @@
<tr><td>
<blockquote>
<p>
+
<b>Proposed by :</b> James Strachan
+
</p>
<p>
+
<b>Jelly</b>
+
</p>
<p>The <em>Jelly</em> package
implements a simple XML tag based scripting
+
engine. Jelly borrows many ideas from both JSP custom tags, Velocity and the
+
scripting engine inside XDoclet. Jelly can be used from the command line, inside
+
Ant or inside a Servlet.
+
</p>
<p>
+
Jelly is completely extendable via custom tags in a similar way to JSP.
+
Though Jelly is really simple and has no dependencies either Servlets or JSP.
+
</p>
</blockquote>
</p>
@@ -186,15 +209,24 @@
<tr><td>
<blockquote>
<p>
+
There is an <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/jelly/OVERVIEW.html";>Overview</a>
document.
+
There is also the
+
<a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/jelly/STATUS.html";>status
document</a>.
+
or the initial <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/jelly/PROPOSAL.html";>proposal</a>.
+
</p>
<p>
+
The <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons-sandbox/jelly/dist/docs/api/";>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-jelly/";>nightly
build</a>.
+
</p>
</blockquote>
</p>
1.27 +1 -1 jakarta-commons/docs/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/license.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- license.html 4 Mar 2002 04:27:26 -0000 1.26
+++ license.html 23 Apr 2002 00:22:45 -0000 1.27
@@ -86,7 +86,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.4 +1 -1 jakarta-commons/docs/logging.html
Index: logging.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/logging.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- logging.html 4 Mar 2002 04:27:26 -0000 1.3
+++ logging.html 23 Apr 2002 00:22:45 -0000 1.4
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.22 +235 -1 jakarta-commons/docs/messenger.html
Index: messenger.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/messenger.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- messenger.html 4 Mar 2002 04:27:26 -0000 1.21
+++ messenger.html 23 Apr 2002 00:22:45 -0000 1.22
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
@@ -132,32 +132,59 @@
<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>
@@ -173,25 +200,41 @@
<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>
@@ -207,14 +250,22 @@
<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>
@@ -230,7 +281,9 @@
<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">
@@ -242,30 +295,55 @@
<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>
@@ -277,11 +355,16 @@
</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>
@@ -297,7 +380,9 @@
<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">
@@ -310,13 +395,22 @@
<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>
@@ -328,7 +422,9 @@
</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">
@@ -341,12 +437,20 @@
<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>
@@ -358,13 +462,20 @@
</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>
@@ -380,8 +491,11 @@
<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">
@@ -394,7 +508,10 @@
<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>
@@ -406,8 +523,11 @@
</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">
@@ -420,7 +540,10 @@
<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>
@@ -432,10 +555,15 @@
</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">
@@ -448,16 +576,28 @@
<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 {
+
+
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>
@@ -482,25 +622,43 @@
<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, Servlets or even JSP.
+
</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">
@@ -513,19 +671,34 @@
<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>
@@ -537,69 +710,130 @@
</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>
</blockquote>
</p>
1.21 +1 -1 jakarta-commons/docs/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/releases.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- releases.html 10 Apr 2002 17:02:58 -0000 1.20
+++ releases.html 23 Apr 2002 00:22:45 -0000 1.21
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.35 +1 -1 jakarta-commons/docs/sandbox.html
Index: sandbox.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/sandbox.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- sandbox.html 4 Mar 2002 04:27:26 -0000 1.34
+++ sandbox.html 23 Apr 2002 00:22:45 -0000 1.35
@@ -85,7 +85,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.11 +1 -1 jakarta-commons/docs/versioning.html
Index: versioning.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/versioning.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- versioning.html 4 Mar 2002 04:27:26 -0000 1.10
+++ versioning.html 23 Apr 2002 00:22:45 -0000 1.11
@@ -89,7 +89,7 @@
</li>
<li> <a href="./logging.html">Logging</a>
</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</a>
+ <li> <a href="./pool/index.html">Pool</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/";>Validator</a>
</li>
1.1 jakarta-commons/docs/pool/contributors.html
Index: contributors.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author"
value="Commons Documentation Team">
<meta name="email" value="[EMAIL PROTECTED]">
<meta name="author" value="Rodney Waldhoff">
<meta name="email" value="[EMAIL PROTECTED]">
<title>HTTP Client - Contributors</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/pool";><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="http://jakarta.apache.org/commons/index.html";>Jakarta Commons</a>
</li>
<li> <a href="./index.html">Pool</a>
</li>
</ul>
<p><strong>Information</strong></p>
<ul>
<li> <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons/pool/dist/docs/api/index.html";>API Documentation</a>
</li>
</ul>
<p><strong>Project Files</strong></p>
<ul>
<li> <a href="./downloads.html">Downloads</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>CVS</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons/pool/PROPOSAL.html?content-type=text/html";>Original Proposal</a>
</li>
</ul>
<p><strong>About Us</strong></p>
<ul>
<li> <a href="./contributors.html">Contributors</a>
</li>
<li> <a
href="http://jakarta.apache.org/commons/license.html";>License</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>
</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="Contributors"><strong>Contributors</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
The following volunteers have contributed code, documentation, testing
and support to <em>Pool</em>.
</p>
<ul>
<li>Morgan Delagrange</li>
<li>Geir Magnusson Jr.</li>
<li>Craig R. McClanahan</li>
<li>Rodney Waldhoff</li>
<li>David Weinrich</li>
</ul>
</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 -->
1.1 jakarta-commons/docs/pool/downloads.html
Index: downloads.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author"
value="Commons Documentation Team">
<meta name="email" value="[EMAIL PROTECTED]">
<meta name="author" value="Rodney Waldhoff">
<meta name="email" value="[EMAIL PROTECTED]">
<title>HTTP Client - Downloads</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/pool";><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="http://jakarta.apache.org/commons/index.html";>Jakarta Commons</a>
</li>
<li> <a href="./index.html">Pool</a>
</li>
</ul>
<p><strong>Information</strong></p>
<ul>
<li> <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons/pool/dist/docs/api/index.html";>API Documentation</a>
</li>
</ul>
<p><strong>Project Files</strong></p>
<ul>
<li> <a href="./downloads.html">Downloads</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>CVS</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons/pool/PROPOSAL.html?content-type=text/html";>Original Proposal</a>
</li>
</ul>
<p><strong>About Us</strong></p>
<ul>
<li> <a href="./contributors.html">Contributors</a>
</li>
<li> <a
href="http://jakarta.apache.org/commons/license.html";>License</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>
</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="Downloads"><strong>Downloads</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
Pool hasn't yet had an official release. Nightly source drops and
binaries
<a
href="http://jakarta.apache.org/builds/jakarta-commons/nightly/commons-pool/";>are
available</a>.
</p>
<p>
The CVS repository for <em>Pool</em> can be
<a href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>browsed
online</a>
or
<a href="http://jakarta.apache.org/site/cvsindex.html";>downloaded using
a CVS client</a>.
</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 -->
1.1 jakarta-commons/docs/pool/index.html
Index: index.html
===================================================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<meta name="author"
value="Commons Documentation Team">
<meta name="email" value="[EMAIL PROTECTED]">
<meta name="author" value="Rodney Waldhoff">
<meta name="email" value="[EMAIL PROTECTED]">
<title>HTTP Client - Home</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/pool";><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="http://jakarta.apache.org/commons/index.html";>Jakarta Commons</a>
</li>
<li> <a href="./index.html">Pool</a>
</li>
</ul>
<p><strong>Information</strong></p>
<ul>
<li> <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons/pool/dist/docs/api/index.html";>API Documentation</a>
</li>
</ul>
<p><strong>Project Files</strong></p>
<ul>
<li> <a href="./downloads.html">Downloads</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>CVS</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons/pool/PROPOSAL.html?content-type=text/html";>Original Proposal</a>
</li>
</ul>
<p><strong>About Us</strong></p>
<ul>
<li> <a href="./contributors.html">Contributors</a>
</li>
<li> <a
href="http://jakarta.apache.org/commons/license.html";>License</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>
</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="The Pool Component"><strong>The Pool Component</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>Pool provides an Object-pooling API.</p>
<p>
See the <a
href="http://nagoya.apache.org/gump/javadoc/jakarta-commons/pool/dist/docs/api/index.html";>javadoc</a>
for details.
</p>
<p>
See the <a href="downloads.html">downloads</a> page for information on
obtaining releases.
</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 -->
1.1 jakarta-commons/docs/pool/images/jakarta-logo.gif
<<Binary file>>
1.1 jakarta-commons/docs/pool/images/logo.jpg
<<Binary file>>
--
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}
