Quote Xquery Sample
===================

 This sample covers the most important integration scenarios for the xquery
 implementation type and its corresponding saxon data bindings.
 
If you just want to run it to see what happens open two command prompts (one for the server
and the other for the client), navigate to this sample directory and do:

Command Prompt 1:
---------------------------------------

ant run-server

OR if you don't have ant, on Windows do

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-quote-xquery.jar xquery.quote.XQueryQuoteServer

and on Linux do

java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-quote-xquery.jar xquery.quote.XQueryQuoteServer


Output
------
Buildfile: build.xml

run-server:
     [java] Nov 1, 2007 11:29:31 PM org.apache.tuscany.sca.http.jetty.JettyServer addServletMapping
     [java] INFO: Added Servlet mapping: http://localhost:8085/QuoteJoinService
     [java] Nov 1, 2007 11:29:31 PM org.apache.tuscany.sca.http.jetty.JettyServer addServletMapping
     [java] INFO: Added Servlet mapping: http://localhost:8085/AvailQuoteProviderService
     [java] XQuery Quote server is started (press enter to shutdown).


Leave the server running and open another command prompt and navigate into this sample directory




Command Prompt 2:
----------------------------------------

ant run

OR if you don't have ant, on Windows do

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-quote-xquery.jar xquery.quote.XQueryQuoteClient

and on Linux do 

java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-quote-xquery.jar xquery.quote.XQueryQuoteClient


Output
----------
Buildfile: build.xml

run:
     [java] Input quote for the price list:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <priceQuote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:pri="http://www.example.org/price" xsi:type="pri:PriceQuote">
     [java]   <customerName>Acme Inc</customerName>
     [java]   <shipAddress street="12 Springs Rd" city="Morris Plains" state="nj" zip="07960"/>
     [java]   <priceRequests>
     [java]     <priceRequest>
     [java]       <widgetId>12</widgetId>
     [java]       <price>1.0</price>
     [java]     </priceRequest>
     [java]     <priceRequest>
     [java]       <widgetId>134</widgetId>
     [java]       <price>34.1</price>
     [java]     </priceRequest>
     [java]     <priceRequest>
     [java]       <widgetId>211</widgetId>
     [java]       <price>10.0</price>
     [java]     </priceRequest>
     [java]   </priceRequests>
     [java] </priceQuote>
     [java] 
     [java] Input quote for the availability:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <availQuote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ava="http://www.example.org/avail" xsi:type="ava:AvailQuote">
     [java]   <availRequest>
     [java]     <widgetId>12</widgetId>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <quantityAvail>true</quantityAvail>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]   </availRequest>
     [java]   <availRequest>
     [java]     <widgetId>134</widgetId>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <quantityAvail>false</quantityAvail>
     [java]     <shipDate>BackOrder</shipDate>
     [java]   </availRequest>
     [java]   <availRequest>
     [java]     <widgetId>211</widgetId>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <quantityAvail>true</quantityAvail>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]   </availRequest>
     [java] </availQuote>
     [java] 
     [java] 
     [java] Output quote from local join:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <quote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:quo="http://www.example.org/quote" xsi:type="quo:Quote">
     [java]   <name>Acme Inc</name>
     [java]   <address>12 Springs Rd,Morris Plains,NJ,07960</address>
     [java]   <quoteResponse>
     [java]     <widgetId>12</widgetId>
     [java]     <unitPrice>1.0</unitPrice>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>11.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>134</widgetId>
     [java]     <unitPrice>34.1</unitPrice>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <fillOrder>false</fillOrder>
     [java]     <shipDate>BackOrder</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>0.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>211</widgetId>
     [java]     <unitPrice>10.0</unitPrice>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>1100.0</totalCost>
     [java]   </quoteResponse>
     [java] </quote>
     [java] 
     [java] 
     [java] Output quote from local join (second invokation):
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <quote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:quo="http://www.example.org/quote" xsi:type="quo:Quote">
     [java]   <name>Acme Inc</name>
     [java]   <address>12 Springs Rd,Morris Plains,NJ,07960</address>
     [java]   <quoteResponse>
     [java]     <widgetId>12</widgetId>
     [java]     <unitPrice>1.0</unitPrice>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]     <taxRate>0.2</taxRate>
     [java]     <totalCost>12.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>134</widgetId>
     [java]     <unitPrice>34.1</unitPrice>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <fillOrder>false</fillOrder>
     [java]     <shipDate>BackOrder</shipDate>
     [java]     <taxRate>0.2</taxRate>
     [java]     <totalCost>0.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>211</widgetId>
     [java]     <unitPrice>10.0</unitPrice>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]     <taxRate>0.2</taxRate>
     [java]     <totalCost>1200.0</totalCost>
     [java]   </quoteResponse>
     [java] </quote>
     [java] 
     [java] 
     [java] Output quote from web service join:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <quote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:quo="http://www.example.org/quote" xsi:type="quo:Quote">
     [java]   <name>Acme Inc</name>
     [java]   <address>12 Springs Rd,Morris Plains,NJ,07960</address>
     [java]   <quoteResponse>
     [java]     <widgetId>12</widgetId>
     [java]     <unitPrice>1.0</unitPrice>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>11.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>134</widgetId>
     [java]     <unitPrice>34.1</unitPrice>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <fillOrder>false</fillOrder>
     [java]     <shipDate>BackOrder</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>0.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>211</widgetId>
     [java]     <unitPrice>10.0</unitPrice>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>1100.0</totalCost>
     [java]   </quoteResponse>
     [java] </quote>
     [java] 
     [java] 
     [java] Output quote from properties join:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <quote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:quo="http://www.example.org/quote" xsi:type="quo:Quote">
     [java]   <name>Acme Inc</name>
     [java]   <address>12 Springs Rd,Morris Plains,NJ,07960</address>
     [java]   <quoteResponse>
     [java]     <widgetId>12</widgetId>
     [java]     <unitPrice>1.0</unitPrice>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>11.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>134</widgetId>
     [java]     <unitPrice>34.1</unitPrice>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <fillOrder>false</fillOrder>
     [java]     <shipDate>BackOrder</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>0.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>211</widgetId>
     [java]     <unitPrice>10.0</unitPrice>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>1100.0</totalCost>
     [java]   </quoteResponse>
     [java] </quote>
     [java] 
     [java] 
     [java] Output quote from external references join:
     [java] <?xml version="1.0" encoding="ASCII"?>
     [java] <quote xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:quo="http://www.example.org/quote" xsi:type="quo:Quote">
     [java]   <name>Acme Inc</name>
     [java]   <address>12 Springs Rd,Morris Plains,NJ,07960</address>
     [java]   <quoteResponse>
     [java]     <widgetId>12</widgetId>
     [java]     <unitPrice>1.0</unitPrice>
     [java]     <requestedQuantity>10</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-03-22</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>11.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>134</widgetId>
     [java]     <unitPrice>34.1</unitPrice>
     [java]     <requestedQuantity>345</requestedQuantity>
     [java]     <fillOrder>false</fillOrder>
     [java]     <shipDate>BackOrder</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>0.0</totalCost>
     [java]   </quoteResponse>
     [java]   <quoteResponse>
     [java]     <widgetId>211</widgetId>
     [java]     <unitPrice>10.0</unitPrice>
     [java]     <requestedQuantity>100</requestedQuantity>
     [java]     <fillOrder>true</fillOrder>
     [java]     <shipDate>2003-04-21</shipDate>
     [java]     <taxRate>0.1</taxRate>
     [java]     <totalCost>1100.0</totalCost>
     [java]   </quoteResponse>
     [java] </quote>
     [java] 

