jstrachan 01/08/29 00:43:41
Modified: docs commons.html contributors.html index.html
sandbox.html
xdocs sandbox.xml
Added: docs messenger.html
xdocs messenger.xml
Log:
Added documentation for the Messenger project
Revision Changes Path
1.11 +0 -21 jakarta-commons/docs/commons.html
Index: commons.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/commons.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- commons.html 2001/08/17 23:31:35 1.10
+++ commons.html 2001/08/29 07:43:41 1.11
@@ -138,9 +138,7 @@
<tr><td>
<blockquote>
<p>
-
The following proposals for new Commons Proper projects are currently pending :
-
</p>
<ul>
@@ -148,44 +146,25 @@
<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.13 +162 -162 jakarta-commons/docs/contributors.html
Index: contributors.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/contributors.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- contributors.html 2001/08/22 13:13:39 1.12
+++ contributors.html 2001/08/29 07:43:41 1.13
@@ -1,162 +1,162 @@
-<!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]">
-
- <title>Commons - Commons 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/";><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>Information</strong></p>
- <ul>
- <li> <a href="./index.html">Overview</a>
-</li>
- <li> <a href="./commons.html">Commons Proper</a>
-</li>
- <li> <a href="./directory.html">Directory</a>
-</li>
- <li> <a href="./sandbox.html">Sandbox</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="http://cvs.apache.org/viewcvs/jakarta-commons/digester/";>Digester</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/dbcp/";>DBCP</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/";>HTTP Client</a>
-</li>
- <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</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>
- </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>We are the participants in Commons:</p>
- <ul>
- <li>Morgan Delagrange</li>
- <li>B.C. Holmes</li>
- <li>Ted Husted</li>
- <li>Conor MacNeill</li>
- <li>Geir Magnusson Jr.</li>
- <li>Costin Manolache</li>
- <li>Vincent Massol</li>
- <li>Remy Maucherat</li>
- <li>Craig R. McClanahan</li>
- <li>Ignacio J. Ortega</li>
- <li>Sung-Gu Park</li>
- <li>Juergen Pill</li>
- <li>Scott Sanders</li>
- <li>Dirk Verbeeck</li>
- <li>Rodney Waldhoff</li>
- <li>David Weinrich</li>
- <li>Jari Worsley</li>
- <li>James Strachan</li>
- </ul>
- <p>Join us!</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-2001, Apache Software Foundation
- </em></font></div>
- </td></tr>
- </table>
- </body>
- </html>
-<!-- end the processing -->
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+<!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]">
+
+ <title>Commons - Commons 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/";><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>Information</strong></p>
+ <ul>
+ <li> <a href="./index.html">Overview</a>
+</li>
+ <li> <a href="./commons.html">Commons Proper</a>
+</li>
+ <li> <a href="./directory.html">Directory</a>
+</li>
+ <li> <a href="./sandbox.html">Sandbox</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="http://cvs.apache.org/viewcvs/jakarta-commons/digester/";>Digester</a>
+</li>
+ <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/dbcp/";>DBCP</a>
+</li>
+ <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/";>HTTP Client</a>
+</li>
+ <li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</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>
+ </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>We are the participants in Commons:</p>
+ <ul>
+ <li>Morgan Delagrange</li>
+ <li>B.C. Holmes</li>
+ <li>Ted Husted</li>
+ <li>Conor MacNeill</li>
+ <li>Geir Magnusson Jr.</li>
+ <li>Costin Manolache</li>
+ <li>Vincent Massol</li>
+ <li>Remy Maucherat</li>
+ <li>Craig R. McClanahan</li>
+ <li>Ignacio J. Ortega</li>
+ <li>Sung-Gu Park</li>
+ <li>Juergen Pill</li>
+ <li>Scott Sanders</li>
+ <li>Dirk Verbeeck</li>
+ <li>Rodney Waldhoff</li>
+ <li>David Weinrich</li>
+ <li>Jari Worsley</li>
+ <li>James Strachan</li>
+ </ul>
+ <p>Join us!</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-2001, Apache Software Foundation
+ </em></font></div>
+ </td></tr>
+ </table>
+ </body>
+ </html>
+<!-- end the processing -->
+
+
+
+
+
+
+
+
+
+
+
+
+
+
1.15 +0 -80 jakarta-commons/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/index.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- index.html 2001/08/17 23:31:35 1.14
+++ index.html 2001/08/29 07:43:41 1.15
@@ -105,38 +105,25 @@
<blockquote>
<b>Welcome to the Commons!</b>
<p>
-
The Commons is a new Jakarta subproject focused on all aspects of
-
reusable Java components.
-
</p>
<p>The Jakarta Commons project is
composed of three parts:</p>
<ul>
<li>
-
<a href="#The Commons Proper">The Commons Proper</a> -
-
A repository of reusable Java components.
-
</li>
<li>
-
<a href="#The Directory">The Directory</a> -
-
A catalog of Java components in other projects.
-
</li>
<li>
-
<a href="#The Sandbox">The Sandbox</a> -
-
A workspace for Java component development.
-
</li>
</ul>
<p>You may also read our <a
href="charter.html">charter</a>, which spells out
-
the goals of the project in even greater detail.</p>
</blockquote>
</p>
@@ -152,50 +139,29 @@
<tr><td>
<blockquote>
<p>
-
The Commons Proper is dedicated to one principal
-
goal: creating and maintaining reusable Java components. The Commons
-
Proper is a place for collaboration and sharing, where
-
developers from throughout the Jakarta community can work together
-
on projects to be shared by the Jakarta projects and Jakarta users.
-
</p>
<p>
-
Commons developers will make an effort to ensure that their
-
components have minimal dependencies on other libraries, so that
-
these components can be deployed easily. In addition, Commons components
-
will keep their interfaces as stable as possible, so that Jakarta users
-
(including other Jakarta subprojects) can implement these
-
components without having to worry about changes in the future.
-
</p>
<p>
-
We welcome participation from all that are interested, at all skill levels.
-
Coding, documentation and testing are all critical parts of the software
-
development process. If you are interested in participating in any of
-
these aspects, please join us!
-
</p>
<p>
-
Click <a href="commons.html">here</a> to enter the Commons Proper,
-
or choose a specific Commons component from the list to the left.
-
</p>
</blockquote>
</p>
@@ -211,28 +177,17 @@
<tr><td>
<blockquote>
<p>
-
In addition to our repository of reusable components (Commons),
-
we also maintain a dynamic catalog of components and resources called
-
the Directory. The Directory lists components in other Jakarta and
-
ASF projects that are also designed for reuse in a manner similar to
-
Commons components. We also accept nominations for components outside
-
of Apache.
-
</p>
<p>
-
If you would like to nominate a component for inclusion in the
-
Directory, send a note to the <a
href="http://jakarta.apache.org/getinvolved/mail.html";>Commons mailing
-
list</a>.
-
</p>
<p>Click <a
href="directory.html">here</a> to enter the Directory.</p>
</blockquote>
@@ -249,26 +204,16 @@
<tr><td>
<blockquote>
<p>
-
This project also contains a workspace that is open to all
-
Jakarta committers. It's a place to try out new ideas and prepare
-
for inclusion into the Commons portion of the project or into another
-
Jakarta project. Users are free to experiment with the components
-
developed in the sandbox, but sandbox components will not necessarily
-
be maintained, particularly in their current state.
-
</p>
<p>
-
Click <a href="sandbox.html">here</a> to enter the sandbox and view
-
components currently in development.
-
</p>
</blockquote>
</p>
@@ -284,11 +229,8 @@
<tr><td>
<blockquote>
<p>
-
The individual components will have independent releases. The releases
-
currently available are listed here:
-
</p>
<ul>
<li><a
href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-beanutils/v1.0/";>Beanutils</a>
(Version 1.0)</li>
@@ -310,22 +252,14 @@
<tr><td>
<blockquote>
<p>
-
Nightly snapshots of the Commons CVS can be found at
-
<a href="http://jakarta.apache.org/builds/jakarta-commons/nightly/";>here</a>.
-
</p>
<p>
-
These are meant to provide easy access to the actual project CVS tree.
-
As this is our live development workspace, there are
-
no guarantees as to what you will find there,although we do our best to maintain
-
a buildable source tree.
-
</p>
</blockquote>
</p>
@@ -341,37 +275,23 @@
<tr><td>
<blockquote>
<p>
-
The Commons project really needs and appreciates any contributions,
-
including documentation help, source code and feedback.
-
</p>
<ul>
<li>
-
Discussion occurs on the <a
href="http://jakarta.apache.org/getinvolved/mail.html";>Commons mailing
-
list</a>.
-
</li>
<li>
-
Access to the CVS <strong>jakarta-commons</strong> repository is available
both
-
<a href="http://cvs.apache.org/viewcvs/jakarta-commons/";>online</a>
-
and with a <a
href="http://jakarta.apache.org/getinvolved/cvsindex.html";>cvs client</a>.
-
</li>
<li>
-
Access to the CVS <strong>jakarta-commons-sandbox</strong> repository is
available both
-
<a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/";>online</a>
-
and with a <a
href="http://jakarta.apache.org/getinvolved/cvsindex.html";>cvs client</a>.
-
</li>
</ul>
</blockquote>
1.17 +10 -0 jakarta-commons/docs/sandbox.html
Index: sandbox.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/sandbox.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- sandbox.html 2001/08/21 20:58:29 1.16
+++ sandbox.html 2001/08/29 07:43:41 1.17
@@ -141,6 +141,16 @@
Geir Magnusson Jr.
</li>
+ <li>
+ <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/betwixt/";>
+ Betwixt</a>
+ proposal from James Strachan.
+ </li>
+ <li>
+ <a href="messenger.html">
+ Messenger</a>
+ proposal from James Strachan.
+ </li>
</ul>
<p>
Go take a look!
1.1 jakarta-commons/docs/messenger.html
Index: messenger.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="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>Information</strong></p>
<ul>
<li> <a href="./index.html">Overview</a>
</li>
<li> <a href="./commons.html">Commons Proper</a>
</li>
<li> <a href="./directory.html">Directory</a>
</li>
<li> <a href="./sandbox.html">Sandbox</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="http://cvs.apache.org/viewcvs/jakarta-commons/digester/";>Digester</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/dbcp/";>DBCP</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/";>HTTP Client</a>
</li>
<li> <a
href="http://cvs.apache.org/viewcvs/jakarta-commons/pool/";>Pool</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>
</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 : Jakarta JMS Toolkit"><strong>Messenger : Jakarta JMS
Toolkit</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
<ol>
<li>
<a href="messenger.html#introduction">Introduction</a>
</li>
<li>
<a href="messenger.html#Example Config">Example Configuration</a>
</li>
<li>
<a href="messenger.html#Example Code">Example Code</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>Messenger</b> is a JMS (Java Message Service) Toolkit
to make JMS easy to use in Web Service and Web Application environments.
</p>
<p>
Messenger allows much of the complexity of the JMS API to be hidden behind
simple
XML deplyment configuration files.
Messenger also provides a standard Servlet that can be used to send or receive
JMS messages.
</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 deployment configuration file.
<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>
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>
Messenger messenger = MessengerManager.get( "topic" );
TextMessage message = messenger.createTextMessage( "this is some text" );
messenger.send( "CHAT.NEWBIES", 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>
Messenger messenger = MessengerManager.get( "queue" );
Message message = messenger.receive( "REQUEST.BUILD" );
</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>
</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-2001, Apache Software Foundation
</em></font></div>
</td></tr>
</table>
</body>
</html>
<!-- end the processing -->
1.11 +1 -1 jakarta-commons/xdocs/sandbox.xml
Index: sandbox.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/xdocs/sandbox.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- sandbox.xml 2001/08/24 15:37:43 1.10
+++ sandbox.xml 2001/08/29 07:43:41 1.11
@@ -50,7 +50,7 @@
proposal from James Strachan.
</li>
<li>
- <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/messenger/";>
+ <a href="messenger.html">
Messenger</a>
proposal from James Strachan.
</li>
1.1 jakarta-commons/xdocs/messenger.xml
Index: messenger.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<title>Messenger</title>
<author email="[EMAIL PROTECTED]">James Strachan</author>
</properties>
<body>
<section name="Messenger : Jakarta JMS Toolkit">
<p>
<ol>
<li>
<a href="messenger.html#introduction">Introduction</a>
</li>
<li>
<a href="messenger.html#Example Config">Example Configuration</a>
</li>
<li>
<a href="messenger.html#Example Code">Example Code</a>
</li>
</ol>
</p>
</section>
<section name="Introduction">
<p>
<b>Messenger</b> is a JMS (Java Message Service) Toolkit
to make JMS easy to use in Web Service and Web Application environments.
</p>
<p>
Messenger allows much of the complexity of the JMS API to be hidden behind
simple
XML deplyment configuration files.
Messenger also provides a standard Servlet that can be used to send or receive
JMS messages.
</p>
</section>
<section name="Example Config">
<p>
Here is an example deployment configuration file.
<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>
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>
</section>
<section name="Example Code">
<p>
Here's some example code to send a message on a topic.
</p>
<source><![CDATA[
Messenger messenger = MessengerManager.get( "topic" );
TextMessage message = messenger.createTextMessage( "this is some text" );
messenger.send( "CHAT.NEWBIES", message );
]]></source>
<p>
Here's some code to receive a message on a queue, blocking until the message
arrives.
</p>
<source><![CDATA[
Messenger messenger = MessengerManager.get( "queue" );
Message message = messenger.receive( "REQUEST.BUILD" );
]]></source>
<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>
</section>
</body>
</document>
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}
