Bhopal_MuleSoft_Meetup_22July2023_Custom Connector using Rest SDK_MuleSoft

1. 22nd July 2023 11 AM TO 12PM IST
Bhopal MuleSoft Meetup
Group #4
Custom Connector using Rest SDK

2. 2
● Please keep yourself muted unless you have any questions.
● We encourage you to keep your video on for interactive session.
● You can write down your question in the chat session.
● Once join please write down your name and email id in chat so that we can have attendance.
● Please provide your valuable feedback. Thanks.
Guidelines

3. 3
● Networking and Knowledge Sharing
● Custom Connector using Rest SDK
● Q&A and then Quiz for all participants
● Discussion for next Meetup, Stay connected, and Happy Learning.
Agenda

4. 4
●About the organizer:
Introductions

5. 5
About the Speaker:
● Senior Software Engineer at Apisero
● Certified Developer.
● 2+ years of Experience in Integrations.
Introductions
Mohamed Fahad MM
Sr. Software Engineer
Apisero Inc

6. Mohamed Fahad MM
Custom Connector using Rest SDK

7. 7
● Mule Connectors
● Custom Connector
● Rest SDK
● Connector-descriptor
● Test Connection
● Connector Java Project
Agenda

8. 8
⮚Connector is a reusable component that interacts with Mule
runtime and Anypoint Studio.
⮚Its a software that connects a Mule flow to an external resource.
Any database, protocol, or API, can be used as a resource.
Mule Connectors

9. 9
⮚Connector is a reusable component that interacts with Mule
runtime and Anypoint Studio.
⮚Its a software that connects a Mule flow to an external resource.
Any database, protocol, or API, can be used as a resource.
Mule Connectors

10. 10
⮚ Multiple security schemes
⮚ Pagination
⮚ Different base Uris for APIs
⮚ Input/Output Metadata propagation for operations
⮚ Hiding complexity
⮚ Validating Connection at design time
Why Custom Connector

11. 11
⮚ Mule SDK
⮚ XML SDK
⮚ REST SDK
Ways to create Custom Connector

12. 12
Rest SDK Advantages

13. 13
Rest SDK Advantages
Test Connection

14. 14
Steps to create a custom connector
using Rest SDK
1.API Specification
(RAML or OAS)
2.Connector-Descriptor
(YAML)
Connector Project
(Maven Based)
Custom Connector

15. 15
DEMO
Organization XYZ have an app - userAPP
➔ Base Uri - http://mock-user-app.us-e2.cloudhub.io
➔ Operations -
○ /getusers - Get all users
○ /getuserbyid - Get a particular User
○ /createuser - Create a user
○ /deleteuser - Delete a particular user
GET
GET
POST
DELETE
*All the endpoints secured by ‘x-api-key’ header

16. 16
REQUIREMENT
★ userAPP to be wrapped as a custom
connector to use it on multiple applications.
/testconnection - Validate the connection
GET
* test connection endpoint is secured by ‘x-api-
key’ header

17. 17
STEPS 1. API Specification
displayName
description

18. 18
STEPS 1. API Specification
displayName
description
required
Why giving datatype is important

19. 19
STEPS 1. API Specification
description

20. 20
STEPS 2. Connector Descriptor
mvn com.mulesoft.connectivity:rest-sdk-
mojo:<PLUGIN_VERSION>:createDescriptor -DapiSpec=<PATH_TO_SPEC>/api.raml
Latest Plugin Version : 0.8.0-RC3

21. 21
STEPS 2. Connector Descriptor
● Parameters that can be
passed along with create-
descriptor
command

22. 22
STEPS 2. Connector Descriptor -
Properties
● ConnectorName
● baseJavaPackage: com.mulesoft.connectors
● extensionXml : shop

23. STEPS 2. Connector Descriptor -
Properties
● baseUri.type can be of 3 types
○ 1. Parameter - Can be changed
according to environment or other
requirements
○ 2. Fixed - Cannot be changed
○ 3. Multiple - when different
endpoints require different base uri
● ignore

24. 24
STEPS 2. Connector Descriptor -
Properties
● testConnection:

25. 25
STEPS 3. Connector Project
mvn com.mulesoft.connectivity:rest-sdk-
mojo:<PLUGIN_VERSION>:createConnector -DapiSpec=<PATH_TO_SPEC>/api.raml -
Ddescriptor=<PATH_TO_DESCRIPTOR>/descriptor.yaml

26. 26
● Share:
○ Tweet using the hashtag #MuleSoftMeetups
○ Invite your network to join: https://meetups.mulesoft.com/bhopal
● Feedback:
○ Fill out the survey feedback.
○ Contact your Organizer Preetam Deshmukh to suggest topics for upcoming events.
○ Contact MuleSoft at meetups@mulesoft.com for ways to improve the program
● Our Next Meetup
○ Date: TBD
○ Location: TBD
○ Topic: TBD
What’s next?

27. Thank you