[Documentation Index]

WSO2 BRS - Samples : Get Quote Service

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

Please follow the User Guide before proceeding with this sample, if you have not already followed the User Guide.

Contents

Get Quote Service

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 one fact - A customer made a get quote request. Quotation is to capture the result of the rules execution.

              
 package samples.userguide;

 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

<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>

Deploying Service

You can either create an .aar file and upload or create a rule service using rule service wizard UI. Please refer the User Guide for more information.

Testing Sample

You can use Try-it tool with the requests similar to the following.

<status>bronze</status>

You can also use the code generation. There is an option for code generation in the services management page. A client using generated stub codes is shown bellow. Codes was generated with option Unpacks the databinding classes.

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();
        }
    }
}

References