You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@servicemix.apache.org by ch...@apache.org on 2006/11/05 21:24:39 UTC
svn commit: r471522 [2/2] - in /incubator/servicemix/site/sm30ug: ./
basic-old.data/ bpel-example.data/ file-binding-old.data/
http-binding.data/ jms-binding.data/ quartz-binding.data/ rss-binding.data/
Added: incubator/servicemix/site/sm30ug/http-binding.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/http-binding.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/http-binding.html (added)
+++ incubator/servicemix/site/sm30ug/http-binding.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,244 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+HTTP binding
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content">
+<H3><A name="HTTPbinding-OverviewoftheServiceMix2.xHTTPBindingExample"></A>Overview of the ServiceMix 2.x <EM>HTTP Binding</EM> Example</H3>
+
+<P>The following procedure describes how to run the <EM>HTTP Binding</EM> example in ServiceMix and provides details regarding what the HTTP Binding does. For information on the business use case, please refer to: <SPAN class="nobr"><A href="http://www.servicemix.org/Use%20Cases" title="Visit page outside Confluence" rel="nofollow">Use Case for HTTP Binding<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>.
+<BR clear="all">
+<BR clear="all">
+The HTTP Binding example illustrates:</P>
+<UL>
+ <LI>use of declarative programming</LI>
+ <LI>how to perform an HTTP binding in ServiceMix</LI>
+</UL>
+
+
+<P>The source code for the <EM>HTTP Binding</EM> example is located in the ServiceMix installation directory under the <TT>examples\http-binding</TT> directory in the <TT>servicemix.xml</TT> file. It is recommended that you refer to the source code while reading this document.
+<BR clear="all">
+<BR clear="all">
+In short, this example invokes a web service to ask for a stock price. In more detail, this example shows how to use an HTTP binding to handle a simple HTTP post. One component acts as the HTTP server, which listens on <SPAN class="nobr"><A href="http://localhost:8912/" title="Visit page outside Confluence" rel="nofollow">http://localhost:8912<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>, while another component invokes a remote service, implemented as an URLEndpoint. A simple HTTP client is provided so that a simple post can be sent to the server.</P>
+
+<H3><A name="HTTPbinding-RunningtheHTTPBindingExample"></A>Running the <EM>HTTP Binding</EM> Example</H3>
+
+<OL>
+ <LI>From a command shell, go to the HTTP Binding example directory:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM:servicemix_install_dir]\examples\http-binding</PRE>
+</DIV></DIV>
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed originally.</P></LI>
+ <LI>Then type:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</PRE>
+</DIV></DIV></LI>
+ <LI>To start sending and receiving messages from the HTTP server, send an initial message. To do this, compile and then run a simple HTTP client. The HTTP client used in this example, is built and run from source code using Ant. Execute Ant from the <EM>HTTP Binding</EM> directory: <TT>servicemix_install_dir\examples\http-binding</TT>. To run the HTTP client type:
+<BR clear="all">
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">ant</PRE>
+</DIV></DIV>
+<P><BR clear="all">
+Ant will compile and run the simple HTTP client, <EM>HttpClient</EM>, which performs a simple post on the HTTP Server into the ServiceMix container, before returning the results to the console.</P></LI>
+</OL>
+
+
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>
+<P>Add <EM>$SERVICEMIX_HOME\bin</EM> directory to <EM>$PATH</EM> variable to simplify execution of the example.</P></TD></TR></TABLE>
+<P><BR clear="all"></P>
+
+<H3><A name="HTTPbinding-StoppingtheHTTPBindingExample"></A>Stopping the <EM>HTTP Binding</EM> Example</H3>
+<P>To terminate the <EM>HTTP Binding</EM> example, type "CTRL-C" in the command shell in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.
+<BR clear="all"></P>
+
+<H3><A name="HTTPbinding-HowitWorks"></A>How it Works</H3>
+<P>The diagram below illustrates the flow of messages through the <EM>HTTP Binding</EM> components:
+<BR clear="all">
+<BR clear="all"></P>
+
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; "><B>HTTP Binding Example Message Flow Diagram</B></DIV><DIV class="panelContent">
+<P><DIV align="center"><IMG src="http-binding.data/httpflow.jpg" border="0"></DIV></P>
+</DIV></DIV>
+
+<P><BR clear="all">
+Messages flow through the components as follows:</P>
+
+<OL>
+ <LI>HttpClient, a Java stand-alone program, connects to <SPAN class="nobr"><A href="http://localhost:8912/" title="Visit page outside Confluence" rel="nofollow">http://localhost:8912<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> through the URLConnection class. HttpClient sends the file <TT>request.xml</TT> to this port.</LI>
+ <LI>httpReceiver, an HTTP server, being a listener on <SPAN class="nobr"><A href="http://localhost:8912/" title="Visit page outside Confluence" rel="nofollow">http://localhost:8912<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> receives the message.</LI>
+ <LI>httpReceiver sends the message to stockQuote as specified in its destinationService property, via NMR.</LI>
+ <LI>stockQuote sends the message into another service, soapEndpoint for processing.</LI>
+ <LI>soapEndpoint sends the response to stockQuote.</LI>
+ <LI>stockQuote sends the response to httpReceiver via NMR.</LI>
+ <LI>httpReceiver sends the response to <SPAN class="nobr"><A href="http://localhost:8912/" title="Visit page outside Confluence" rel="nofollow">http://localhost:8912<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>.</LI>
+ <LI>HttpClient reads the response.</LI>
+ <LI>The response is printed on the console.</LI>
+</OL>
+
+
+<P>Typical output looks like the following two screens.</P>
+
+<P>Output from running <TT>[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</TT>: </P>
+
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">Loading ServiceMix from file: C:\exist\servicemix\servicemix-2.0.2\examples\http
+-binding\servicemix.xml
+17:34:34.768 EVENT Starting Jetty/4.2.20RC0
+17:34:34.848 EVENT Started ServletHttpContext[/]
+17:34:34.858 EVENT Started SocketListener on 127.0.0.1:8912
+17:34:34.858 EVENT Started org.mortbay.jetty.Server@1f06dc3</PRE>
+</DIV></DIV>
+
+<P>Output from running Ant: </P>
+
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">Buildfile: build.xml
+
+init:
+
+compile:
+
+run:
+ [SM:echo] Running example client
+ [SM:java] <?xml version=<SPAN class="code-quote">"1.0"</SPAN> encoding=<SPAN class="code-quote">"UTF-8"</SPAN>?><soap:Envelope xmlns:soap="htt
+p:<SPAN class="code-comment">//schemas.xmlsoap.org/soap/envelope/<SPAN class="code-quote">" xmlns:xsi="</SPAN>http://www.w3.org/2001/XMLSch
+</SPAN>ema-instance<SPAN class="code-quote">" xmlns:xsd="</SPAN>http:<SPAN class="code-comment">//www.w3.org/2001/XMLSchema<SPAN class="code-quote">" xmlns:soapenc="</SPAN>http:/
+</SPAN>/schemas.xmlsoap.org/soap/encoding/<SPAN class="code-quote">" soap:encodingStyle="</SPAN>http:<SPAN class="code-comment">//schemas.xmlsoap.
+</SPAN>org/soap/encoding/<SPAN class="code-quote">"><soap:Body><n:getQuoteResponse xmlns:n="</SPAN>urn:xmethods-delayed
+-quotes<SPAN class="code-quote">"><Result xsi:type="</SPAN>xsd:<SPAN class="code-object">float</SPAN>">88.8</Result></n:getQuoteResponse></soap:B
+ody></soap:Envelope>asdf
+
+BUILD SUCCESSFUL
+Total time: 6 seconds</PRE>
+</DIV></DIV>
+
+<H3><A name="HTTPbinding-Details"></A>Details</H3>
+
+<P>The following table provides more details about the function of each component and bean in the servicemix.xml file:
+<BR clear="all">
+<BR clear="all"></P>
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh">Component or Bean ID</TH>
+<TH class="confluenceTh">Description</TH>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>jbi</EM></TD>
+<TD class="confluenceTd"><EM>jbi</EM> is the "id" of the JBI container and provides the basic infrastructure services for the following components: httpReceiver and stockQuote. During initialization, several singletons are instantiated: URLEndpoint and JBI. After initialization, the components in the JBI container are activated.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>httpReceiver</EM></TD>
+<TD class="confluenceTd">This component is an HTTP server that listens at <SPAN class="nobr"><A href="http://localhost/8912" title="Visit page outside Confluence" rel="nofollow">http://localhost/8912<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>. It forwards the message it receives from this URL to <EM>stockQuote</EM> as specified in its destinationService property in the <TT>servicemix.xml</TT> file.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>stockQuote</EM></TD>
+<TD class="confluenceTd">This is a SaajBinding component that invokes an endpoint service called soapEndpoint. It is implemented by the SaajBinding class which converts an inbound JBI message into a SAAJ (Soap With Attachments for Java) request-response and sends the response back to httpReceiver. This provides a message centric way of invoking SOAP services inside providers such as Apache Axis. This component invokes a web service to get a stock price. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>soapEndpoint</EM></TD>
+<TD class="confluenceTd"> A URLEndpoint object contains a URL, which is used to make connections to the remote party. A stand-alone client can pass a URLEndpoint object to the SOAPConnection method call to send a message.</TD>
+</TR>
+</TBODY></TABLE>
+
+<H3><A name="HTTPbinding-UsefulCodeHints"></A>Useful Code Hints</H3>
+<P>This section describes the start-up sequence and how the ServiceMix container interacts with the <EM>HTTP Binding</EM> application. The Java class files are located in the servicemix-2.0.2.jar file in the ServiceMix installation directory. To review the Java source code, unjar and decompile the .class files or <SPAN class="nobr"><A href="http://www.servicemix.org/Download" title="Visit page outside Confluence" rel="nofollow">download<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> the source code. </P>
+
+<P>Viewing the Java source code is recommended for understanding the information in this section.</P>
+
+<OL>
+ <LI>The ServiceMix container reads the <TT>servicemix.xml</TT> file and instantiates the components specified through SpringJBIContainer class.</LI>
+ <LI>The container calls the afterPropertiesSet() method of the SpringJBIContainer to register the components and the activationSpecs. In this case, httpReceiver and stockQuote are registered as activationSpecs.</LI>
+ <LI>The SpringJBIContainer uses the ActivationSpec class as the container for component specific properties, such as routing information.</LI>
+</OL>
+
+
+<P>Some of the ActivationSpec methods are:</P>
+<OL>
+ <LI>setId - takes the spring:id=jbi and sets the id of the container to "jbi"</LI>
+ <LI>setcomponentName - sets componentName to httpReceiver on first invocation and "stockQuote" in the next</LI>
+ <LI>setEndpoint - sets the endpoint properties from the servicemix.xml file</LI>
+ <LI>setService - sets the service properties from xml file</LI>
+ <LI>setDestinationService - sets the destinationService for each component</LI>
+</OL>
+
+
+<P><B><EM>HttpConnector</EM> Details</B></P>
+
+<OL>
+ <LI>The ServiceMix container reads the <TT>servicemix.xml</TT> file and to determine that it needs to instantiate a <B>HttpConnector</B>.</LI>
+ <LI>The container calls the init() method of <B>HttpConnector</B>. The init() method sets the listener's host and port property for which the <B>HttpConnector</B> will listen.</LI>
+ <LI>The container calls the start() method of <B>HttpConnector</B>. The start() method will:<BR>
+A. Add a listener object to the server property of <B>HttpConnector</B>.<BR>
+B. Create a new HttpContext that contains a ServletHandler class. The ServletHandler maps requests to servlets that implement the javax.servlet.http.HttpServlet API. In this case, the ServletHandler maps the request to the BindingServlet class.<BR>
+C. The server property of <B>HttpConnector</B> is started. </LI>
+</OL>
+
+
+<P><B><EM>stockQuote</EM> Details</B></P>
+
+<OL>
+ <LI>HttpConnector sends messages to this component as specified on its destinationService property. When this component receives a message, its onMessageExchange() method is called by the container. The onMessageExchange() method will:<BR>
+A. Create a SOAPConnection to be used in sending the message to URLEndpoint.<BR>
+B. Marshall an inbound JBI inbound into a SOAPMessage, before sending it to the URLEndpoint, as specified in the soapEndpoint property of stockQuote. A response is also requested from the URLEndpoint.<BR>
+C. The response, which is a SOAPMessage, is marshalled into a Normalized Message and is eventually sent to HttpConnector.</LI>
+</OL>
+
+
+<H3><A name="HTTPbinding-RelatedDocumentation"></A>Related Documentation</H3>
+<P>For more information on the following topics please see:</P>
+
+<UL>
+ <LI><A href="../SM/glossary.html#Glossary-NMR" title="NMR on Glossary">NMR</A></LI>
+</UL>
+
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://java.sun.com/webservices/saaj/index.jsp" title="Visit page outside Confluence" rel="nofollow">SAAJ<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></LI>
+</UL>
+
+
+<P>For more details on the web service which supplies the stock prices, please see: <SPAN class="nobr"><A href="http://xmethods.net/ve2/ViewListing.po?key=uuid:889A05A5-5C03-AD9B-D456-0E54A527EDEE" title="Visit page outside Confluence" rel="nofollow">XMethods<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>.</P>
+
+<P>For a brief explanation of the XML tags in the <TT>servicemi.xml</TT> file, please see:</P>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" title="Visit page outside Confluence" rel="nofollow">XSD<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></LI>
+</UL>
+
+
+<P><BR clear="all"></P>
+
+</DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=rajdavies">Rob Davies</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=2058&originalId=14762">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=2058">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg?view=auto&rev=471522
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg.jpeg?view=auto&rev=471522
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/sm30ug/jms-binding.data/jmsflow.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/sm30ug/jms-binding.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/jms-binding.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/jms-binding.html (added)
+++ incubator/servicemix/site/sm30ug/jms-binding.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,247 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+jms-binding
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content">
+<H3><A name="jms-binding-OverviewoftheServiceMix2.xJMSBindingExample"></A>Overview of the ServiceMix 2.x <EM>JMS Binding</EM> Example</H3>
+
+<P>The following procedure describes how to run the <EM>JMS Binding</EM> example and provides details regarding what it does. For information on the business use case, please refer to: <SPAN class="nobr"><A href="http://www.servicemix.org/Use%20Cases" title="Visit page outside Confluence" rel="nofollow">Use Case for JMS Binding<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>.
+<BR clear="all">
+<BR clear="all">
+The JMS Binding example illustrates:</P>
+<UL>
+ <LI>use of declarative programming</LI>
+ <LI>how to perform JMS integration in ServiceMix</LI>
+ <LI>how to use an <SPAN class="nobr"><A href="http://www.activemq.org/Spring%20Support" title="Visit page outside Confluence" rel="nofollow">ActiveMQ<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> message broker</LI>
+ <LI>how to use the <SPAN class="nobr"><A href="http://jencks.org/" title="Visit page outside Confluence" rel="nofollow">Jencks<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> JCA container</LI>
+ <LI>how to use the <SPAN class="nobr"><A href="http://geronimo.apache.org/" title="Visit page outside Confluence" rel="nofollow">Geronimo<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> Transaction Manager via the <SPAN class="nobr"><A href="http://jencks.org/Transaction%20Manager" title="Visit page outside Confluence" rel="nofollow">Jencks factory bean<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></LI>
+</UL>
+
+
+
+<P>The source code for the <EM>JMS Binding</EM> example is located in the ServiceMix installation directory under the <TT>examples\jms-binding</TT> directory in the <TT>servicemix.xml</TT> file. It is recommended that you refer to the source code while reading this document.
+<BR clear="all">
+<BR clear="all">
+This example shows how to connect the JMS bindings to a simple service component. One component listens for a JMS message on topic 'demo.org.servicemix.source' while another publishes processed messages to topic 'demo.org.servicemix.result'. A simple JMS client is provided so that messages can be sent and received to and from the ServiceMix Container.</P>
+
+<H3><A name="jms-binding-RunningtheJMSBindingExample"></A>Running the <EM>JMS Binding</EM> Example</H3>
+
+<OL>
+ <LI>From a command shell, go to the JMS Binding example directory:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM:servicemix_install_dir]\examples\jms-binding</PRE>
+</DIV></DIV>
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed.</P></LI>
+ <LI>Then type:
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</PRE>
+</DIV></DIV></LI>
+ <LI>To start sending and receiving of messages from the JMS topics, send JMS an initial message. To do this, compile and run a simple JMS client. The client is built and run from source code using Ant. Execute Ant from the <EM>JMS Binding</EM> directory: <TT>servicemix_install_dir\examples\jms-binding</TT>. To run the JMS client type:
+<BR clear="all">
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">ant</PRE>
+</DIV></DIV>
+<P><BR clear="all">
+Ant will compile and run the simple JMS client, <EM>JMSClient</EM>, which performs a JMS based request-response into the ServiceMix container before returning the results to the console.
+<BR clear="all">
+<BR clear="all"></P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>
+<P>Add <EM>$SERVICEMIX_HOME\bin</EM> directory to <EM>$PATH</EM> variable to simplify execution of the example.</P></TD></TR></TABLE></LI>
+</OL>
+
+
+<H3><A name="jms-binding-StoppingtheJMSBindingExample"></A>Stopping the <EM>JMS Binding</EM> Example</H3>
+<P>To terminate the <EM>JMS Binding</EM> example, type "CTRL-C" in the command shell in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.
+<BR clear="all"></P>
+
+<H3><A name="jms-binding-HowitWorks"></A>How it Works</H3>
+<P>The diagram below illustrates the flow of messages through the <EM>JMS Binding</EM> components:
+<BR clear="all">
+<BR clear="all"></P>
+
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; "><B>JMS Binding Example Message Flow Diagram</B></DIV><DIV class="panelContent">
+<P><DIV align="center"><IMG src="jms-binding.data/jmsflow.jpg" border="0"></DIV></P>
+</DIV></DIV>
+
+<P><BR clear="all">
+Messages flow through the components as follows:</P>
+<OL>
+ <LI><EM>JMSClient</EM>, through ActiveMQConnectionFactory, connects to the topic named "demo.org.servicemix.source" and sends a text message.</LI>
+ <LI><EM>jencks</EM> (the JCA resource adapter) listens on port 61616 for messages.</LI>
+ <LI><EM>inputReceiver</EM> subscribes to the "demo.org.servicemix.source" topic via <EM>jencks</EM> and receives the JMS message.</LI>
+ <LI><EM>inputReceiver</EM> normalizes the JMS message and sends it to <EM>outputSender</EM> via the Normalized Message Router (NMR).</LI>
+ <LI><EM>outputSender</EM> marshals the normalized message to a JMS message and uses <EM>jmsTemplate</EM> to publish the message on the "demo.org.servicemix.result" topic.</LI>
+ <LI><EM>jmsTemplate</EM> publishes it on the "demo.org.servicemix.result" topic using <EM>jmsFactory</EM> to get a connection to the result topic.</LI>
+ <LI><EM>JMSClient</EM>, also a subscriber of topic "demo.org.servicemix.result," receives the message.</LI>
+ <LI>The response is printed on the console.</LI>
+</OL>
+
+
+
+<P>Typical output looks like the following: </P>
+
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">Loading ServiceMix from file: C:\exist\servicemix\servicemix-2.0.1\examples\jms--binding\servicemix.xml
+[SM:INFO] XBeanXmlBeanDefinitionReader - Loading XML bean definitions from file [C:\exist\servicemix\servicemix-2.0.1\examples\jms-binding\servicemix.xml]
+[SM:INFO] FileSystemXmlApplicationContext - Bean factory <SPAN class="code-keyword">for</SPAN> application context [SM:org.xbean.spring.context.FileSystemXmlApplicationContext;hashCode=22540508]:
+ org.springframework.beans.factory.support.DefaultListableBeanFactory defining beans[SM:jbi,jencks,broker,
+transactionContextManager,transactionManager,jmsFactory]; root of BeanFactory hierarchy
+[SM:INFO] FileSystemXmlApplicationContext - 6 beans defined in application context [SM:org.xbean.spring.context.FileSystemXmlApplicationContext;hashCode=22540508]
+[SM:INFO] CollectionFactory - JDK 1.4+ collections available
+[SM:INFO] CollectionFactory - Commons Collections 3.x available
+[SM:INFO] FileSystemXmlApplicationContext - Unable to locate MessageSource with name 'messageSource': using <SPAN class="code-keyword">default</SPAN> [SM:org.springframework.context.support.Delegating
+MessageSource@a8c488]
+[SM:INFO] FileSystemXmlApplicationContext - Unable to locate ApplicationEventMulticaster with name 'applicationEventMulticaster':
+using <SPAN class="code-keyword">default</SPAN> [SM:org.springframework.context.event.SimpleApplicationEventMulticaster@76cbf7]
+[SM:INFO] DefaultListableBeanFactory - Pre-instantiating singletons in factory [org.springframework.beans.factory.support.DefaultListableBeanFactory defining beans
+ [SM:jbi,jencks,broker,transactionContextManager,transactionManager,jmsFactory]; root of BeanFactory hierarchy]
+[SM:INFO] SpringBrokerContainerFactory - Loading ActiveMQ broker from configuration: class path resource [SM:activemq.xml]
+[SM:INFO] ActiveMQBeanDefinitionReader - Loading XML bean definitions from class path resource [SM:activemq.xml]
+[SM:INFO] BrokerContainerImpl - ActiveMQ 3.2 JMS Message Broker (ID:el2tong-1857-1132035585799-1:0) is starting
+[SM:INFO] BrokerContainerImpl - For help or more information please see: http:<SPAN class="code-comment">//www.logicblaze.com
+</SPAN>[SM:INFO] JDBCPersistenceAdapter - Database driver recognized: [SM:apache_derby_embedded_jdbc_driver]
+[SM:INFO] DefaultJDBCAdapter - Could not create JDBC tables; they could already exist. Failure was:
+CREATE TABLE ACTIVEMQ_MSGS(ID INTEGER NOT NULL, CONTAINER VARCHAR(250), MSGID VARCHAR(250), MSG BLOB, PRIMARY KEY ( ID ) ) Message: Table/View
+'ACTIVEMQ_MSGS' already exists in Schema 'APP'. SQLState: X0Y32 Vendor code: 20000
+[SM:INFO] DefaultJDBCAdapter - Could not create JDBC tables; they could already exist. Failure was:
+ CREATE TABLE ACTIVEMQ_TXS(XID VARCHAR(250) NOT NULL, PRIMARY KE
+Y ( XID )) Message: Table/View 'ACTIVEMQ_TXS' already exists in Schema 'APP'. SQLState: X0Y32 Vendor code: 20000
+[SM:INFO] DefaultJDBCAdapter - Could not create JDBC tables; they could already exist. Failure was: CREATE TABLE ACTIVEMQ_ACKS(SUB VARCHAR(250) NOT NULL, CONTAINER
+ VARCHAR(250) NOT NULL, LAST_ACKED_ID INTEGER, SE_ID INTEGER, SE_CLIENT_ID VARCHAR(250), SE_CONSUMER_NAME VARCHAR(250), SE_SELECTOR VARCHAR(250), PRIMARY KEY (
+SUB, CONTAINER )) Message: Table/View 'ACTIVEMQ_ACKS' already exists in Schema 'APP'. SQLState: X0Y32 Vendor code: 20000
+[SM:INFO] DefaultJDBCAdapter - Could not create JDBC tables; they could already exist. Failure was: ALTER TABLE ACTIVEMQ_MSGS ADD EXPIRATION BIGINT Message: Column
+ 'EXPIRATION' already exists in Table/View 'APP.ACTIVEMQ_MSGS'. SQLState: X0Y32 Vendor code: 20000
+[SM:INFO] DefaultJDBCAdapter - Could not create JDBC tables; they could already exist. Failure was: ALTER TABLE ACTIVEMQ_MSGS ADD SENT_TO_DEADLETTER CHAR(1)
+Message: Column 'SENT_TO_DEADLETTER' already exists in Table/View 'APP.ACTIVEMQ_MSGS'. SQLState: X0Y32 Vendor code: 20000
+[SM:INFO] JournalPersistenceAdapter - Opening journal.
+[SM:INFO] JournalPersistenceAdapter - Opened journal: Active Journal: using 2 x 20.0 Megs at: ..\<SPAN class="code-keyword">var</SPAN>\journal
+[SM:INFO] JournalPersistenceAdapter - Journal Recovery Started.
+[SM:INFO] JournalPersistenceAdapter - Journal Recovered: 0 message(s) in transactions recovered.
+[SM:INFO] TcpTransportServerChannel - Listening <SPAN class="code-keyword">for</SPAN> connections at: tcp:<SPAN class="code-comment">//el2tong:61616
+</SPAN>[SM:INFO] BrokerConnectorImpl - ActiveMQ connector started: TcpTransportServerChannel@tcp:<SPAN class="code-comment">//el2tong:61616
+</SPAN>[SM:INFO] BrokerContainerImpl - ActiveMQ JMS Message Broker (ID:el2tong-1857-1132035585799-1:0) has started
+[SM:INFO] JCAContainer - Jencks JCA Container (http:<SPAN class="code-comment">//jencks.org/) has started running version: 1.1
+</SPAN>[SM:INFO] SpringInitialContextFactory - Loading JNDI context from: class path resource [SM:jndi.xml]
+[SM:INFO] XBeanXmlBeanDefinitionReader - Loading XML bean definitions from class path resource [SM:jndi.xml]
+[SM:INFO] JBIContainer - Activating component <SPAN class="code-keyword">for</SPAN>: [SM:container=defaultJBI,name=#SubscriptionManager#,id=#SubscriptionManager#]
+ with service: <SPAN class="code-keyword">null</SPAN> component: org.servicemix.jbi.nmr.SubscriptionManager@1315415
+[SM:INFO] JBIContainer - ServiceMix JBI Container (http:<SPAN class="code-comment">//servicemix.org/) name: defaultJBI running version: 2.0.1
+</SPAN>[SM:INFO] JBIContainer - Activating component <SPAN class="code-keyword">for</SPAN>: [SM:container=defaultJBI,name=inputReceiver,id=inputReceiver]
+ with service: {http:<SPAN class="code-comment">//servicemix.org/demo/}inputReceiver component: org.servicemix.components.jms.JmsInUsingJCABinding@1786a3c
+</SPAN>[SM:INFO] JCAConnector - Activating endpoint <SPAN class="code-keyword">for</SPAN> activationSpec: ActiveMQActivationSpec{acknowledgeMode='Auto-acknowledge', destinationType='javax.jms.Topic', mess
+ageSelector='<SPAN class="code-keyword">null</SPAN>', destination='demo.org.servicemix.source', clientId='<SPAN class="code-keyword">null</SPAN>', subscriptionName='<SPAN class="code-keyword">null</SPAN>', subscriptionDurability='NonDurable'} using endpointFacto
+ry: org.jencks.SingletonEndpointFactory@d0d12e[SM:transactionManager=org.apache.geronimo.transaction.context.GeronimoTransactionManager@1554233]
+[SM:INFO] ComponentContextImpl - Component: inputReceiver activated endpoint: {http:<SPAN class="code-comment">//servicemix.org/demo/}inputReceiver : inputReceiver
+</SPAN>[SM:INFO] JBIContainer - Activating component <SPAN class="code-keyword">for</SPAN>: [SM:container=defaultJBI,name=outputSender,id=outputSender] with service:
+ {http:<SPAN class="code-comment">//servicemix.org/demo/}outputSender component: org.servicemix.components.jms.JmsSenderComponent@1c6d11a
+</SPAN>[SM:INFO] ComponentContextImpl - Component: outputSender activated endpoint: {http:<SPAN class="code-comment">//servicemix.org/demo/}outputSender : outputSender
+</SPAN>[SM:INFO] ActiveMQConnection - channel status changed: Channel: TcpTransportChannel: Socket[SM:addr=localhost/127.0.0.1,port=61616,localport=1863] has connected
+[SM:INFO] BrokerContainerImpl - Adding <SPAN class="code-keyword">new</SPAN> client: ID:el2tong-1857-1132035585799-11:0 on transport: TcpTransportChannel:
+ Socket[SM:addr=/127.0.0.1,port=1863,localport=61616]</PRE>
+</DIV></DIV>
+
+<H3><A name="jms-binding-Details"></A>Details</H3>
+
+<P>The following table provides more details about the function of each component and bean in the servicemix.xml file.
+<BR clear="all">
+<BR clear="all"></P>
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh">Component or Bean ID</TH>
+<TH class="confluenceTh">Description</TH>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>jbi</EM></TD>
+<TD class="confluenceTd"><EM>jbi</EM> is the "id" of the JBI container and provides the basic infrastructure services for the following components: <EM>inputReceiver</EM> and <EM>outputSender</EM>. During initialization, several singletons are instantiated: <EM>transactionManager</EM>, <EM>broker</EM>, <EM>jencks</EM>, <EM>jmsFactory</EM>, and <EM>jbi</EM>. After initialization, the components in the <EM>jbi</EM> container are activated.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>inputReceiver</EM></TD>
+<TD class="confluenceTd">This component uses <EM>jencks</EM> , the JCA container, to listen on port 61616 for a JMS message on the topic called "demo.org.servicemix.source." <EM>inputReceiver</EM> subscribes to the demo.org.servicemix.source topic. It takes the message, normalizes it, and routes it to <EM>outputSender</EM> via the NMR. This component combined with <EM>outputSender</EM> and supporting beans creates a JMS bridge between two topics.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>outputSender</EM></TD>
+<TD class="confluenceTd">This component receives a normalized message from the NMR, marshals it into a JMS message using <EM>jmsTemplate (1)</EM>, then publishes it on the ActiveMQ (JMS) topic called "demo.org.servicemix.result."</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>jencks</EM></TD>
+<TD class="confluenceTd"> The <EM>jencks</EM> bean defines a JCA container. The JCA container allows you to configure thread pool size, configure a transaction manager, and configure a resource adapter. In this example, the resource adapter is an ActiveMQ adapter, however, any JMS listener could be configured instead. This adapter listens on port 61616 for JMS messages.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>broker</EM></TD>
+<TD class="confluenceTd">The <EM>broker</EM> bean uses the <TT>activemq.xml</TT> file to configure the message broker, which handles the JMS messages for the components that require JMS messaging services.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>transactionManager</EM></TD>
+<TD class="confluenceTd">This bean is configured to be the default transaction manager for the <EM>jbi</EM> container. <EM>jencks</EM> is configured to use the default transaction manager. This transaction manager provides transactional services between the resource adapter (in this case the ActiveMQ resource adapter provided by the <EM>jencks</EM> JCA container) and components the <EM>jbi</EM> container. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>jmsFactory</EM></TD>
+<TD class="confluenceTd">This bean listens on port 61616 and provides a pooled ActiveMQ connection.</TD>
+</TR>
+</TBODY></TABLE>
+
+<P>1. <EM>jmsTemplate:</EM> JmsTemplate is a Spring component which hides the low level details when sending JMS messages. For additional information see: <SPAN class="nobr"><A href="http://docs.codehaus.org/display/ACTIVEMQ/Spring%20Support" title="Visit page outside Confluence" rel="nofollow">JmsTemplate<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>. jmsTemplate is not a component in the <EM>jbi</EM> container. It is used by <EM>inputSender</EM> and <EM>outputSender</EM>.</P>
+
+<H3><A name="jms-binding-RelatedDocumentation"></A>Related Documentation</H3>
+<P>For more information on the following topics please see:</P>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://www.activemq.org/Spring%20Support" title="Visit page outside Confluence" rel="nofollow">ActiveMQ related components, <EM>jmsFactory</EM>, <EM>jmsTemplate</EM>, <EM>broker</EM><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></LI>
+</UL>
+
+
+<UL>
+ <LI><A href="../SM/glossary.html#Glossary-NMR" title="NMR on Glossary">NMR</A></LI>
+</UL>
+
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://jencks.org/" title="Visit page outside Confluence" rel="nofollow">JCA Container, <EM>jencks</EM><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></LI>
+</UL>
+
+
+<P><BR clear="all">
+For a brief explanation of the XML tags in the <TT>servicemi.xml</TT> file, please see:</P>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" title="Visit page outside Confluence" rel="nofollow">XSD<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></LI>
+</UL>
+
+
+
+
+<P>.</P></DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=rajdavies">Rob Davies</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=2073&originalId=14761">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=2073">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/loan-broker-example.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/loan-broker-example.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/loan-broker-example.html (added)
+++ incubator/servicemix/site/sm30ug/loan-broker-example.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,55 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+Loan Broker example
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content">
+<P>This example is based on the great <SPAN class="nobr"><A href="http://www.enterpriseintegrationpatterns.com/ComposedMessagingExample.html" title="Visit page outside Confluence" rel="nofollow">EIP book<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>.</P>
+
+<P>The client and components are built and run from source using Ant, <SPAN class="nobr"><A href="http://ant.apache.org/" title="Visit page outside Confluence" rel="nofollow">http://ant.apache.org<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>.</P>
+
+<P>To start the servicemix server using the sample configuration, you must enter the following commands:</P>
+
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">ant compile
+set CLASSPATH=classes
+../../bin/servicemix servicemix.xml</PRE>
+</DIV></DIV>
+
+<P>This will start the loan broker component.</P>
+
+<P>A simple JMS client based on <SPAN class="nobr"><A href="http://lingo.codehaus.org/" title="Visit page outside Confluence" rel="nofollow">lingo<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> is provided. <BR>
+Just execute 'ant' from the current directory to run the JMS client.</P></DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnt">gnt</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=2043&originalId=14754">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=2043">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg?view=auto&rev=471522
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg.jpeg?view=auto&rev=471522
==============================================================================
Binary file - no diff available.
Propchange: incubator/servicemix/site/sm30ug/quartz-binding.data/quartzflow.jpg.jpeg
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/servicemix/site/sm30ug/quartz-binding.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/quartz-binding.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/quartz-binding.html (added)
+++ incubator/servicemix/site/sm30ug/quartz-binding.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,176 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+quartz-binding
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content">
+<H3><A name="quartz-binding-OverviewoftheServiceMix2.xQuartzExample"></A>Overview of the ServiceMix 2.x <EM>Quartz</EM> Example</H3>
+
+<P>This document describes how to run the <EM>Quartz</EM> example in ServiceMix and provides details about what the Quartz example does. For information on the business use case, please refer to: <SPAN class="nobr"><A href="http://www.servicemix.org/Use%20Cases" title="Visit page outside Confluence" rel="nofollow">Use Case for Quartz<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>.
+<BR clear="all">
+<BR clear="all">
+The Quartz example illustrates the following:</P>
+<UL>
+ <LI>use of declarative programming</LI>
+ <LI>how to use a <SPAN class="nobr"><A href="http://www.servicemix.org/Quartz" title="Visit page outside Confluence" rel="nofollow">Quartz<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> timer</LI>
+ <LI>how to use tracing</LI>
+</UL>
+
+
+<P>The source code for the <EM>Quartz</EM> example is located in the ServiceMix installation directory under the <TT>examples\quartz-binding</TT> directory in the <TT>servicemix.xml</TT> file. It is recommended that you refer to the source code while reading this document.
+<BR clear="all">
+<BR clear="all">
+This example shows how to use a Quartz component to set off a trigger, that sends messages to a trace component. The trace component logs the messages to the console as they arrive
+<BR clear="all">
+<BR clear="all"></P>
+<H3><A name="quartz-binding-RunningtheQuartzExample"></A>Running the <EM>Quartz</EM> Example</H3>
+
+<P>From a command shell, go to the Quartz example directory:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM:servicemix_install_dir]\examples\quartz-binding</PRE>
+</DIV></DIV>
+<P>Then type:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</PRE>
+</DIV></DIV>
+<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed.
+<BR clear="all"></P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>
+<P>Add <EM>$SERVICEMIX_HOME\bin</EM> directory to <EM>$PATH</EM> variable to simplify execution of the example.</P></TD></TR></TABLE>
+
+<H3><A name="quartz-binding-StoppingtheQuartzExample"></A>Stopping the <EM>Quartz</EM> Example</H3>
+<P>To terminate the Quartz example type "CTRL-C" in the command shell, in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.
+<BR clear="all"></P>
+
+<H3><A name="quartz-binding-HowitWorks"></A>How it Works</H3>
+<P>The diagram below illustrates the flow of messages through the <EM>Quartz</EM> components.
+<BR clear="all">
+<BR clear="all"></P>
+
+<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; "><B>Quartz Example Message Flow Diagram</B></DIV><DIV class="panelContent">
+<P><DIV align="center"><IMG src="quartz-binding.data/quartzflow.jpg" border="0"></DIV></P>
+</DIV></DIV>
+
+<P><BR clear="all">
+<BR clear="all"></P>
+
+<P>Messages flow through the components as follows:</P>
+<OL>
+ <LI>Every 5 seconds the <EM>timer</EM> component sends a message to the <EM>trace</EM> component, through the Normalized Message Router (NMR).</LI>
+ <LI>the <EM>trace</EM> component then transforms the normalized message into a string and logs it to the console.
+<BR clear="all">
+<BR clear="all">
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM:INFO] TraceComponent - -Exchange: org.servicemix.jbi.messaging.InOnlyImpl@4fdf11 received IN message:
+org.servicemix.jbi.messaging.NormalizedMessageImpl@1be0369{properties: {org.servicemix.jms.message=ACTIVEMQ_TEXT_MESSAGE:
+id = 0 ActiveMQMessage{ , jmsMessageID = <SPAN class="code-keyword">null</SPAN>, bodyAsBytes = org.activemq.io.util.ByteArray@1d1fc02,
+readOnlyMessage = <SPAN class="code-keyword">true</SPAN>, jmsClientID = 'ID:Lisas-2828-1126207917359-23:0' ,
+ jmsCorrelationID = '<SPAN class="code-keyword">null</SPAN>' , jmsDestination = demo.org.servicemix.result, jmsReplyTo = <SPAN class="code-keyword">null</SPAN>, jmsDeliveryMode = 2,
+ jmsRedelivered = <SPAN class="code-keyword">false</SPAN>, jmsType = '<SPAN class="code-keyword">null</SPAN>' , jmsExpiration = 0, jmsPriority = 4, jmsTime
+stamp = 1126207938593, properties = {}, readOnlyProperties = <SPAN class="code-keyword">true</SPAN>, entryBrokerName = 'ID:Lisas-2828-1126207917359-0:0' ,
+entryClusterName = '<SPAN class="code-keyword">default</SPAN>' , consumerNos = [0], transactionId = '<SPAN class="code-keyword">null</SPAN>' , xaTransacted = <SPAN class="code-keyword">false</SPAN>,
+consumerIdentifer = 'ID:Lisas-2828-1126207917359-14:0' , messageConsumed = <SPAN class="code-keyword">false</SPAN>, transientConsumed = <SPAN class="code-keyword">true</SPAN>,
+sequenceNumber = 7, deliveryCount = 1, dispatchedFromDLQ = <SPAN class="code-keyword">false</SPAN>, messageAcknowledge = org.activemq.ActiveMQSession@1de7497,
+jmsMessageIdentity = <SPAN class="code-keyword">null</SPAN>, producerKey = ID:Lisas-2828-1126207917359-29: }, text = <?xml version=<SPAN class="code-quote">"1.0"</SPAN> encoding=<SPAN class="code-quote">"UTF-8"</SPAN>?>
+<timer><name>My Example Job</name><group>ServiceMix</group><fullname>ServiceMix.My Example Job</fullname><description/><fireTime>
+Thu Sep 08 12:32:18 PDT 2005</fireTime></timer>}}</PRE>
+</DIV></DIV></LI>
+</OL>
+
+
+
+
+<H3><A name="quartz-binding-Details"></A>Details</H3>
+
+<P>The following table provides more details about the function of each component and bean in the servicemix.xml file.
+<BR clear="all">
+<BR clear="all"></P>
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh">Component or Bean ID</TH>
+<TH class="confluenceTh">Description</TH>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>timer</EM></TD>
+<TD class="confluenceTd">The <EM>timer</EM> component shows the use of the QuartzComponent class. Every 5 seconds, until the program is terminated, the timer component kicks off an instance of a SimpleTrigger, which is associated with an instance of JobDetail. The job has a property called "name", with a value of "My Example Job" and another property called "group", with a value of "ServiceMix." The resulting message is converted to a normalized message and then routed through the NMR. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"><EM>trace</EM></TD>
+<TD class="confluenceTd">Receives normalized messages via the NMR. It transforms the normalized message into a string and logs it to the console.</TD>
+</TR>
+</TBODY></TABLE>
+
+<H3><A name="quartz-binding-Issues"></A>Issues</H3>
+<P>The ServiceMix 2.0.2 distribution has a known logging bug, so output is not logged to the console, currently. There are two ways to fix this problem. The first solution is to upgrade to 2.0.3 or greater. Please see <A href="../SM/download.html" title="Download">SM:Download</A> for the latest releases. If 2.0.2 is still the latest/current release, then download a developer's release of 2.0.3.</P>
+
+<P>The other solution is to replace the jencks-all-1.1.1.jar with the jencks-all-1.1.2.jar file. Note: This can only be done for the <B>source</B> version of ServiceMix 2.0.2. To apply the fix, perform the following steps:</P>
+<OL>
+ <LI>Download the jencks-all-1.2.jar <SPAN class="nobr"><A href="http://dist.codehaus.org/jencks/jars/jencks-all-1.1.2.jar" title="Visit page outside Confluence" rel="nofollow">here<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>.</LI>
+ <LI>Copy the jar file to [SM:servicemix_src_install_dir]\assembly\target\servicemix-2.0.2\bin\servicemix-2.0.2\lib, where [SM:servicemix_src_install_dir] is the directory in which the ServiceMix distribution is located.</LI>
+ <LI>Delete jencks-all-1.1.1.jar from that directory.</LI>
+ <LI>Place a copy of the jar file in the ServiceMix web directory at [SM:servicemix_src_install_dir]\servicemix-2.0.2\tooling\servicemix-web\target\servicemix-web\WEB-INF as well.</LI>
+ <LI>To run the example in the source distribution:</LI>
+</OL>
+
+
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">cd [SM:servicemix_src_install_dir]\assembly\target\servicemix-2.0.2\bin\servicemix-2.0.2\bin
+
+..\..\bin\servicemix servicemix.xml</PRE>
+</DIV></DIV>
+
+<P><B>NOTE:</B> It is not necessary to build the source distribution if you have done so previously. If ServiceMix has not been built, execute the steps above, before building. The procedure on how to build the source distribution can be found <SPAN class="nobr"><A href="http://www.servicemix.org/Getting%20Started#GettingStarted-WindowsSourceInstallation" title="Visit page outside Confluence" rel="nofollow">here<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>.</P>
+
+<H3><A name="quartz-binding-RelatedDocumentation"></A>Related Documentation</H3>
+<P>For more information on the following topics please see:</P>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://www.servicemix.org/Quartz" title="Visit page outside Confluence" rel="nofollow">Quartz timer<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></LI>
+</UL>
+
+
+<P>For a brief explanation of the XML tags in the <TT>servicemix.xml</TT> file, please see:</P>
+
+<UL>
+ <LI><SPAN class="nobr"><A href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" title="Visit page outside Confluence" rel="nofollow">XSD<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>
+<BR clear="all">
+<BR clear="all"></LI>
+</UL>
+
+
+
+
+</DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=rajdavies">Rob Davies</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=2114&originalId=14748">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=2114">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Modified: incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg?view=diff&rev=471522&r1=471521&r2=471522
==============================================================================
Binary files - no diff available.
Modified: incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg.jpeg
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/rss-binding.data/rssflow.jpg.jpeg?view=diff&rev=471522&r1=471521&r2=471522
==============================================================================
Binary files - no diff available.
Modified: incubator/servicemix/site/sm30ug/rss-binding.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/rss-binding.html?view=diff&rev=471522&r1=471521&r2=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/rss-binding.html (original)
+++ incubator/servicemix/site/sm30ug/rss-binding.html Sun Nov 5 12:24:38 2006
@@ -5,7 +5,7 @@
<LINK type="text/css" rel="stylesheet" href="resources/site.css">
<SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
<TITLE>
-RSS Binding
+RSS-binding
</TITLE>
<META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
<BODY onload="init()">
@@ -19,23 +19,10 @@
<TR>
<TD valign="top">
<DIV id="site-page">
- <DIV class="wiki-content"><STYLE type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
+ <DIV class="wiki-content">
+<H3><A name="RSS-binding-OverviewoftheServiceMix2.xRSSBindingExample"></A>Overview of the ServiceMix 2.x <EM>RSS Binding</EM> Example</H3>
-/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM/loan-broker-bpel.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM/loan-broker-bpel.html">Loan Broker BPEL</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="../SM/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="../SM/4-examples.html">4. Examples</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="vfs-binding.html">VFS Binding</A></TD><TD class="ScrollbarNextIcon"><A href="vfs-binding.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV>
-<P><A name="RSSBinding-top"></A></P>
-
-<H1><A name="RSSBinding-RSSBindingexample"></A>RSS Binding example</H1>
-
-
-<H2><A name="RSSBinding-Overview"></A>Overview</H2>
-
-<P>The following procedure describes how to run the <EM>RSS Binding</EM> example in ServiceMix and provides details regarding what the RSS Binding does. For information on the business use case, please refer to the <A href="/confluence/display/SM30UG" title="View ServiceMix 3.0 User Guide space">use case</A> section.
+<P>The following procedure describes how to run the <EM>RSS Binding</EM> example in ServiceMix and provides details regarding what the RSS Binding does. For information on the business use case, please refer to: <SPAN class="nobr"><A href="http://www.servicemix.org/Use%20Cases" title="Visit page outside Confluence" rel="nofollow">Use Case for RSS Binding<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>.
<BR clear="all">
<BR clear="all">
The RSS Binding example illustrates:</P>
@@ -50,42 +37,44 @@
<BR clear="all">
This example shows how to monitor RSS feeds for changes. The main component of this example periodically polls a list of RSS news feeds and when an update is found the new RSS items are displayed on the console.</P>
-<H2><A name="RSSBinding-RunningtheRSSBindingExample"></A>Running the <EM>RSS Binding</EM> Example</H2>
-
+<H3><A name="RSS-binding-RunningtheRSSBindingExample"></A>Running the <EM>RSS Binding</EM> Example</H3>
<P><BR clear="all"></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>
-<P>On a slow news day, you may have wait a while to see any output! <IMG class="emoticon" src="http://goopen.org/confluence/images/icons/emoticons/smile.gif" height="20" width="20" align="absmiddle" alt="" border="0"></P></TD></TR></TABLE>
+<P>On a slow news day, you may have wait a while to see any output! <IMG class="emoticon" src="http://goopen.org/confluence/images/icons/emoticons/smile.gif" height="20" width="20" align="absmiddle" alt="" border="0"></P></TD></TR></TABLE>
<P><BR clear="all"></P>
<OL>
<LI>From a command shell, go to the RSS Binding example directory:
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">cd [SM30UG:servicemix_install_dir]\examples\rss-binding</PRE>
+<PRE class="code-java">cd [SM:servicemix_install_dir]\examples\rss-binding</PRE>
</DIV></DIV>
<P>where <TT>servicemix_install_dir</TT> is the directory in which ServiceMix was installed originally.</P></LI>
<LI>Then type:
<DIV class="code"><DIV class="codeContent">
-<PRE class="code-java">[SM30UG:servicemix_install_dir]\bin\servicemix servicemix.xml</PRE>
+<PRE class="code-java">[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</PRE>
</DIV></DIV>
-<P><BR clear="all">
-<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>Add <EM>$SERVICEMIX_HOME/bin</EM> directory to <EM>$PATH</EM> variable to simplify execution of the examples.</TD></TR></TABLE><BR clear="all"></P></LI>
+<P><BR clear="all"></P>
+<TABLE cellpadding="5" width="85%" cellspacing="8px" class="tipMacro" border="0" align="center"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="http://goopen.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B class="strong">Handy Hint</B><BR>
+<P>Add <EM>$SERVICEMIX_HOME/bin</EM> directory to <EM>$PATH</EM> variable to simplify execution of the examples.</P></TD></TR></TABLE>
+<P><BR clear="all"></P></LI>
</OL>
-<H2><A name="RSSBinding-StoppingtheRSSBindingExample"></A>Stopping the <EM>RSS Binding</EM> Example</H2>
-
+<H3><A name="RSS-binding-StoppingtheRSSBindingExample"></A>Stopping the <EM>RSS Binding</EM> Example</H3>
<P>To terminate the <EM>RSS Binding</EM> example, type "CTRL-C" in the command shell in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.
<BR clear="all"></P>
-<H2><A name="RSSBinding-HowitWorks"></A>How it Works</H2>
-
+<H3><A name="RSS-binding-HowitWorks"></A>How it Works</H3>
<P>The diagram below illustrates the flow of messages through the <EM>RSS Binding</EM> components:
<BR clear="all">
<BR clear="all"></P>
+
<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; "><B>RSS Binding Example Message Flow Diagram</B></DIV><DIV class="panelContent">
-<P><DIV align="center"><IMG src="rss-binding.data/rssflow.jpg" border="0"></DIV></P>
+<P><IMG src="rss-binding.data/rssflow.jpg" align="absmiddle" border="0"></P>
</DIV></DIV>
+
<P><BR clear="all">
Messages flow through the components as follows:</P>
+
<OL>
<LI>The <EM>rss</EM> component, which is implemented by RssPollingComponent class, uses customEditorConfigurer bean to parse the Date variable lastPolledDate into the specified format (yyyy/MMM/dd). lastPolledDate will be used to determine the new items added on the RSS feed.</LI>
<LI>The <EM>rss</EM> component periodically polls RSS feeds defined on its <TT>urlStrings</TT> property for changes. In this case <EM>rss</EM> component monitors the following RSS feeds: <SPAN class="nobr"><A href="http://rss.cnn.com/rss/cnn_topstories.rss" title="Visit page outside Confluence" rel="nofollow">http://rss.cnn.com/rss/cnn_topstories.rss<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> and <SPAN class="nobr"><A href="http://newsrss.bbc.co.uk/rss/newsonline_uk_edition/front_page/rss.xml" title="Visit page outside Confluence" rel="nofollow">http://newsrss.bbc.co.uk/rss/newsonline_uk_edition/front_page/rss.xml<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>.</LI>
@@ -94,7 +83,9 @@
</OL>
-<P>Output from running <TT>[SM30UG:servicemix_install_dir]\bin\servicemix servicemix.xml</TT> looks like the following:</P>
+
+<P>Output from running <TT>[SM:servicemix_install_dir]\bin\servicemix servicemix.xml</TT> looks like the following: </P>
+
<DIV class="code"><DIV class="codeContent">
<PRE class="code-java"><item>
<title>Bush supporters' cars allegedly defaced by war veteran</title>
@@ -116,46 +107,35 @@
</item></PRE>
</DIV></DIV>
-<H2><A name="RSSBinding-Details"></A>Details</H2>
+<H3><A name="RSS-binding-Details"></A>Details</H3>
<P>The following table provides more details about the function of each component and bean in the servicemix.xml file:
<BR clear="all">
<BR clear="all"></P>
<TABLE class="confluenceTable"><TBODY>
<TR>
-<TH class="confluenceTh"> Component or Bean ID </TH>
-<TH class="confluenceTh"> Description </TH>
+<TH class="confluenceTh">Component or Bean ID</TH>
+<TH class="confluenceTh">Description</TH>
</TR>
<TR>
-<TD class="confluenceTd"> <EM>rss</EM> </TD>
-<TD class="confluenceTd"> This component polls RSS feeds for changes and is implemented by RssPollingComponent class. The property urlStrings defines the RSS feeds to be monitored. When one of the RSS feeds being monitored is updated, this component will convert the content of the RSS feed into a normalized message and send it to a trace component via Normalized Message Router (NMR). </TD>
+<TD class="confluenceTd"><EM>rss</EM></TD>
+<TD class="confluenceTd">This component polls RSS feeds for changes and is implemented by RssPollingComponent class. The property urlStrings defines the RSS feeds to be monitored. When one of the RSS feeds being monitored is updated, this component will convert the content of the RSS feed into a normalized message and send it to a trace component via Normalized Message Router (NMR).</TD>
</TR>
<TR>
-<TD class="confluenceTd"> <EM>trace</EM> </TD>
-<TD class="confluenceTd"> This component accepts a normalized message and display its content to the console. </TD>
+<TD class="confluenceTd"><EM>trace</EM></TD>
+<TD class="confluenceTd">This component accepts a normalized message and display its content to the console.</TD>
</TR>
<TR>
-<TD class="confluenceTd"> <EM>customEditorConfigurer</EM> </TD>
-<TD class="confluenceTd"> This bean allows convenient registration of custom property editors that can modify application context's bean definitions. It uses CustomDateEditor, a propertyEditor for java.util.Date to reformat date variable lastPolledDate. </TD>
+<TD class="confluenceTd"><EM>customEditorConfigurer</EM></TD>
+<TD class="confluenceTd"> This bean allows convenient registration of custom property editors that can modify application context's bean definitions. It uses CustomDateEditor, a propertyEditor for java.util.Date to reformat date variable lastPolledDate.</TD>
</TR>
</TBODY></TABLE>
-<H2><A name="RSSBinding-Usecase"></A>Use case</H2>
-
-<P>The <EM>RSS binding</EM> example shows how to use the RSS bindings to poll RSS feeds for updates. RSS is an XML format designed for sharing web content between sites.</P>
-
-<P>A hypothetical business scenario, which uses RSS, is a web site constantly polling RSS feeds for its "What's New" section. Whenever <EM>rssPoller</EM> detects a change in one of the RSS feeds, <EM>rssPoller</EM> will send an updated list of URLs to <EM>displayNewSites</EM>. The <EM>displayNewSites</EM> component will then auomatically update the web site's "What's New" section accordingly.</P>
-
-<P>The following diagram illustrates this:</P>
-<DIV class="panel" style="border-style: solid; border-color: #ccc; "><DIV class="panelHeader" style="border-bottom-style: solid; border-bottom-color: #ccc; "><B>News Feed Monitoring System</B></DIV><DIV class="panelContent">
-<P><DIV align="center"><IMG src="rss-binding.data/usecase_for_rss.jpg" border="0"></DIV></P>
-</DIV></DIV>
-
-<H2><A name="RSSBinding-RelatedDocumentation"></A>Related Documentation</H2>
-
+<H3><A name="RSS-binding-RelatedDocumentation"></A>Related Documentation</H3>
<P>For more information on the following topics please see:</P>
+
<UL>
- <LI><SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=Glossary&linkCreation=true&fromPageId=13497" title="Create Page: Glossary" class="createlink">NMR<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+ <LI><A href="../SM/glossary.html#Glossary-NMR" title="NMR on Glossary">NMR</A></LI>
</UL>
@@ -166,22 +146,16 @@
<P>We support working with RSS and Atom via the <SPAN class="nobr"><A href="http://wiki.java.net/bin/view/Javawsxml/Rome" title="Visit page outside Confluence" rel="nofollow">Rome<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> library. We support both the polling of existing RSS feeds to generate JBI messages (the example documented above) and the generation of RSS feeds from JBI messages. To see an example of how to generate RSS feeds from JBI messages go <SPAN class="nobr"><A href="http://docs.codehaus.org/x/3XM" title="Visit page outside Confluence" rel="nofollow">here<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>.</P>
-<P>For a brief explanation of the XML tags in the <TT>servicemi.xml</TT> file, please see:</P>
+<P>For a brief explanation of the XML tags in the <TT>servicemi.xml</TT> file, please see:</P>
+
<UL>
<LI><SPAN class="nobr"><A href="http://servicemix.codehaus.org/maven/servicemix.xsd.html" title="Visit page outside Confluence" rel="nofollow">XSD<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></LI>
</UL>
<P><BR clear="all"></P>
-<STYLE type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
-/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM/loan-broker-bpel.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM/loan-broker-bpel.html">Loan Broker BPEL</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="../SM/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="../SM/4-examples.html">4. Examples</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="vfs-binding.html">VFS Binding</A></TD><TD class="ScrollbarNextIcon"><A href="vfs-binding.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV></DIV>
+</DIV>
</DIV>
</TD>
</TR>
@@ -189,11 +163,11 @@
</DIV>
</DIV>
<DIV id="site-footer">
- Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A>,
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=rajdavies">Rob Davies</A>,
last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
- (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13497&originalId=14654">view change</A>)
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=1968&originalId=14752">view change</A>)
- (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13497">edit page</A>)
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=1968">edit page</A>)
</DIV>
</BODY>
Added: incubator/servicemix/site/sm30ug/soap-binding-example.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/soap-binding-example.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/soap-binding-example.html (added)
+++ incubator/servicemix/site/sm30ug/soap-binding-example.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,66 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+soap binding example
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content">
+<P>The SOAP Binding example can be found in ServiceMix distribution under</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">[SM:root]\examples\soap-binding</PRE>
+</DIV></DIV>
+<P>This example shows how to expose a simple web service with ServiceMix.<BR>
+The components are built and run from source using Ant, <SPAN class="nobr"><A href="http://ant.apache.org/" title="Visit page outside Confluence" rel="nofollow">http://ant.apache.org<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>.</P>
+
+<P>To start the servicemix server using the sample configuration, you must enter the following commands:</P>
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-java">ant setup
+../../bin/servicemix servicemix.xml</PRE>
+</DIV></DIV>
+<P>This will start the soap-binding demo.</P>
+
+<P>A simple client is available with the client.html web page.<BR>
+Just launched it in your favorite web browser and modify the content of the left pane.<BR>
+You should see the response on the right pane.</P>
+
+<P>NOTES:</P>
+<UL>
+ <LI>currently, the demo does not work with FireFox</LI>
+ <LI>if you experience problems, try rebuilding the demo:<BR>
+ remove all the directories but the src one,<BR>
+ type 'ant setup'<BR>
+ run '../../bin/servicemix servicemix.xml'</LI>
+</UL>
+</DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnt">gnt</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=2099&originalId=14749">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=2099">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Added: incubator/servicemix/site/sm30ug/understanding-the-soap-binding-example.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/understanding-the-soap-binding-example.html?view=auto&rev=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/understanding-the-soap-binding-example.html (added)
+++ incubator/servicemix/site/sm30ug/understanding-the-soap-binding-example.html Sun Nov 5 12:24:38 2006
@@ -0,0 +1,77 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<HTML>
+ <HEAD>
+ <LINK type="text/css" rel="stylesheet" href="resources/site.css">
+ <SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
+ <TITLE>
+Understanding the 'soap-binding' example
+ </TITLE>
+ <META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
+ <BODY onload="init()">
+
+ <!-- Banner -->
+ <DIV id="site-banner">
+ </DIV>
+
+ <DIV id="site-content">
+ <TABLE>
+ <TR>
+ <TD valign="top">
+ <DIV id="site-page">
+ <DIV class="wiki-content"><P>The soap-binding example aims to demonstrate how one can use the Servicemix-http and servicemix-jsr181 components to invoke a pojo object as a web service over HTTP.</P>
+
+<P>Here is a breakdown of what happens when you hit the 'send' button on the client.html page.</P>
+
+
+<OL>
+ <LI>When send button is clicked, a javascript function(send()) is invoked.</LI>
+ <LI>The javascript function submits an Ajax request to the http endpoint deployed using the serviceunit(binding-su.zip) on the Servicemix-http component.The soap request present in the textfield on the left hand side(see circled content in the above image) is sent a parameter to Ajax request.</LI>
+ <LI>The Httpendpoint receives the http+soap request and sends the request to the 'proxied' pojo endpoint(proxied endpoint reference configuration is shown in the xbean.xml excerpt below) deployed using engine-su.zip over the NMR.<BR>
+Here is the excerpt from the xbean.xml file under<BR>
+[SM:Serivemix installation directory]\servicemix-3.0-M1\examples\soap-binding\src\components\soap
+<DIV class="code"><DIV class="codeContent">
+<PRE class="code-xml"><http:endpoint service=<SPAN class="code-quote">"demo:simple-service"</SPAN>
+ endpoint=<SPAN class="code-quote">"simple-service"</SPAN>
+ role=<SPAN class="code-quote">"consumer"</SPAN>
+ locationURI=<SPAN class="code-quote">"http://localhost:8192/Service/"</SPAN>
+ defaultMep=<SPAN class="code-quote">"http://www.w3.org/2004/08/wsdl/in-out"</SPAN>
+ soap=<SPAN class="code-quote">"true"</SPAN> /></PRE>
+</DIV></DIV></LI>
+ <LI>The servicemix-jsr181 receives the request from the NMR and invokes the 'SimpleService' pojo' 'ping' method.</LI>
+ <LI>The 'SimpleService' returns the response to the 'ping' method and servicemix-jsr181 sends to response back the Httpendpoint over the NMR.<BR>
+Here is the excerpt of the implemenation for the ping method
+<DIV class="code" style="border-style: solid; "><DIV class="codeHeader" style="border-bottom-style: solid; "><B>SimpleService.java</B></DIV><DIV class="codeContent">
+<PRE class="code-java"><SPAN class="code-keyword">public</SPAN> PingResponse ping(PingRequest request)
+{ PingResponse response = <SPAN class="code-keyword">new</SPAN> PingResponse(); response.setMessage(<SPAN class="code-quote">"Ping: "</SPAN> + request.getMessage()); <SPAN class="code-keyword">return</SPAN> response; }</PRE>
+</DIV></DIV>
+<P>This method prefixes a "Ping:" to request recieved and sends it back as the response</P></LI>
+ <LI>The Servicemix-http sends the response back the browser instance from which the ajax request was sent.</LI>
+ <LI>The browser invokes java script function that sets the response field value to the response received.<BR>
+<IMG src="http://photos1.blogger.com/blogger/6580/2940/1600/Soap-client-response.1.jpg" align="absmiddle" border="0"></LI>
+</OL>
+
+
+<P>There are some subtle points to note here</P>
+<OL>
+ <LI>The proxied endpoint is configured using the service="demo:simple-service" and endpoint="simple-service" attributes in the http:endpoint configuration in the binding-su's xbeans.xml file. The values demo:simple-service and simple-service point to service name and endpoint name of the pojo endpoint configuration( service="demo:simple-service" endpoint="simple-service" attributes of jsr181:endpoint configuration) in engine-su's xbean.xml file.</LI>
+ <LI>The Servicemix-http and servicemix-jsr181 components are installed at runtime and not using the servicemix.xml file under [SM:servicemix-home]\examples\soap-binding folder.</LI>
+</OL>
+</DIV>
+ </DIV>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+ </DIV>
+ <DIV id="site-footer">
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=vamsi">Mohan Vamsi</A>,
+ last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=9006&originalId=14750">view change</A>)
+
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=9006">edit page</A>)
+ </DIV>
+
+ </BODY>
+
+</HTML>
\ No newline at end of file
Modified: incubator/servicemix/site/sm30ug/vfs-binding.html
URL: http://svn.apache.org/viewvc/incubator/servicemix/site/sm30ug/vfs-binding.html?view=diff&rev=471522&r1=471521&r2=471522
==============================================================================
--- incubator/servicemix/site/sm30ug/vfs-binding.html (original)
+++ incubator/servicemix/site/sm30ug/vfs-binding.html Sun Nov 5 12:24:38 2006
@@ -5,7 +5,7 @@
<LINK type="text/css" rel="stylesheet" href="resources/site.css">
<SCRIPT src="resources/space.js" type="text/javascript"></SCRIPT>
<TITLE>
-VFS Binding
+vfs-binding
</TITLE>
<META http-equiv="Content-Type" content="text/html;charset=UTF-8"></HEAD>
<BODY onload="init()">
@@ -19,36 +19,22 @@
<TR>
<TD valign="top">
<DIV id="site-page">
- <DIV class="wiki-content"><STYLE type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
-
-/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM/rss-binding.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM/rss-binding.html">RSS Binding</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="../SM/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="../SM/4-examples.html">4. Examples</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="ws-notification-clustered.html">WS-Notification Clustered</A></TD><TD class="ScrollbarNextIcon"><A href="ws-notification-clustered.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV>
-<P>This example to show how to use the <SPAN class="nobr"><A href="http://goopen.org/confluence/pages/createpage.action?spaceKey=SM30UG&title=VFS&linkCreation=true&fromPageId=13498" title="Create Page: VFS" class="createlink">VFS binding<SUP><IMG class="rendericon" src="http://goopen.org/confluence/images/icons/plus.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN> to do a simple file transfer<BR>
-<B>To start the the</B> <B><EM>vfs binding</EM></B> <B>example:</B></P>
+ <DIV class="wiki-content">
+<P>This example to show how to use the <A href="../SM/vfs.html" title="VFS">VFS binding</A> to do a simple file transfer<BR>
+<B>To start the the <EM>vfs binding</EM> example:</B></P>
+
<DIV class="code"><DIV class="codeContent">
<PRE class="code-java">cd example/vfs-binding
../../bin/servicemix servicemix.xml</PRE>
</DIV></DIV>
-<P>This will start a component which waits for files to arrive in the /tmp/servicemix-inbox directory.<BR>
-It then does a file transfer to the /tmp/servicemix-outbox directory.</P>
-<P>Just copy the test-file.xml file into the /tmp/servicemix-inbox<BR>
-directory and you should see it apear in the outbox directory in a<BR>
-few seconds.</P>
-<STYLE type="text/css">/*<![CDATA[*/
-table.ScrollbarTable {border: none;padding: 3px;width: 100%;padding: 3px;margin: 0px;background-color: #f0f0f0}
-table.ScrollbarTable td.ScrollbarPrevIcon {text-align: center;width: 16px;border: none;}
-table.ScrollbarTable td.ScrollbarPrevName {text-align: left;border: none;}
-table.ScrollbarTable td.ScrollbarParent {text-align: center;border: none;}
-table.ScrollbarTable td.ScrollbarNextName {text-align: right;border: none;}
-table.ScrollbarTable td.ScrollbarNextIcon {text-align: center;width: 16px;border: none;}
-/*]]>*/</STYLE><DIV class="Scrollbar"><TABLE class="ScrollbarTable"><TR><TD class="ScrollbarPrevIcon"><A href="../SM/rss-binding.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/back_16.gif" width="16" height="16"></A></TD><TD width="33%" class="ScrollbarPrevName"><A href="../SM/rss-binding.html">RSS Binding</A> </TD><TD width="33%" class="ScrollbarParent"><SUP><A href="../SM/4-examples.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/up_16.gif" width="8" height="8"></A></SUP><A href="../SM/4-examples.html">4. Examples</A></TD><TD width="33%" class="ScrollbarNextName"> <A href="ws-notification-clustered.html">WS-Notification Clustered</A></TD><TD class="ScrollbarNextIcon"><A href="ws-notification-clustered.html"><IMG border="0" align="middle" src="http://goopen.org/confluence/images/icons/forwd_16.gif" width="16" height="16"></A></TD></TR></TABLE></DIV></DIV>
+<P>This will start a component which waits for files to arrive in the /tmp/servicemix-inbox directory. <BR>
+It then does a file transfer to the /tmp/servicemix-outbox directory.</P>
+
+<P>Just copy the test-file.xml file into the /tmp/servicemix-inbox <BR>
+directory and you should see it apear in the outbox directory in a <BR>
+few seconds.</P></DIV>
</DIV>
</TD>
</TR>
@@ -56,11 +42,11 @@
</DIV>
</DIV>
<DIV id="site-footer">
- Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A>,
+ Added by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=rajdavies">Rob Davies</A>,
last edited by <A href="http://goopen.org/confluence/users/viewuserprofile.action?username=gnodet">Guillaume Nodet</A> on Nov 08, 2006
- (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=13498&originalId=14657">view change</A>)
+ (<A href="http://goopen.org/confluence/pages/diffpages.action?pageId=1984&originalId=14751">view change</A>)
- (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=13498">edit page</A>)
+ (<A href="http://goopen.org/confluence/pages/editpage.action?pageId=1984">edit page</A>)
</DIV>
</BODY>