activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jstrac...@apache.org
Subject svn commit: r415954 - in /incubator/activemq/site: connectivity.html stomp.html
Date Wed, 21 Jun 2006 10:24:35 GMT
Author: jstrachan
Date: Wed Jun 21 03:24:34 2006
New Revision: 415954

URL: http://svn.apache.org/viewvc?rev=415954&view=rev
Log:
Latest export from confluence

Modified:
    incubator/activemq/site/connectivity.html
    incubator/activemq/site/stomp.html

Modified: incubator/activemq/site/connectivity.html
URL: http://svn.apache.org/viewvc/incubator/activemq/site/connectivity.html?rev=415954&r1=415953&r2=415954&view=diff
==============================================================================
--- incubator/activemq/site/connectivity.html (original)
+++ incubator/activemq/site/connectivity.html Wed Jun 21 03:24:34 2006
@@ -69,7 +69,7 @@
 <UL class="alternate" type="square">
 	<LI><A href="home.html" title="Home">Home</A></LI>
 	<LI><A href="news.html" title="News">News</A></LI>
-	<LI><A href="changes-in-40.html" title="Changes in 4.0">New in 4.0</A></LI>
+	<LI><A href="new-features.html" title="New Features">New Features</A></LI>
 	<LI><A href="faq.html" title="FAQ">FAQ</A></LI>
 	<LI><A href="site.html" title="Site">Site</A></LI>
 	<LI><A href="articles.html" title="Articles">Articles</A></LI>
@@ -159,7 +159,7 @@
 	<LI><A href="kaha-persistence.html" title="Kaha Persistence">Kaha Persistence</A></LI>
 	<LI><A href="async-sends.html" title="Async Sends">Async Sends</A></LI>
 	<LI><A href="jmsxuserid.html" title="JMSXUserID">JMSXUserID</A></LI>
-	<LI><A href="changes-in-40.html" title="Changes in 4.0">Other new features</A></LI>
+	<LI><A href="new-features.html" title="New Features">More New Features</A></LI>
 </UL>
 
 

Modified: incubator/activemq/site/stomp.html
URL: http://svn.apache.org/viewvc/incubator/activemq/site/stomp.html?rev=415954&r1=415953&r2=415954&view=diff
==============================================================================
--- incubator/activemq/site/stomp.html (original)
+++ incubator/activemq/site/stomp.html Wed Jun 21 03:24:34 2006
@@ -69,7 +69,7 @@
 <UL class="alternate" type="square">
 	<LI><A href="home.html" title="Home">Home</A></LI>
 	<LI><A href="news.html" title="News">News</A></LI>
-	<LI><A href="changes-in-40.html" title="Changes in 4.0">New in 4.0</A></LI>
+	<LI><A href="new-features.html" title="New Features">New Features</A></LI>
 	<LI><A href="faq.html" title="FAQ">FAQ</A></LI>
 	<LI><A href="site.html" title="Site">Site</A></LI>
 	<LI><A href="articles.html" title="Articles">Articles</A></LI>
@@ -159,7 +159,7 @@
 	<LI><A href="kaha-persistence.html" title="Kaha Persistence">Kaha Persistence</A></LI>
 	<LI><A href="async-sends.html" title="Async Sends">Async Sends</A></LI>
 	<LI><A href="jmsxuserid.html" title="JMSXUserID">JMSXUserID</A></LI>
-	<LI><A href="changes-in-40.html" title="Changes in 4.0">Other new features</A></LI>
+	<LI><A href="new-features.html" title="New Features">More New Features</A></LI>
 </UL>
 
 
@@ -245,8 +245,7 @@
 <!--          
             <div class="pagetitle">Stomp</div>
 -->
