Contact Us 1-800-596-4880

Installing and Testing Your Connector

DevKit is compatible only with Studio 6 and Mule 3. To build Mule 4 connectors, see the Mule SDK documentation.

Having built a project with the Anypoint DevKit plugin, you can install the skeletal connector in Anypoint Studio to confirm its basic functionality before adding more operations to it. This document describes the steps to take to build, then install and test your connector in Anypoint Studio.

The steps of this procedure are:

  1. Set required @Connector annotations.

  2. Add a "put in barn" operation to connector.

  3. Document the "put in barn" operation.

  4. Build the connector project and Install it using the Anypoint DevKit plugin.

  5. Test the connector’s basic functionality.

Prerequisites

This document assumes you have created a connector project.

Setting @Connector Annotation Parameters

The @Connector annotation on the Maven-generated class has a required parameter: friendlyName. (See example below.) This parameter defines a human-readable name for the connector, which appears as the connector’s label in Studio’s palette. Without this parameter, the connector does not appear in the palette in Anypoint Studio.

@Connector(name = "barn", schemaVersion = "1.0", friendlyName = "Barn")

Adding an Operation

The connector project you created is immediately ready to build, then install and test in Anypoint Studio. However, to make testing more interesting, you can add an operation to the connector that receives an animal as a string and returns the same animal name followed by "has been placed in the barn". Follow the steps below to add this operation.

  1. In Anypoint Studio, open the main Java file, src/main/java/org.mule.modules.barn/BarnConnector.java

  2. Paste the following code in the connector class:

    /**
     * Custom processor that places an animal in the barn.
     *
     * {@sample.xml ../../../doc/barn-connector.xml.sample barn:putInBarn}
     *
     * @param animal Name of the animal to be place in the barn
     * @return returns processed message
     */
     @Processor
     public String putInBarn(String animal) {
        return animal + " has been placed in the barn";
     }
    The identifier name is reserved and cannot be used as a parameter.
  3. Confirm that the complete class appears as follows:

    /**
     * (c) 2003-2014 MuleSoft, Inc. The software in this package is published
     * under the terms of the CPAL v1.0 license, a copy of which has been
     * included with this distribution in the LICENSE.md file.
     */
    package org.mule.modules.barn;
    import org.mule.api.annotations.Config;
    import org.mule.api.annotations.Connector;
    import org.mule.api.annotations.Configurable;
    import org.mule.api.annotations.Processor;
    import org.mule.api.annotations.param.Default;
    /**
     * Anypoint Connector
     *
     * @author MuleSoft, Inc.
     */
    @Connector(name="barn", schemaVersion="1.0", friendlyName="Barn")
    public class BarnConnector
    {
        /**
         * Configurable
         */
        @Configurable
        @Default("value")
        private String myProperty;
        @Config
        ConnectorConfig config;
    
        /**
         * Custom processor
         *
         * {@sample.xml ../../../doc/barn-connector.xml.sample barn:my-processor}
         *
         * @param content Content to be processed
         * @return Some string
         */
        @Processor
        public String myProcessor(String content) {
            /*
             * MESSAGE PROCESSOR CODE GOES HERE
             */
            return content;
        }
        /**
         * Custom processor that places an animal in the barn.
         *
         * {@sample.xml ../../../doc/barn-connector.xml.sample barn:putInBarn}
         *
         * @param animal Name of the animal to be place in the barn
         * @return returns processed message
         */
         @Processor
         public String putInBarn(String animal) {
            return animal + " has been placed in the barn";
         }
        /**
         * Set property
         *
         * @param myProperty My property
         */
        public void setMyProperty(String myProperty) {
            this.myProperty = myProperty;
        }
        /**
         * Get property
         */
        public String getMyProperty() {
            return this.myProperty;
        }
        public ConnectorConfig getConnectorConfig() {
            return this.config;
        }
        public void setConnectorConfig(ConnectorConfig
          connectorConfig) {
            this.config = connectorConfig;
        }
    }
  4. In Anypoint Studio, select ConnectorConfig in the code, and on a Mac press the CMD key, or in Windows, press the Ctrl key. The ConnectorConfig.java file opens and you can see the connection management implementation for this connector.

Documenting the Operation

