You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by js...@apache.org on 2002/04/23 18:37:17 UTC
cvs commit: jakarta-commons/docs cli.html 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
jstrachan 02/04/23 09:37:17
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 cli.html
Log:
Added home page for CLI
Revision Changes Path
1.31 +2 -0 jakarta-commons/docs/beanutils.html
Index: beanutils.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/beanutils.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- beanutils.html 23 Apr 2002 01:45:26 -0000 1.30
+++ beanutils.html 23 Apr 2002 16:37:16 -0000 1.31
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.10 +2 -33 jakarta-commons/docs/betwixt.html
Index: betwixt.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/betwixt.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- betwixt.html 23 Apr 2002 01:45:26 -0000 1.9
+++ betwixt.html 23 Apr 2002 16:37:16 -0000 1.10
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
@@ -132,29 +134,17 @@
<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>
@@ -170,32 +160,20 @@
<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>
@@ -211,24 +189,15 @@
<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.31 +2 -0 jakarta-commons/docs/charter.html
Index: charter.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/charter.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- charter.html 23 Apr 2002 01:45:26 -0000 1.30
+++ charter.html 23 Apr 2002 16:37:16 -0000 1.31
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.22 +2 -0 jakarta-commons/docs/collections.html
Index: collections.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/collections.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- collections.html 23 Apr 2002 01:45:26 -0000 1.21
+++ collections.html 23 Apr 2002 16:37:16 -0000 1.22
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.31 +2 -21 jakarta-commons/docs/commons.html
Index: commons.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/commons.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- commons.html 23 Apr 2002 01:45:26 -0000 1.30
+++ commons.html 23 Apr 2002 16:37:16 -0000 1.31
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
@@ -166,9 +168,7 @@
<tr><td>
<blockquote>
<p>
-
The following proposals for new Commons Proper projects are currently pending :
-
</p>
<ul>
@@ -176,44 +176,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.26 +11 -2 jakarta-commons/docs/components.html
Index: components.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/components.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- components.html 23 Apr 2002 01:45:26 -0000 1.25
+++ components.html 23 Apr 2002 16:37:16 -0000 1.26
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
@@ -325,7 +327,7 @@
<dl>
<!-- Betwixt -->
- <dt><b><big><a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/betwixt/">Betwixt</a></big></b></dt>
+ <dt><b><big><a href="http://jakarta.apache.org/commons/betwixt.html">Betwixt</a></big></b></dt>
<dd>
Betwixt provides services for mapping JavaBeans to XML documents, and vice versa.
</dd>
@@ -345,6 +347,13 @@
</dd>
<!-- /CJAN -->
+ <!-- CLI -->
+ <dt><b><big><a href="http://jakarta.apache.org/commons/cli.html">CLI</a></big></b></dt>
+ <dd>
+ CLI provides a simple API for working with Comamnd Line arguments, options, option groups, mandatory options and so forth.
+ </dd>
+ <!-- /CLI-->
+
<!-- Email -->
<dt><b><big><a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/email/">Mail</a></big></b></dt>
<dd>
@@ -353,7 +362,7 @@
<!-- /Email -->
<!-- Jelly -->
- <dt><b><big><a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jelly/">Jelly</a></big></b></dt>
+ <dt><b><big><a href="http://jakarta.apache.org/commons/jelly.html">Jelly</a></big></b></dt>
<dd>
Jelly implements a simple XML based scripting engine combining the best parts from JSP tags, JSTL, Velocity and XDoclets
template system into a simple engine that can be run from the command line, from inside Ant or in Servlets.
1.32 +2 -0 jakarta-commons/docs/contributors.html
Index: contributors.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/contributors.html,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- contributors.html 23 Apr 2002 01:45:26 -0000 1.31
+++ contributors.html 23 Apr 2002 16:37:16 -0000 1.32
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.17 +2 -0 jakarta-commons/docs/digester.html
Index: digester.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/digester.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- digester.html 23 Apr 2002 01:45:26 -0000 1.16
+++ digester.html 23 Apr 2002 16:37:16 -0000 1.17
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.29 +2 -0 jakarta-commons/docs/directory.html
Index: directory.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/directory.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- directory.html 23 Apr 2002 01:45:26 -0000 1.28
+++ directory.html 23 Apr 2002 16:37:16 -0000 1.29
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.34 +2 -0 jakarta-commons/docs/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/index.html,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- index.html 23 Apr 2002 01:45:26 -0000 1.33
+++ index.html 23 Apr 2002 16:37:16 -0000 1.34
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.5 +2 -32 jakarta-commons/docs/jelly.html
Index: jelly.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/jelly.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- jelly.html 23 Apr 2002 01:45:26 -0000 1.4
+++ jelly.html 23 Apr 2002 16:37:16 -0000 1.5
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
@@ -132,29 +134,17 @@
<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>
@@ -170,30 +160,19 @@
<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>
@@ -209,24 +188,15 @@
<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.29 +2 -0 jakarta-commons/docs/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/license.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- license.html 23 Apr 2002 01:45:26 -0000 1.28
+++ license.html 23 Apr 2002 16:37:16 -0000 1.29
@@ -95,6 +95,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.6 +2 -0 jakarta-commons/docs/logging.html
Index: logging.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/logging.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- logging.html 23 Apr 2002 01:45:26 -0000 1.5
+++ logging.html 23 Apr 2002 16:37:16 -0000 1.6
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.24 +2 -234 jakarta-commons/docs/messenger.html
Index: messenger.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/messenger.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- messenger.html 23 Apr 2002 01:45:26 -0000 1.23
+++ messenger.html 23 Apr 2002 16:37:16 -0000 1.24
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
@@ -132,59 +134,32 @@
<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>
@@ -200,41 +175,25 @@
<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>
@@ -250,22 +209,14 @@
<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>
@@ -281,9 +232,7 @@
<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">
@@ -295,55 +244,30 @@
<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>
@@ -355,16 +279,11 @@
</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>
@@ -380,9 +299,7 @@
<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">
@@ -395,22 +312,13 @@
<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>
@@ -422,9 +330,7 @@
</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">
@@ -437,20 +343,12 @@
<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>
@@ -462,20 +360,13 @@
</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>
@@ -491,11 +382,8 @@
<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">
@@ -508,10 +396,7 @@
<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>
@@ -523,11 +408,8 @@
</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">
@@ -540,10 +422,7 @@
<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>
@@ -555,15 +434,10 @@
</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">
@@ -576,28 +450,16 @@
<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>
@@ -622,43 +484,25 @@
<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">
@@ -671,34 +515,19 @@
<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>
@@ -710,130 +539,69 @@
</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.23 +2 -0 jakarta-commons/docs/releases.html
Index: releases.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/releases.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- releases.html 23 Apr 2002 01:45:26 -0000 1.22
+++ releases.html 23 Apr 2002 16:37:16 -0000 1.23
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.37 +2 -0 jakarta-commons/docs/sandbox.html
Index: sandbox.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/sandbox.html,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- sandbox.html 23 Apr 2002 01:45:26 -0000 1.36
+++ sandbox.html 23 Apr 2002 16:37:16 -0000 1.37
@@ -94,6 +94,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.13 +2 -0 jakarta-commons/docs/versioning.html
Index: versioning.html
===================================================================
RCS file: /home/cvs/jakarta-commons/docs/versioning.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- versioning.html 23 Apr 2002 01:45:26 -0000 1.12
+++ versioning.html 23 Apr 2002 16:37:16 -0000 1.13
@@ -98,6 +98,8 @@
<ul>
<li> <a href="./betwixt.html">Betwixt</a>
</li>
+ <li> <a href="./cli.html">CLI</a>
+</li>
<li> <a href="./jelly.html">Jelly</a>
</li>
<li> <a href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/jjar/">JJar</a>
1.1 jakarta-commons/docs/cli.html
Index: cli.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="jstrachan@apache.org">
<title>Commons - </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="./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="./jelly.html">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="CLI : Command Line Interface"><strong>CLI : Command Line Interface</strong></a>
</font>
</td></tr>
<tr><td>
<blockquote>
<p>
<ol>
<li>
<a href="cli.html#Introduction">Introduction</a>
</li>
<li>
<a href="cli.html#Documentation">Documentation</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>CLI</b>
</p>
<p>
The CLI library provides a simple and easy to use API for working
with the command line arguments and options.</p>
<p>
CLI is based on ideas and code from
<ul>
<li>werken.opt by Bob Mcwhirter</li>
<li>The cli package in Avalon Excalibur by Peter Donald</li>
<li>Optz by John Keyes</li>
</ul>
</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>
There is the
<a href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/cli/STATUS.html">status document</a>.
or the initial <a href="http://cvs.apache.org/viewcvs/~checkout~/jakarta-commons-sandbox/cli/PROPOSAL.html">proposal</a>.
</p>
<p>
The <a href="http://nagoya.apache.org/gump/javadoc/jakarta-commons-sandbox/cli/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-cli/">nightly build</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 -->
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>