Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip

Before you begin,

  • Download the product installer from here, and run the installer.
    Insert excerpt
    Installing the Product
    Installing the Product
    nopaneltrue
  • Select the relevant WSO2 Integration Studio based on your operating system and download it from here.
    The path to this folder is referred to as <EI_TOOLING> throughout this tutorial.

    Info

    Getting an error message? See the troubleshooting tips given under Installing WSO2 Integration Studio.

  • If you did not try the Sending a Simple Message to a Service tutorial yet,
    1. Download the pre-packaged project that contains the configurations of the Sending a Simple Message to a Service tutorial.
    2. Open WSO2 Integration Studio, click File, and click Import.
    3. Next, expand the WSO2 category and select Existing WSO2 Projects into workspace, click Next, and upload the project file.

...

  1. In the REST API configuration, select API Resource in the API palette and drag it onto the canvas just below the previous API resource that was created.
  2. Anchor
    uriTemplate
    uriTemplate
    Click the API Resource you just added to access the Properties tab and fill in the following details:

    Url Style

    Click the down arrow and select URI_TEMPLATE  from the list.

    URI-TemplateEnter /categories/{category}/reserve
    MethodsEnable Post 

  3. Drag a Property mediator from the Mediators palette to the In Sequence of the API resource and name it Get Hospital.
    This is used to extract the hospital name that is sent in the request payload.
  4. With the Property mediator selected, access the Properties tab and fill in the following details:

    Property NameNew Property...
    New Property NameHospital
    Property Actionset
    Value TypeEXPRESSION
    Value Expression

    Click the Value Expression field in the Property tab and add the following expression:
    json-eval($.hospital)

    Info

    This is the JSONPath expression that will extract the hospital from the request payload.

  5. Add a Switch mediator from the Mediator palette just after the Property Mediator. 

  6. Right-click the Switch mediator you just added and select Add/Remove Case to add the number of cases you want to specify.
     
    In this scenario, we are assuming there are three different hospitals, hence there are three cases. 

  7. Enter 3 for Number of branches and click OK
     

  8. With the Switch mediator selected, go to the Properties tab and fill in the details given below:

    Source XPath

    The Source XPath field is where we specify the XPath expression, which obtains the value of the hospital that we stored in the Property mediator.

    Follow the steps given below to specify the expression:

    1. Click in the Value field of the Source XPath property.
    2. Enter get-property('Hospital') as the XML value.
    3. Click OK.  
    Info

    For more information on get-property(), see XPath Extension Functions.

    Case Branches

    Follow the steps given below to add the case branches:

    1. Double click the 'Case Regex' values listed under the Case Branches property.
    2. Change the RegExp values as follows for each of the Case branches:
      • Case 1: grand oak community hospital
      • Case 2:  clemency medical center
      • Case 3:  pine valley community hospital
    3. Click OK
  9. Let's add a /wiki/spaces/EI6xx/pages/49612782 to print a message indicating to which hospital the request message is being routed.
    Drag a Log mediator to the first Case box of the Switch mediator, and name it Grand Oak Log.

    Anchor
    SwitchLogMediator
    SwitchLogMediator

  10. With the Log mediator selected, access the Properties tab and fill in the information given in the table below:

    FieldValueDescription
    Log CategoryINFOIndicates that the log contains an informational message.
    Log LevelCUSTOMWhen Custom is selected, only specified properties will be logged by this mediator.
    For more information on the available log levels, see the Log Mediator .
    Log Separator(blank)Since there is only one property that is being logged, we do not require a separator, so this field can be left blank.
    Properties

    Follow the steps given below to extract the stock symbol from the request and print a welcome message in the log.

    1. Click the Value field of the Properties property, and then click the browse (...) icon that appears.
    2. In the Log Mediator Configuration dialog, click New, and then add a property as follows:
      • Namemessage
      • TypeEXPRESSION
        (We select EXPRESSION because the required properties for the log message must be extracted from the request, which we can do using an XPath expression.)
      • Value/Expression: Click the browse (...) icon in the Value/Expression field and enter fn:concat('Routing to ', get-property('Hospital')).

        Info

        This XPath expression value gets the value stored in the Property mediator and concatenates the two strings to display the log following message: Routing to <hospital name>.

    3. Click OK.
  11. Add a Send mediator adjoining the Log mediator and add the GrandOakEP endpoint from Defined Endpoints palette to the empty box adjoining the Send mediator.

  12. Add Log mediators in the other two Case boxes in Switch mediator and then enter the same properties as in Step 10.
    Make sure to name the two Log mediators as Clemency Log and Pine Valley Log respectively. 

  13. Add Send mediators adjoining these log mediators and respectively add the ClemencyEP and PineValleyEP endpoints from the Defined Endpoints palette.

    Info

    You have now configured the Switch mediator to log the Routing to <Hospital Name> message when a request is sent to this API resource. The request message will then be routed to the relevant hospital backend service based on the hospital that is sent in the request payload. 

  14. Add a Log mediator to the Default (the bottom box) of the Switch mediator and configure it the same way you did for the Log mediator above.

    Note

    Make sure to name it Fault Log and changing its Value/Expression as follows: fn:concat('Invalid hospital - ', get-property('Hospital'))

    The default case of the Switch mediator handles the invalid hospital requests that are sent to the request payload. This logs the "Invalid hospital - <Hospital Name>" message for requests that have the invalid hospital name.

  15. Drag a Respond mediator next to the Log mediator you just added.
    This ensures that there is no further processing of the current message and returns the request message back to the client.
    The In Sequence of the API resource configuration should now look like this:
  16. Drag a Send mediator to the Out sequence of the API resource, to send the response back to the client. 
  17. Save the updated REST API configuration.

...

  1. Download the JAR file of the back-end service.
  2. Open a terminal and navigate to the location where your saved the back-end service.

  3. Execute the following command to start the service:

    Code Block
    java -jar Hospital-Service-JDK11-2.0.0-EI7.jar

The Healthcare service is now active and you can start sending requests to the service.

...