-            <DIV class="wiki-content">
-<P>ActiveMQ supports the <SPAN class="nobr"><A href="http://stomp.codehaus.org/"
title="Visit page outside Confluence" rel="nofollow">Stomp<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN> protocol. This makes it easy to write
a client in pure <SPAN class="nobr"><A href="http://stomp.codehaus.org/Ruby" title="Visit
page outside Confluence" rel="nofollow">Ruby<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>,
<SPAN class="nobr"><A href="http://stomp.codehaus.org/Perl" title="Visit page outside
Confluence" rel="nofollow">Perl<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif"
height="0" width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN>,
Python or PHP for working with ActiveMQ.</P>
+            <DIV class="wiki-content"><P>ActiveMQ supports the <SPAN class="nobr"><A
href="http://stomp.codehaus.org/" title="Visit page outside Confluence" rel="nofollow">Stomp<SUP><IMG
class="rendericon" src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0"
width="0" align="absmiddle" alt="" border="0"></SUP></A></SPAN> protocol.
This makes it easy to write a client in pure <SPAN class="nobr"><A href="http://stomp.codehaus.org/Ruby"
title="Visit page outside Confluence" rel="nofollow">Ruby<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN>, <SPAN class="nobr"><A href="http://stomp.codehaus.org/Perl"
title="Visit page outside Confluence" rel="nofollow">Perl<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN>, Python or PHP for working 
 with ActiveMQ.</P>
 
 <P>Please see the <SPAN class="nobr"><A href="http://stomp.codehaus.org/"
title="Visit page outside Confluence" rel="nofollow">Stomp site<SUP><IMG class="rendericon"
src="http://goopen.org/confluence/images/icons/linkext7.gif" height="0" width="0" align="absmiddle"
alt="" border="0"></SUP></A></SPAN> for more details</P>
 
@@ -268,8 +267,30 @@
 
 <H3><A name="Stomp-WorkingwithDestinationswithStomp"></A>Working with Destinations
with Stomp</H3>
 
-<P>Note that the prefix in stomp <B>/queue/</B> or <B>/topic/</B>
is removed from the string before passing it to ActiveMQ as a JMS destination. Also note that
the default separator in MOM systems is . (DOT). So <B>FOO.BAR</B> is the normal
syntax of a MOM queue - the Stomp equivalent would be &#42;/queue/FOO.BAR&#42;<TABLE
cellpadding="5" width="85%" cellspacing="8px" class="warningMacro" border="0" align="center"><COLGROUP><COL
width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"
width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Be
careful about starting destinations with /</B><BR><BR>
-If in Stomp world you use <B>/queue/foo/bar</B> then in a JMS world the queue
would be called <B>foo/bar</B> not <B>/foo/bar</B>. </TD></TR></TABLE></P>
+<P>Note that the prefix in stomp <B>/queue/</B> or <B>/topic/</B>
is removed from the string before passing it to ActiveMQ as a JMS destination. Also note that
the default separator in MOM systems is . (DOT). So <B>FOO.BAR</B> is the normal
syntax of a MOM queue - the Stomp equivalent would be &#42;/queue/FOO.BAR&#42;</P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="warningMacro" border="0" align="center"><COLGROUP><COL
width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"
width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Be
careful about starting destinations with /</B><BR>
+<P>If in Stomp world you use <B>/queue/foo/bar</B> then in a JMS world
the queue would be called <B>foo/bar</B> not <B>/foo/bar</B>.</P></TD></TR></TABLE>
+
+<H3><A name="Stomp-WorkingwithJMSText%2FBytesMessagesandStomp"></A>Working
with JMS Text/Bytes Messages and Stomp</H3>
+
+<P>Stomp is a very simple protocol - that&apos;s part of the beauty of it!  As
such, it does not have knowledge of JMS messages such as TextMessages or BytesMessages.  The
protocol does however support a content-length header.  To provide more robust interaction
between Stomp and JMS clients, ActiveMQ keys off of the inclusion of this header to determine
what message type to create when sending from Stomp to JMS.  The logic is simple:</P>
+
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Inclusion of content-length header </TH>
+<TH class="confluenceTh"> Resulting Message </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> yes </TD>
+<TD class="confluenceTd"> BytesMessage </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> no </TD>
+<TD class="confluenceTd"> TextMessage </TD>
+</TR>
+</TBODY></TABLE>
+
+<P>This same logic can be followed when going from JMS to Stomp, as well.  A Stomp
client could be written to key off of the inclusion of the content-length header to determine
what type of message structure to provide to the user. </P>
 
 <H3><A name="Stomp-UsingJMSsemanticswithStomp"></A>Using JMS semantics
