GetQuote Service

Introduction

This guide demonstrates a service for getting quotations, which uses business rules for creating quotations.

Prerequisites

To run this sample:

Windows, Linux or Solaris operating system should exist.
WSO2 BRS should be installed. To install the BRS, refer Installing the Product. This also includes installing Apache Ant as one of the Installation Prerequisites.
WSO2 BRS should be started as described in Running the Product.

Sample configuration

Sample rule definition

Rules

Rule 1: If the customer has bronze status, then the item costs five dollars.

Rule 2 : If the customer has silver status, then the item costs four dollars.

Rule 3 : If the customer has gold status, then the item costs three dollars.

Facts

There is a fact named A customer made a get quote request . Quotation is used to capture the result of the rules execution.

package samples.quotation;

 /**
  * Customer fact
 */
 public class Customer {

    private String status;

    public String getStatus() {
        return status;
    }

    public void setStatus(String status) {
        this.status = status;
    }
 }

 package samples.quotation;

 /**
  * Quotation result
 */
 public class Quotation {

    private int price;

    public int getPrice() {
        return price;
    }

    public void setPrice(int price) {
            this.price = price;
    }
 }

Rule service configuration (service.rsl)

An in-line rule set is used within the service.rsl file as follows:

<ruleService
        name="GetQuoteService"
        xmlns="http://wso2.org/carbon/rules"
        targetNamespace="http://com.test/quotation">
    <ruleSet>
        <rule resourceType="regular" sourceType="inline">
            <![CDATA[
                package quotation

                import samples.quotation.Customer;
                import samples.quotation.Quotation;

                rule "Gold Customer"
                when
                      Customer( status == "gold" )
                then
                      Quotation q = new Quotation();
                      q.setPrice(3);
                      insertLogical(q);
                end

                rule "Silver Customer"
                when
                      Customer( status == "silver" )
                then
                      Quotation q = new Quotation();
                      q.setPrice(4);
                      insertLogical(q);
                end

                rule "Bronze Customer"
                when
                      Customer( status == "bronze" )
                then
                      Quotation q = new Quotation();
                      q.setPrice(5);
                      insertLogical(q);
                end
            ]]>
        </rule>
    </ruleSet>
    <operation name="getQuote">
        <input wrapperElementName="placeCustomerDetail" namespace="http://com.test/placeCustomerDetail">
            <fact elementName="customerDetail" namespace="http://com.test/placeCustomerDetail" type="samples.quotation.Customer"></fact>
        </input>
        <output wrapperElementName="placeCustomerDetailRespone" namespace="http://com.test/placeCustomerDetail">
            <fact elementName="getQuotation" namespace="http://com.test/placeCustomerDetail" type="samples.quotation.Quotation"></fact>
        </output>
    </operation>
</ruleService>

Executing the service

To execute the service, run the ant command from the <PRODUCT_HOME>/samples/quotation.service directory to run the GetQuote Service.

Before executing this service, it is recommended that you refer Exposing Rules as Services which explains in detail the process of writing and deploying a business rule.

Deploying and testing the service

Deploy the rule service through the BRS management console. You can follow either of the two methods:
- Bundle all artifacts in an .aar file and upload it (Rule Service -> Upload menu).
- Create using the Rule Service wizard UI (Rule Service -> Create menu).
The above steps are discussed in detail in section Exposing Rules as Services.
After deployment, click on List under Services in the main tab of the management console. The service will appear in the Deployed Services page.
Click GetQuote Service to access the dashboard of the service.
Click Try this service in the Client Operations widget of the dashboard to invoke the Try-it tool.
Issue a request similar to the following in the Try-it tool:
```
<status>gold</status>
```
You would get the following response:
```
<price>3</price>
```

Alternatively, you can use Generate Axis2 Client link in the Client Operations widget of the dashboard to invoke the service. A client using generated stub codes is shown below where the codes were generated with the Unpacks the data binding classes check box checked.

package org.wso2.carbon.samples;

import org.apache.axis2.AxisFault;
import org.wso2.carbon.samples.quoteService.customerDetail.Customer;
import org.wso2.carbon.samples.quoteService.customerDetail.PlaceCustomerDetail;
import org.wso2.carbon.samples.quoteService.customerDetail.Quotation;
import org.wso2.carbon.samples.quoteService.stub.GetQuoteServiceStub;
import java.rmi.RemoteException;

public class GetQuoteServiceTestCase {

    public static void main(String[] args) {

        try {
            GetQuoteServiceStub getQuoteServiceStub = new GetQuoteServiceStub("http://localhost:9763/services/GetQuoteService");

            PlaceCustomerDetail placeCustomerDetail = new PlaceCustomerDetail();
            Customer customer = new Customer();
            customer.setStatus("gold");
            Customer[] customers = new Customer[1];
            customers[0] = customer;
            placeCustomerDetail.setCustomerDetail(customers);

            Quotation[] quotations = getQuoteServiceStub.getQuote(customers);
            int result = quotations[0].getPrice();
            System.out.println(result);
        } catch (AxisFault axisFault) {
            axisFault.printStackTrace();
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }
}