BUILD SUCCESSFUL
Total time: 16 seconds



Sample Overview
---------------

 1. There is a central component for invoking the different
    scenarios: QuoteJoinLocalComponent
 2. It provides the following cases:
    - invoke XQuery component in the current assembly, by providing all needed
      information as input parameters
    - invoke XQuery component in external assembly, which is exposed as a web 
      service
    - invoke XQuery component in the current assembly, which retrieves the needed
      information from the component properties
    - invoke XQuery component in the current assembly, which retrieves the needed
      information from its references to other components:
         - one of the components is in the current assembly
         - the other component is in anther assembly and it is exposed (and accessed)
           as web service
    
  3. All of the XQuery components have reference to a component for calculation of the
    total price 
  4. SDO is used for data interchange

src/main/resources
    wsdl
        AvailQuote.xsd 
        PriceQuote.xsd
        Quote.xsd
        quotejoin.wsdl
    META-INF
        sca
            quote_join_external_references.xq --- the external references xquery script
            quote_join_properties.xq --- the property-based join xquery script
            quote_join.xq --- the join xquery script
    xqueryquotews.composite --- composite file for the client side
    xqueryquotewsclient.composite --- composite file for the service side
    
    build.xml                            - the Ant build file
    pom.xml                              - the Maven build file   


Building And Running The Sample Using Ant
-----------------------------------------
cd quote-xquery
ant compile 
ant run-server

you should see: 
Buildfile: build.xml

run:
 


Building And Running The Sample Using Maven 
-------------------------------------------
With either the binary or source distributions the sample can be built and run 
using Maven as follows. 

cd quote-xquery
mvn


This shows that the Junit test cases have run successfully.