- Components used
- Setting up the Example
- Configuring Server Event Process
- Launching the Server Event Process
- Configuring Client Event Process
- Running the Example
To demonstrate the ability of a Fiorano REST application to interact with an end user by exposing a secured REST service which accepts HTTP PUT requests at a URL and responds with a count of new records inserted into a database successfully.
- Start the Fiorano Enterprise Server (FES) and the Fiorano Peer Server (FPS)
- Login to the eStudio application
- Get familiar with the basic menus and perspectives (panels) in eStudio application
- Configure the RESTStub component to receive HTTP PUT requests from RESTConsumer and process it as query configured in a DB component. Bind the DB schema to the RESTStub and transform the routes between the RESTStub and the DB.
Configure the RESTConsumer component to send HTTP PUT requests triggered using a Feeder component which adapts to the RESTConsumer schema.
How it Works
The REST service gets deployed in the peer server and when a rest client sends a request to the service, the request is available on the output port. The response can be routed back by connecting a route to the input port.
Setting up the Example
Configuring Server Event Process
Create an Event Process with the name 'REST-HEAD_Server' to configure the server application.
Configuring RESTStub component
The RESTStub component exposes Restful services in the Fiorano environment. To configure the RESTstub component, perform the actions below in the eStudio application:
- In the REST-HEAD_Server event process, drag the RESTStub component from the Web category in the Microservice palette to the Fiorano Orchestrator.
Double-click the component to open the Configuration Property Sheet (CPS).
- The first screen in the CPS, wizard (1 of 3), is used to define the service using a user interface for WADL. WADL can be created manually by defining different aspects of the service or can load an existing WADL and edit the configurations.
Provide Service Name as 'Sample' with which the event process functionality is exposed as RESTful service.
Remove GET method
Right-click the GET node and select the Remove Method option to remove the default method.
- Right-click resource under the Resources node, go to Add Method and select HEAD option to add the HEAD method.
Rename resource path to give logical meaning to the scenario
Click the resource node.
Under the Resource Configuration tab, replace the default value of Path 'resourcePath' with 'HeadPath'.
- Click Next and Fiinish to save the configuration.
Connecting Ports Creating a Route
Connect the ports of the RESTStub.
To configure transformation between input and output ports of the RESTStub, perform the actions below in the Fiorano Orchestrator:
- Right-click the route, point to Configure Transformation and select the Mapper Project option to open the Fiorano Mapper editor.
- In the Mapper Project, connect the value "resource" in the Input Structures with "MediaType" in the Output Structures:
Click the Save icon (or File > Save) to save the transformation configuration and close the Mapper Project editor.
Launching the Server Event Process
WADL URL has to be copied from the RESTStub component to use in the RESTConsumer component added in later steps. Perform the actions below in the Fiorano Orchestrator:
Click the Check Resource and Connectivity (CRC) icon (or press ALT+SHIFT+C) to check resources and connectivity.
- Click the Run Event Process icon (ALT+SHIFT+R) to run the event process.
Right-click the RESTStub component and click the Copy WADL URL option to copy the WADL URL.
Configuring Client Event Process
Create another Event Process with the name REST-HEAD_Client to configure a client event application with a Feeder and Display.
The RESTConsumer component serves as a client to access exposed services within the Fiorano Environment. To configure the RESTConsumer component and communicate with the RESTStub which has an exposed RESTservice, perform the actions below in the REST-HEAD_Client application:
- Add the RESTConsumer component from Web category in Microservice Palette to the Fiorano Orchestrator.
- Double-click the component to open the Configuration Property Sheet (CPS).
- Perform the actions below in the wizard (1 of 3) panel:
- Enable the Load WADL option. The From URL option gets active/editable.
- Select the From URL option and paste the WADL URL copied from RESTStub onto it.
Click the Load WADL button to apply the RESTStub schemas.
Click Next till the last panel where the Finish button will be enabled and click Finish to close the CPS and to save the configuration. The input and output ports get generated.
- Add Feeder and Display components from the Util category in the Microservice Palette into the REST-HEAD_Client orchestrator.
- Connect the ports of the RESTConsumer to the Feeder and Display components in the following manner:
- Output Port of the Feeder component to the Input Port of the RESTConsumer component.
- Output Port of the RESTConsumer component to the Input Port of the Display component.
- Double-click the Feeder component and click the Connected Port Schemas button in the Message Type Configuration panel. Select the last child node ('resource_PUT_Request' in this example) in the Connected ports window to import the RESTConsumer schema into the feeder and click OK.
- The Select Root Element text box and the schema editor get populated with the RESTConsumer schema. Click Next.
- In the Message Details Configuration panel, click Generate Sample to generate sample, and click OK.
- Click the Finish or Save and Close button to complete the Feeder configuration.
Running the Example
To see the REST-HEAD_Client Event Process running in conjunction with REST-HEAD_Server Event Process, perform the actions below in the REST-HEAD_Client Event Process:
- Click the Check Resource and Connectivity icon (or press ALT+SHIFT+C) to check the resource and connectivity.
- Click the Run Event Process icon (ALT+SHIFT+R) to run the event process. The Feeder and Display windows get opened.
Provide resource parameters (as mapped in the Route Transformation) in the Feeder window and click Send.Expand for sample input
- If the data is successfully sent, Response Status code shows "200" in the Display window.
- Download REST HEAD Client and Server Example event processes and import it to the Event Process Repository in the Server Explorer within 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 basic to have an overview of the application. To explore other options present in the RESTStub and the RESTConsumer components, refer to the sections: RESTStub and RESTConsumer.