This documentation applies to older versions of WSO2 ESB connectors. To find the documentation relevant to the version you are using, select the connector from the WSO2 Connector Store and click Documentation.

All docs This doc
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

This section walks you through the basic structure of a connector and describes how you can write your own connector based on the API you have decided to use.

The basic structure of a connector

Use your IDE to create a Maven project, and create a directory structure similar to the following:

Folder Structure

1connector.xmlThis defines the connector name and dependant modules. (i.e., the metadata of the connector)
2component.xmlThis is included in each module, and defines the available methods in the module.
3init.xmlThis is mandatory for every connector By using this, you can initialize the connector environment. For example, when writing the Salesforce connector, login call can be included here. Sessiontoken and API URL returned as the response can be stored in a property and used with other operations.
4assemble-connector.xml/filter.propertiesThese files are used at the connector build time. You do not need to modify this file.
5pom.xmlThis contains the required dependencies for the connector core libraries, relevant synapse libraries as well as maven repositories for a specific connector.
6<operation-name>.xmlThis is the actual API operation calling configuration. This contains the steps necessary to call the API that is exposed by the third party. Each method of the API can be written in a manner similar to init.xml. If there is any Java code, the code should be included under Java and the relevant dependencies should be added to pom.xml

You need to create the required template using the maven archetype, and then run the following command to generate the maven project sample connector code:

mvn archetype:generate -DarchetypeGroupId=org.wso2.carbon.extension.archetype -DarchetypeArtifactId=org.wso2.carbon.extension.archetype.esb.connector-archetype -DarchetypeVersion=1.0.0  -DgroupId=org.wso2.carbon.esb.connector -DartifactId=org.wso2.carbon.esb.connector.test -Dversion=1.0.0 -DarchetypeRepository=

connector.xml file

This is the main component of the ESB connector, which contains the metadata of the connector. You can add any number of resources (referred to as components) inside the resource/ directory, and include all available resources, in this connector.xml file as dependencies, to load all methods implemented in those components. Following is a sample connector.xml file.

   <component name="twitter" package="org.wso2.carbon.connectors">
       <dependency component="twitter-config"/>
       <dependency component="twitter-search"/>
       <description>synapse library for twitter connector</description>

The properties of the above connector.xml file are described below.


A name for the connector. This connector name should be unique, as the connector methods will refer the connector using this as shown in the following example:

packageThe Java package, from which connectors are implemented.
componentThe resources that are available inside the resources/ directory of the folder structure.

Each dependency points to each resource/component. It will be used to load all methods implemented in the resource into the ESB.

The component property denotes the name of the resource/component. For example, "twitter-search" is the resource name of the following dependency.
<dependency component="twitter-search"/>

iconRelative path of the connector icon.

component.xml file

This file defines the metadata of the component. You can add any number of components inside the resource/ directory, and each component can have multiple methods. You need to define all methods implemented in a component in the component.xml file as sub-components, as shown in the example below.

<component name="twitter-search" type="synapse/template">
       <component name="getSearchTweets">
               Returns a collection of relevant Tweets matching a specified query.
       <component name="getSavedSearchesList">
           <description>Returns the authenticated user’s saved search queries.</description>

The properties of the above connector.xml file are described below.


A name for the resource/component.

subComponentsAll the methods implemented in a component.
component name

The name of the method (i.e. ideally a sequence template).

fileThe name of the method file with the extension.

A brief description about the functionality of the method.

Now that you understand the basic structure of a connector, you can start writing your own connector, which can either be a soap-based connector, REST-based connector or a JAVA API-based connector. For more information on these connector types, see Connector Types.


  • No labels