Overview:
=========
  The purpose of the streaming_aggregator quickstart sample is to demonstrate
  the functionality of the StreamingAggregator.     

  The streaming_aggregator quickstart ant "runtest" target creates a file
  with a number of lines in it (100 lines, you can configure it differently in
  the build.xml.    This file is picked up by the file gateway, and a custom 
  composer (IncomingComposer) splits each line in the file into its own Message.

  The Messages are then aggregated.    The IncomingComposer adds aggregation
  details into the message telling the StreamingAggregator the unique ID
  of the aggregated message group and the message order within that group.
 
  The benefit of org.jboss.soa.esb.actions.aggregator.StreamingAggregator
  over the standard JBoss ESB aggregator (org.jboss.soa.esb.actions.Aggregator)
  is that the standard aggregator requires you to know how many items you
  will be aggregating at the moment at which you send the first item.    If
  you are reading in a very large file to split, you would need to read in the
  whole file before starting to split, or you would have to run through the
  file preemptively to count the number of items you would be splitting.
 
  The StreamingAggregator on the other hand allows you to start sending
  immediately.    Once you are finished splitting, you can then send a message
  that will inform aggregator what the final count was so that it can check
  whether it has received all of the split messages. 

Running this quickstart:
========================
  Please refer to 'ant help-quickstarts' for prerequisites about the quickstarts
  and a more detailed descripton of the different ways to run the quickstarts.

To Run:
===========================
  1. In a command terminal window in this folder ("Window1"), type 'ant deploy'.
  2. Open another command terminal window in this folder ("Window2"), type
     'ant runtest'.
  3. Switch back to Application Server console to see the output from the ESB
  4. In this folder ("Window1"), type 'ant undeploy'.
