...
Table of Contents maxLevel 3 minLevel 3
About the sample data service
The EventingSample data service used here is based on the functionality of managing the inventory of a car/motorcycle dealership. It contains the following queries:
- addProduct: A new product is added to the catalog using the addProductQuery query.
- updateProductQuantity: The availability of a certain product is updated using the updateProductQuantityQuery query. This is linked with an input event trigger, which monitors whether the stock of this product is critically low. If so, if fires an event notifying the subscribers that this product's stock needs to be updated.
- getProductByCode: When the product code is given, the getProductByCodeQuery query retrieves product information. The company gives special attention to people querying the database for motocycles. So when a query is made where the product type is "motorcycle", an output trigger associated with this query sends messages to the respective subscribers, which is our email address in this sample.
Pre-requisites
- In the sample, we define a specific topic for events to be published, and an email address is added as a subscription for that topic. In order to allow mails to be sent, we have to configure the mail sender in the client Axis2 configuration. A sample
axis2.xmlfile for the client configuration is stored in<DSS_HOME>/samples/resources/sample_axis2_client.xml. Use it to replace the<DSS_HOME>/repository/conf/axis2/axis2_client.xmlfile. Theaxis2_client.xmlfile contains an already configured mail sender section and is ready to be used. - Edit the data service by adding a valid email address: Here we use the XML Edit option to edit the dataservice. In the XML view, replace all occurences of "test@test.com" with your own email address and restart the server.
Building the sample
The .dbs file of this sample data service should be manually deployed in your server as explained below.
...
See Uploading a Created Data Service.
Running the Sample
The sample service can be run using the TryIt tool, which is bundled with the WSO2 Data Services Server, or a code-generated java client sample as discussed in the Data Services Clients section.
...