{{announcement.body}}
{{announcement.title}}

Mule API: Experience, Process, System

DZone 's Guide to

Mule API: Experience, Process, System

This article explains how to define and understand the basic API layers in Mule.

· Integration Zone ·
Free Resource

This article explains how to define and understand the basic API layers in Mule. I have prepared this demo to explain the layer differences and their implementations. This example is mainly for beginners.

The purpose of this tutorial is to process a valid CSV file and store it into a database. The Experience API lets you expose the API to the end user. The Process API lets you validate the file extension as .csv or not. A system API will carry out the system level processes, such as validating the file contents and processing them to the database.

API Projects Definitions

Image title

Experience API

The Experience API is defined to expose the end user to the API. So, we should define and implement the high-level logic in the API. The purpose of this API is to interact with the Process API and process the output to the end user with the process status.

Step 1: Define the global definitions for the http connectors in the "csv-export-domain" project. 

csv-export-domain.xml

Step 2: Define the RAML definition for the Experience API.

Image title

Image title

Step 3: To generate the flow, right-click on the api.raml file and choose "Mule -> Generate Flows from REST API."

Step 4: Once the api.xml generates the call, see the Process API flow.

Image title

Step 5: Define "initiate-process-api-call" flow for the Process API call. Here is the xml view of the flow.

Image title

Process API

In the Process API, we are doing file extension validation. Except for the .csv file, this API will not process any files. Once the validation is successful, extract the contents of the CSV file and send them to the System API for further processing.

Step 6: Define the RAML definition for the Process API.

Image title

Image title

Step 7: Repeat step 3 and call the System API call.

Image title

Step 8: Define the "initiate-system-api-call" flow for the Process API call. Here is the xml view of the flow. 

Image title

Image title

System API

The System API is for low-level processes. Once we get the JSON input from the Process API, we will validate the content one by one with the Mule validator. If any validation fails, the API will get the actual reason for the validation and reject the flow and pass the reason to the Experience API through the Process API. If the validation of all the content succeeds, process the data for the database to insert/update the record.

Step 9: Define the RAML definition for the System API.

Image title

Step 7: Repeat step 3 and call the "process-file" flow of the System API for content validation and store it into the database (the database part is not complete here).

Image title

Image title

CustomValidationException.java: This custom exception class lets you catch the exception thrown by the validator flow.

Image title

Sample CSV File

Valid content:

Image title

Invalid Content:

Image title

Let me know your thoughts in the comments.

Topics:
mule 3.9 ,integration ,tutorial ,process api ,system api ,experience api ,mule api

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}