svn commit: r1439048 - /camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml

[da...@apache.org]

Author: davsclaus
Date: Sun Jan 27 11:11:27 2013
New Revision: 1439048

URL: http://svn.apache.org/viewvc?rev=1439048&view=rev
Log:
Added comments for tutorial

Modified:
    camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml

Modified: camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml
URL: http://svn.apache.org/viewvc/camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml?rev=1439048&r1=1439047&r2=1439048&view=diff
==============================================================================
--- camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml (original)
+++ camel/trunk/examples/camel-example-reportincident/src/main/resources/META-INF/spring/camel-context.xml Sun Jan 27 11:11:27 2013
@@ -15,7 +15,9 @@
     See the License for the specific language governing permissions and
     limitations under the License.
 -->
+<!--START SNIPPET: e1 -->
 
+<!-- here we have Spring XML file with all the namespaces here in the top of the XML file -->
 <beans xmlns="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:camel="http://camel.apache.org/schema/spring"
@@ -28,13 +30,17 @@
   <!-- this is Spring XML example of the Camel route in the ReportIncidentRoutes class -->
   <!-- this is for demonstration purpose, to show how you can use Camel with XML DSL -->
 
+   <!-- here we define the CXF endpoint, where {{port}} refers to a placeholder so we can define the port number
+           in an external .properties file -->
   <cxf:cxfEndpoint id="reportIncident"
                    address="http://localhost:{{port}}/camel-example-reportincident/webservices/incident"
                    wsdlURL="etc/report_incident.wsdl"
                    serviceClass="org.apache.camel.example.reportincident.ReportIncidentEndpoint"/>
 
-  <bean id="myBean" class="org.apache.camel.example.reportincident.MyBean"/>
+   <!-- We use a bean to make the response bean that CXF expects -->
+  <bean id="responseBean" class="org.apache.camel.example.reportincident.MyBean"/>
 
+   <!-- this is the bean we use to generate the dynamic file name -->
   <bean id="filenameGenerator" class="org.apache.camel.example.reportincident.FilenameGenerator"/>
 
   <!-- this CamelContext contains the equivalent route from the Java DSL, but in XML
@@ -42,8 +48,10 @@
   <camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
 
     <!-- property which contains port number -->
+    <!-- we have file:target/custom.properties which can be optional and override existing values, we use this for testing purpose -->
     <camel:propertyPlaceholder id="properties" location="classpath:incident.properties,file:target/custom.properties"/>
 
+    <!-- this is the first route that uses CXF as web service -->
     <route>
       <from uri="cxf:bean:reportIncident"/>
       <convertBodyTo type="org.apache.camel.example.reportincident.InputReportIncident"/>
@@ -53,10 +61,11 @@
       <to uri="velocity:etc/MailBody.vm"/>
       <to uri="file://target/subfolder"/>
       <transform>
-        <method bean="myBean" method="getOK"/>
+        <method bean="responseBean" method="getOK"/>
       </transform>
     </route>
 
+    <!-- this is the 2nd route that pickup files and send them as emails -->
     <route>
       <from uri="file://target/subfolder"/>
       <setHeader headerName="subject">
@@ -68,3 +77,4 @@
   </camelContext>
 
 </beans>
+<!--END SNIPPET: e1 -->