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
*/queue/FOO.BAR*<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
*/queue/FOO.BAR*</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'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
- (<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
+ (<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>
![http://goopen.org/confluence/images/icons/linkext7.gif"](http://goopen.org/confluence/images/icons/linkext7.gif"){kind=link}
![http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"](http://goopen.org/confluence/images/icons/emoticons/forbidden.gif"){kind=link}