Because DevKit enforces proper documentation of all projects, you must provide at least one example of how to use each operation you add to a connector.

  1. In your Anypoint Studio, open the file doc/barn-connector.xml.sample then paste the following snippet at the end:

    <!-- BEGIN_INCLUDE(barn:putInBarn) -->
        <barn:put-in-barn animal="#[map-payload:animal]" />
    <!-- END_INCLUDE(barn:putInBarn) -->
  2. Confirm that the complete contents of the file appears as:

    <!-- BEGIN_INCLUDE(barn:myProcessor) -->
        <barn:my-processor content="#[map-payload:content]" />
    <!-- END_INCLUDE(barn:myProcessor) -->
    
    <!-- BEGIN_INCLUDE(barn:putInBarn) -->
        <barn:put-in-barn animal="#[map-payload:animal]" />
    <!-- END_INCLUDE(barn:putInBarn) -->

Building and Installing the Connector

At this point the connector is ready to be built and used for the first time. The DevKit plugin for Anypoint Studio automates the process of building the connector, running tests, and packaging it to be used in Anypoint Studio.

To start the process to compile and install your connector, right-click your project and select Anypoint Connector > Install or Update.

For manual installation of a new connector, run the below command from the command console from within the connector project directory:

mvn clean package

Installation from Update Site

After running the mvn clean package command:

  1. Go to Help > Install New Software

  2. Click Add. Locate the .zip file/archive in which your connector is packaged.

  3. Ensure the connector appears in the central pane, and is selected. Click Next.

    Install window to add your connector
  4. Again, ensure the connector is selected on the next screen. Click Next, accept the License(s) agreement terms and Finish.

The Install or Update feature can suggest automatic updates to your connector in Anypoint Studio.

For more information about how to package your connector, check Packaging Your Connector for Release.

Testing the Connector

To see your new connector function, create, then run a Mule application which uses the Barn Connector. You can create the application using either the Studio Visual Editor or its XML Editor.

Studio Visual Editor

  1. Create a simple flow using an HTTP connector and your new Barn Connector. Use the default values configured in the HTTP endpoint (port: 8081, host: localhost).

    Simple flow with Barn Connector
  2. Select the connector to open the properties editor. Notice the parameters Studio makes available to the end user to configure. Configure the parameters according to the table below.

    Config panel for Barn Connector
    Parameter Value

    Display Name

    Barn

    Config Reference

    See next step

    Operation

    Put In Barn

    Animal

    #[message.inboundProperties['animal']]

  3. Click the plus sign next to the Config Reference field to create a new global element for your connector to use.

    Config panel for Barn Connector with an arrow pointing to the plus icon
  4. In the My Property, Username, and Password fields, enter any string as the value, then click OK.

    image::global-elements.png["Global Elements Properties window for Barn Connector"]

  5. Save, then run the project as a Mule Application (right-click project name, then select Run As > Mule Application).

  6. From a browser, navigate to http://localhost:8081/?animal=Mule

  7. The application returns the response in your browser (see below).

    Browser with the response of the Mule flow

XML

  1. Create a simple flow using an HTTP connector and your new barn:config. Configure the parameters of each element according to the code sample below.

    <mule xmlns:barn="http://www.mulesoft.org/schema/mule/barn"
        xmlns:http="http://www.mulesoft.org/schema/mule/http" xmlns="http://www.mulesoft.org/schema/mule/core"
        xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
        xmlns:spring="http://www.springframework.org/schema/beans"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd
    http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
    http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
    http://www.mulesoft.org/schema/mule/barn http://www.mulesoft.org/schema/mule/barn/current/mule-barn.xsd">
    
        <barn:config name="Barn" username="user" password="pass"
            myProperty="whatever you want" doc:name="Barn">
            <barn:connection-pooling-profile
                initialisationPolicy="INITIALISE_ONE" exhaustedAction="WHEN_EXHAUSTED_GROW" />
        </barn:config>
    
        <flow name="barntestFlow1" doc:name="barntestFlow1">
            <http:inbound-endpoint exchange-pattern="request-response"
                host="localhost" port="8081" doc:name="HTTP" />
    
            <barn:put-in-barn config-ref="Barn"
                animal="#[message.inboundProperties['animal']]" doc:name="Barn" />
    
        </flow>
    </mule>
  2. Save, then run the project.

  3. From a browser, navigate to http://localhost:8081/?animal=Mule

  4. The application returns the response in your browser (see below).

    Browser with the response of the Mule flow

See Also