summaryrefslogtreecommitdiffstats
path: root/sca-java-1.x/trunk/demos/alert-aggregator-webapp/README
blob: 45568e4b7201bbb35acb66c12b4b71b32dbca569 (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
Apache Tuscany Alert Aggregator Demo
====================================

The alert aggregator demo provides an application, implemented using SCA, that 
aggregates feeds together and exposes them using the following bindings: 

binding.ws
binding.jsonrpc
binding.feed

The easiest way to get going is to build the demo

cd alert-aggregator-webapp
ant package

This will build a war file 

demo-alert-aggregator-webapp.war

This war can be deployed to your web application container and tested (the war
has been tested with Tomcat 6.0.10). 

The Web Application
-------------------

Once deployed point your browser at 

http://localhost:8080/demo-alert-aggregator-webapp

Taking care to ensure the host name and port number match your local 
configuration. 

This launches a Javascript application in the browser that uses JSONRPC
to contact the server and retrieve a list of alert sources and alerts that
these sources are providing.

The default sources that you see are stored in the following file:

demo-alert-aggregator-webapp/WEB-INF/classes/sources.xml

This file has the following contents:

<ns0:Config xmlns:ns0="http://tuscany.apache.org/sca/demos/aggregator/types">
<ns0:Source Id="0" FeedType="rss">
  <ns0:Name>BBC News</ns0:Name>
  <ns0:Address>http://news.bbc.co.uk/</ns0:Address>
  <ns0:LastChecked>10-Jun-2007 16:34:03</ns0:LastChecked>
  <ns0:FeedAddress>http://newsrss.bbc.co.uk/rss/newsonline_uk_edition/world/rss.xml</ns0:FeedAddress>
</ns0:Source>
<ns0:Source Id="1" FeedType="rss">
  <ns0:Name>Engadget</ns0:Name>
  <ns0:Address>http://www.engadget.com</ns0:Address>
  <ns0:LastChecked>10-Jun-2007 16:34:03</ns0:LastChecked>
  <ns0:FeedAddress>http://www.engadget.com/rss.xml</ns0:FeedAddress>
</ns0:Source>
</ns0:Config>

You may want to adjust the "LastChecked" values to change the number of
alerts that are displayed in the first instance.

Using A Feed Reader
-------------------

As this SCA application also uses the binding.feed binding you can use your
favourite feed reader to read the aggregated alerts. To do this point your
feed reader at

http://localhost:8080/demo-alert-aggregator-webapp/services/AlertsFeedServiceRSS

Again taking care to ensure that the host name and port number match you 
local configuration.

Using Web Services
------------------

The SCA application also uses binding.ws to provide a SOAP/HTTP interface. 
The demo client that uses this interface is not yet available. 

Building The Sample Using Ant
-----------------------------

With the binary distribution the sample can be built using Ant as follows:

cd alert-aggregator-webapp
ant package

Building The Sample Using Maven
-------------------------------

With the source and binary distributions the sample can be built using Maven
as follows:

cd alert-aggregator-webapp
mvn

The Maven build runs an integration test after building the war file.