Creating an Integration Project

An integration project consists of one or several project directories. These directories store the various artifacts that you create for your integration sequence. An integration project can be created as a Maven Multi Module (MMM) project by default. This enables you to add ESB Configs, Composite Exporter, Registry Resources, Connector Exporter, Docker Exporter, and Kubernetes Exporter as sub-modules to the project.

An integration project is the recommended way of creating an “Integration Solution” for the WSO2 Enterprise Integrator as it simplifies the CICD workflow.

Integration project

To create an integration project:

  1. Download and install WSO2 Integration Studio.

  2. Open WSO2 Integration Studio and click New Integration Project in the Getting Started view as shown below. New Integration Project

  3. In the New Integration Project dialog box that opens, enter a name for your integration project. Select the relevant check boxes if you want to create Registry Resources, Connector Exporter, Docker Exporter, or Kubernetes Exporter in addition to the ESB Configs and Composite Exporter. Create a New Integration Project

Sub projects

An integration project can consist of multiple sub-projects. So multiple small projects can exist under a single integration project, where each of these can be dependent on each other and can be grouped together. However, it is not necessary that all sub-projects in an integration project be dependent on every other sub-project.

Sub Project

To add sub-projects to an existing integration project, right-click the integration project and hover over New to see the available project creation options.

Add a New Sub Project

Once you create the new sub project, you can see this nested under your integration project folder in the project explorer.

The following table lists out the available projects that can be associated with an integration project.

Sub project Description
ESB Configs This project stores the ESB artifacts that are used when defining a mediation flow. This includes addition of any synapse artifacts to your integration project that enables features of a typical ESB.
Synapse Engine
The following are the synapse artifacts that can be added to an integration flow.
  • Proxy: This is a virtual service in WSO2 EI that receives messages and processes them. It then delivers them to an endpoint outside EI, where the actual Web Service is located.
  • API: Rest API is an endpoint in WSO2 EI that has a URL. This address specifies the context and resources that need to be accessed through an HTTP method or call such as GET, PUT, POST, DELETE. Requests arrive at the input sequence, the EI processes the message using mediators and forwards the message to the Backend. The output sequence receives the backend’s response, processes it, and forwards the message to the client.
  • Inbound endpoints: They can be configured dynamically without restarting the server. Messages move from the transport layer to the mediation layer without going through the Axis2 engine.
  • Sequences: Sequences are used in the proxy service and the REST APIs. Each sequence is a set of mediators where messages are processed.
  • Mediator: It is the processing unit or action that is performed on a message. For example, when enriching a message, filtering it, sending it to an endpoint, deleting it, etc. Mediators can be customized.
  • Scheduled Tasks: This is a code that is to be executed at a specific moment. Tasks can also be customized.
  • Endpoints: They are destinations, for example, external to WSO2 EI, for a message; it may be a service represented by a URL, mailbox, JMS queue, TCP socket. The same endpoint can be used with several transport protocols.
  • Message Store/Message Processors: This design pattern is used in integration when dealing with messages asynchronously. Which is to say, when the client does not wait for the response. The message is stored in the memory or drive; this is done by the Message Store. The message processor extracts a queue, memory or database from it and sends it to an endpoint. By using this pattern, the delivery of a message to the endpoint can be guaranteed, since it is only deleted from the Store when an endpoint receives the message correctly.
Composite Exporter This project allows you to package all the artifacts (stored as sub-projects under the same integration project) into one composite application (C-APP). This C-APP can then be deployed in the WSO2 EI server.
Composite Application
Registry Resources Create this project if you want to create registry resources for your mediation flow. You can later use these registry artifacts when you define your mediation sequences in the ESB config project.
WSO2 registry has three components, namely local, config, and governance. Registry resources and metadata can be added into each component in the registry.
Registry Resource
Connector Exporter Create this project if you wish to use EI connectors in your mediation sequence (defined in the ESB config project). All connector artifacts need to be stored in a connector exporter module before packaging.
Why Connectors
Docker Exporter Create a Docker Exporter project if you want to deploy your integration solutions inside a Docker environment. This project directory allows you to package multiple integration projects into a single Docker image and then build and push to the Docker registries. For more information on Docker-specific project creation information, see Create Docker Project.
Kubernetes Exporter A Kubernetes Exporter project allows you to deploy your integration solutions in a Kubernetes environment. This module allows you to package multiple integration projects and modules into a single Docker image. Also, a file named integration_cr.yaml is generated, which can be used to carry out Kubernetes deployments based on the k8s-ei-operator. For more information on Kubernetes-specific project creation information, see Create Kubernetes Project.

Maven Multi Module projects

The Maven Multi Module (MMM) integration project is the parent project in an integration solution and sub-projects can be added under this parent project. By default, an integration project is an MMM project unless you specify otherwise.

By building the parent MMM project, you can build all the sub-projects in the integration solution simultaneously. This allows you to seamlessly push your integration solutions to a CI/CD pipeline. Therefore, it is recommended as a best practice to create your Config project and other projects inside an MMM integration project.

This allows you to manage multiple projects such as Config projects, Composite Application projects, and Registry Resource projects as a single entity.

Although the recommended approach is to create an integration project, which essentially has all the functionality of an MMM project, you can also create an MMM project separately.

To create the MMM project:

  1. Open WSO2 Integration Studio and click New Maven Multi Module Project in the Getting Started view.

  2. In the Maven Modules Creation Wizard that opens, enter an artifact ID and other parameters as shown below. The artifact ID will be the name of your MMM project.

  3. Click Finish. The MMM project is created in the project explorer.

Now you can create other projects inside the MMM project. For example, let's create a Config project and a Composite Application project.

You can create sub-projects under this parent MMM project.

Moving sub projects to MMM project

You can import existing sub projects (ESB Config project, Registry resource project, Composite project, etc.) into an existing Maven Multi Module Project (Integration Project).

Right-click the project, and click Import to Maven Muti Module.

import to maven multi module

Building selected MMM profiles

When you create an integration project, you have a parent MMM project with child modules (sub projects). The MMM project in WSO2 Integration Studio now includes multiple maven profiles. Therefore, you can build selected profiles instead of building the complete MMM project.

Maven profiles:

Profile Name Description
Solution Builds the integration artifacts stored in the ESB Config sub project.
Docker Builds the integration artifacts stored in the ESB Config and Docker sub projects.
Kubernetes Builds the integration artifacts stored in the ESB Config and Kubernetes sub projects.

To build a selected Maven profile:

Note

When you build a Docker or Kubernetes profile using this method, you need to have Maven 3.5.2 or a later version installed.

  1. Open a terminal and navigate to the MMM project folder.
  2. Execute the following command:

    mvn clean install -P <Profile_name>

    Tip

    If you don't specify a profile name with the -P parameter, the default profile will apply.

Top