Objective

To demonstrate the ability of a Fiorano REST application to interact with an end user by exposing a REST service which accepts HTTP GET requests at a URL and responds with a Hello World message.

Prerequisites

• Start the Fiorano Enterprise Server (FES) and the Fiorano Peer Server (FPS)
• Login to the eStudio application
• Understand basic menus and perspectives (panels) in the eStudio application

Scenario

Build a REST service to accept HTTP GET requests at: http://localhost:1880/restgateway/services/HelloWorld/sayHello and respond with the message "HelloWorld".

How it Works

The REST service gets deployed in the jetty server running inside the peer server. Whenever a rest client sends a request to the service, the request is available on the output port and the response can be routed back by connecting a route to the input port.

Components used

• RESTStub component.

Setting up the Example

Configuring RESTStub component

To configure the RESTstub component, perform the actions below in  theeStudio application:

1. Open the Server Explorer window (Window > Show View > Fiorano > Server Explorer), right-click Event Process Repository and select Add Event Process and create a new Event Process with name 'RESTStub_Example'.
    
2. In the Service Palette, under the Web category, drag the RESTStub component to the Fiorano Orchestrator.
   
   
   Figure 1: Adding RESTStub component to Orchestrator
    
3. Double-click the component to open the Configuration Property Sheet (CPS).
    

4. The first screen in the CPS, wizard (1 of 3), is used to define the service using a user interface for WADL.

   Icon

   A WADL can be created manually by defining different aspects of the service or can load an existing WADL and edit the configurations.

   In the first screen, perform the actions below and click Next:

   1. Provide the Service Name as 'HelloWorld' with which the event process functionality is exposed as a RESTful service.

   2. Go to resource under the Resources node. Under the Resource Configuration tab, replace the default value of Path 'resourcePath' with 'sayHello' to give a logical meaning to the scenario.
      
      

      Icon

      The default method is GET. More methods can be added by right-clicking the resource. Request can be configured and more response elements can be added from the context menu of the method. Refer to the Method Configuration section for more information.

       

      
      Figure 2: Service Name and resource configuration
       

5. In the second screen, wizard (2 of 3), where SSL Configuration, HTTP Authentication Configuration and Additional Configuration can be done, click Next as no change are required for this example.
   
   
   Figure 3: Clicking the Next button to move to the final screen
    

6. Click Finish in the third screen, wizard (3 of 3) , to close the CPS and to save the configuration. The input and output ports get generated.

   Icon

   Default Connection Configuration works for this example. Refer to the FES Connection Configuration section to know more about advanced configurations.

   
   
   Figure 4: Clicking the Finish button to save configuration
    

7. Drag the Output port to connect it to Input port. A route will be created with the default name 'route1'.
   
   
   Figure 5: Connecting the input port to the output port

Configuring Transformation

To configure the transformation between the input and the output port, perform the actions below in Fiorano Orchestrator:

1. Right-click route1, point to Configure Transformation and select the Mapper Project to open Fiorano Mapper editor.
   
   
   Figure 6: Opening Mapper Project window
    
2. In the Output Structures panel in the Mapper Project, click ANY element to make it appear in the Funclet View.
   
   
   Figure 7: Clicking ANY element
    
3. Click the Funclet View tab and select 'String Functions' from the Function Palette (Advanced Functions drop-down menu shown in Figure 3).
   
   
   Figure 8: Selecting String Functions from the Function palette
    
4. Drag and drop the Constant function to the Funclet easel. Connect the Source node of Constant and the Destination node of ANY by dragging from the grey box in the constant).
   
   
   Figure 9: Connecting Constant function to ANY element
    
5. Double-click the Constant present in the easel. In the String Constant dialog box, replace the default text 'Constant' with 'HelloWorld'. The name 'Constant' will be replaced with 'HelloWorld'.
   
   
   Figure 10: Changing the Constant name
    
6. Click Save icon (or File > Save) to save the transformation configuration and close the Mapper Project editor.

Running the Example

To run the HElloWorld_example, perform the actions below in the Fiorano Orchestrator:

1. Click Check Resource and Connectivity icon (or press ALT+SHIFT+C) to check resource and connectivity.
2. Click the Run Event Process icon (ALT+SHIFT+R) to run the event process.
    
3. Right-click the RESTStub component and click View WADL option.
   
   
   Figure 11: Navigating to view WADL
    

4. WADL appears in the browser.

   Icon

   The IP address will be different from the one in the figure below.

   
   Figure 12: WADL displayed in the browser
    

5. To access the service, type the following URL in a new tab and press ENTER to receive a response from the HelloWorld service:

   Icon

   Provide the same IP address as seen in the URL in the above figure.

   
   
   Figure 13: Response from HelloWorld service

Reference

• Download RESTStub_Example event process and import it to the Event Process Repository in the Server Explorer in eStudio to understand the configuration used in this example and to execute the working sample.
• Please note that the component options used in this example are minimum so as to get an overview of the application. To explore the other options present in the RESTStub component, refer the RESTStub documentation.