with Stomp</H3>
 
@@ -297,7 +318,7 @@
 <TR>
 <TD class="confluenceTd"> persistent </TD>
 <TD class="confluenceTd"> JMSDeliveryMode </TD>
-<TD class="confluenceTd"> whether or not the message is persistent</TD>
+<TD class="confluenceTd"> whether or not the message is persistent </TD>
 </TR>
 <TR>
 <TD class="confluenceTd"> priority </TD>
@@ -312,12 +333,12 @@
 <TR>
 <TD class="confluenceTd"> type </TD>
 <TD class="confluenceTd"> JMSType </TD>
-<TD class="confluenceTd"> sets the type of the message</TD>
+<TD class="confluenceTd"> sets the type of the message </TD>
 </TR>
 <TR>
 <TD class="confluenceTd"> JMSXGroupID </TD>
 <TD class="confluenceTd"> JMSXGroupID </TD>
-<TD class="confluenceTd">  for specifying the <A href="message-groups.html" title="Message
Groups">Message Groups</A> </TD>
+<TD class="confluenceTd"> for specifying the <A href="message-groups.html" title="Message
Groups">Message Groups</A> </TD>
 </TR>
 <TR>
 <TD class="confluenceTd"> JMSXGroupSeq </TD>
@@ -326,7 +347,6 @@
 </TR>
 </TBODY></TABLE>
 
-
 <H3><A name="Stomp-ActiveMQextensionstoStomp"></A>ActiveMQ extensions to
Stomp</H3>
 
 <P>You can add custom headers to Stomp commands to configure the ActiveMQ protocol.
Here are some examples</P>
@@ -359,7 +379,7 @@
 <TD class="confluenceTd"> SUBSCRIBE </TD>
 <TD class="confluenceTd"> activemq.maximumPendingMessageLimit </TD>
 <TD class="confluenceTd"> int </TD>
-<TD class="confluenceTd"> For <A href="slow-consumer-handling.html" title="Slow
Consumer Handling">Slow Consumer Handling</A> on non-durable topics by dropping old
messages - we can set a maximum pending limit which once a slow consumer backs up to this
high water mark we begin to discard old messages </TD>
+<TD class="confluenceTd"> For <A href="slow-consumer-handling.html" title="Slow
Consumer Handling">Slow Consumer Handling</A>on non-durable topics by dropping old
messages - we can set a maximum pending limit which once a slow consumer backs up to this
high water mark we begin to discard old messages </TD>
 </TR>
 <TR>
 <TD class="confluenceTd"> SUBSCRIBE </TD>
@@ -391,8 +411,7 @@
 <TD class="confluenceTd"> string </TD>
 <TD class="confluenceTd"> For durable topic subscriptions you must specify the same
clientId on the connection and subscriberName on the subscribe </TD>
 </TR>
-</TBODY></TABLE>
-</DIV>
+</TBODY></TABLE></DIV>
           
                   </DIV>
         </TD>
@@ -402,8 +421,8 @@
     </DIV>
     <DIV id="site-footer">
           Added by     <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=jstrachan">James
Strachan</A>,
-    last edited by     <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=jstrachan">James
Strachan</A> on May 12, 2006
-                  &nbsp;(<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=207&originalId=5470">view
change</A>)
+    last edited by     <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=nmittler">Nathan
Mittler</A> on Jun 21, 2006
+                  &nbsp;(<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=207&originalId=8837">view
change</A>)
               
       (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=207">edit
page</A>)
     </DIV>



Mime
View raw message