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="[EMAIL PROTECTED]"> <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: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>