Transforming Content Types¶
This section describes how you can transform the content type of a message using an API. In this scenario, the API exposes a REST back-end service that accepts and returns XML and JSON messages for HTTP methods as follows:
- GET - Response is in JSON format.
- POST - Accepts JSON request and returns response in XML format.
- DELETE - Empty request body should is required. Returns response in XML format.
Synapse configuration¶
Following is a sample REST API configuration that we can used to implement this scenario. See the instructions on how to build and run this example.
<api xmlns="http://ws.apache.org/ns/synapse" name="HealthcareService" context="/healthcare">
<resource methods="POST" url-mapping="/appointment/reserve">
<inSequence>
<property name="REST_URL_POSTFIX" scope="axis2" action="remove"/>
<send>
<endpoint>
<address uri="http://localhost:9090/grandoaks/categories/surgery/reserve"/>
</endpoint>
</send>
</inSequence>
<outSequence>
<log level="full"/>
<property name="messageType" value="application/xml" scope="axis2"/>
<send/>
</outSequence>
</resource>
<resource methods="GET" uri-template="/appointments/{appointmentNo}">
<inSequence>
<send>
<endpoint>
<address uri="http://localhost:9090/healthcare"/>
</endpoint>
</send>
</inSequence>
<outSequence>
<log level="full"/>
<property name="messageType" value="application/json" scope="axis2"/>
<send/>
</outSequence>
</resource>
<resource methods="DELETE" uri-template="/appointments/{appointmentNo}">
<inSequence>
<send>
<endpoint>
<address uri="http://localhost:9090/healthcare"/>
</endpoint>
</send>
</inSequence>
<outSequence>
<log level="full"/>
<property name="messageType" value="application/xml" scope="axis2"/>
<send/>
</outSequence>
</resource>
</api>
Build and run¶
Create the artifacts:
- Set up WSO2 Integration Studio.
- Create an integration project with an ESB Configs module and an Composite Exporter.
- Create the rest API with the configurations given above.
- Deploy the artifacts in your Micro Integrator.
Set up the back-end service:
- Download the Hospital-Service-2.0.0-JDK11.jar.
-
Open a terminal, navigate to the location of the downloaded service, and run it using the following command:
java -jar Hospital-Service-2.0.0-JDK11.jar
Sending an HTTP POST request:
-
Create the
request.json
file as follows:{ "patient": { "name": "John Doe", "dob": "1940-03-19", "ssn": "234-23-525", "address": "California", "phone": "8770586755", "email": "[email protected]" }, "doctor": "thomas collins", "hospital": "grand oak community hospital", "appointment_date": "2025-04-02" }
-
Following is the cURL command to send an HTTP POST request to the API:
Tip
The context of the API is ‘/healthcare’. For every HTTP method, a url-mapping or uri-template is defined, and the URL to call the methods differ with the defined mapping or template.
curl -v -H "Content-Type: application/json" -X POST -d @request.json http://localhost:8290/healthcare/appointment/reserve
The response from backend to the Micro Integrator will be:
{ "appointmentNumber": 1, "doctor": { "name": "thomas collins", "hospital": "grand oak community hospital", "category": "surgery", "availability": "9.00 a.m - 11.00 a.m", "fee": 7000 }, "patient": { "name": "John Doe", "dob": "1940-03-19", "ssn": "234-23-525", "address": "California", "phone": "8770586755", "email": "[email protected]" }, "fee": 7000, "confirmed": false, "appointmentDate": "2025-04-02" }
The Micro Integrator transform the response to XML and send it back to client as:
<jsonObject> <appointmentNumber>1</appointmentNumber> <doctor> <name>thomas collins</name> <hospital>grand oak community hospital</hospital> <category>surgery</category> <availability>9.00 a.m - 11.00 a.m</availability> <fee>7000.0</fee> </doctor> <patient> <name>John Doe</name> <dob>1940-03-19</dob> <ssn>234-23-525</ssn> <address>California</address> <phone>8770586755</phone> <email>[email protected]</email> </patient> <fee>7000.0</fee> <confirmed>false</confirmed> <appointmentDate>2025-04-02</appointmentDate> </jsonObject>
Sending an HTTP GET request:
-
Following is the CURL command to send a GET request to the API:
curl -v -X GET http://localhost:8290/healthcare/appointments/1
-
The response for the request will be:
{ "appointmentNumber": 1, "doctor": { "name": "thomas collins", "hospital": "grand oak community hospital", "category": "surgery", "availability": "9.00 a.m - 11.00 a.m", "fee": 7000 }, "patient": { "name": "John Doe", "dob": "1940-03-19", "ssn": "234-23-525", "address": "California", "phone": "8770586755", "email": "[email protected]" }, "fee": 7000, "confirmed": false, "appointmentDate": "2025-04-02" }
Sending an HTTP DELETE request:
-
Following is the cURL command for sending an HTTP DELETE request:
curl -v -X DELETE http://localhost:8290/healthcare/appointments/1
This request will be sent to the back end, and the order with the specified ID will be deleted. The response to the Micro Integrator from backend will be as follows:
{"status":"Appointment is successfully removed"}
-
The Micro Integrator transform the response to XML and sends it back to the client as follows:
<jsonObject><status>Appointment is successfully removed</status></jsonObject>