summaryrefslogtreecommitdiffstats
path: root/sca-java-1.x/trunk/samples/quote-xquery/README
blob: b92e8671e68e9233d4bb6ac5fcbaf064ff01dc91 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
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

Command Prompt 2:
ant run

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

Command Prompt 1:
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-quote-xquery.jar xquery.quote.XQueryQuoteServer
Command Prompt 2:
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-quote-xquery.jar xquery.quote.XQueryQuoteClient

and on *nix do

Command Prompt 1:
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-quote-xquery.jar xquery.quote.XQueryQuoteServer
Command Prompt 2:
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-quote-xquery.jar xquery.quote.XQueryQuoteClient


Results
----------
The sample when run should simply display on the standard output some startup messages followed by:

The service side:
Buildfile: build.xml

run-server:
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.core.StandardEngine start
     [java] INFO: Starting Servlet Engine: Apache Tomcat/6.0.10
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.ContextConfig defaultWebConfig
     [java] INFO: No default web.xml
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.DigesterFactory register
     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/jsp_2_0.xsd
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.DigesterFactory register
     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_1_1.dtd
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.DigesterFactory register
     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_1_2.dtd
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.DigesterFactory register
     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jsptaglibrary_2_0.xsd
     [java] Sep 18, 2007 1:14:16 PM org.apache.catalina.startup.DigesterFactory register
     [java] WARNING: Could not get url for /javax/servlet/resources/j2ee_web_services_1_1.xsd
     [java] Sep 18, 2007 1:14:17 PM org.apache.coyote.http11.Http11Protocol init
     [java] INFO: Initializing Coyote HTTP/1.1 on http-8085
     [java] Sep 18, 2007 1:14:17 PM org.apache.coyote.http11.Http11Protocol start
     [java] INFO: Starting Coyote HTTP/1.1 on http-8085
     [java] Sep 18, 2007 1:14:17 PM org.apache.tuscany.sca.http.tomcat.TomcatServer addServletMapping
     [java] INFO: Added Servlet mapping: http://localhost:8085/QuoteJoinService
     [java] Sep 18, 2007 1:14:17 PM org.apache.tuscany.sca.http.tomcat.TomcatServer addServletMapping
     [java] INFO: Added Servlet mapping: http://localhost:8085/AvailQuoteProviderService
     [java] XQuery Quote server started (press enter to shutdown)
     [java] Sep 18, 2007 1:16:54 PM org.apache.coyote.http11.Http11Protocol destroy
     [java] INFO: Stopping Coyote HTTP/1.1 on http-8085

BUILD SUCCESSFUL
Total time: 2 minutes 51 seconds

The client side:
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
-----------------------------------------
With the binary distribution the sample can be built and run using Maven
as follows: 

cd quote-xquery
ant compile 
ant run-server

(then from another command prompt)
cd quote-xquery
ant run


Building And Running The Sample Using Maven 
-------------------------------------------
With either the binary or source distribution 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.