How to develop and deploy a Transport Connector Reader

Contents

Connector Readers
 How to develop and deploy a Connector Reader
 

Connector Readers

The Connector Readers handle the inbound messages from other systems. For the protocol adaptation there are distinct readers exists for each protocol. For more details on connector readers see included transport connectors.

Each reader will run in a separate thread when the connect server is started. You can specify which reader thread to start with by a given connect server instance at the connect configuration feature in CONNECTORS textbox.

 

How to develop and deploy a Connector Reader

Update and merged the deployment steps with development steps.

When default Connector Readers that comes with Extended Server doesn't cater a given instance of any inbound message, you can develop a new Connector Reader.

Steps to follow:

  1. Create the configuration xml file for the connector reader.

    Configuration xml file will contain general connector reader parameters. You can define any other parameters that are used in your reader. e.g. MY_PARAMETER

     

  2. Using Setup IFS Connect feature, import the configuration of your reader.


     

  3. Edit MY_READER1 configuration if needed.


     

    Now your MY_READER1 configuration instance is ready to be used with a connector reader.

     

  4. Download ConnectReaderExample.zip and extract it to $MODULES_ROOT\mymodule\source\mymodule\connectors folder.
    Start IFS Developer Studio, open the extracted project and rename/refactor project name, package name and class name as desired.
  5. Edit build.xml of this project and specify project name and work directory.



    By default, connectserver.jar is added to the classpath in build.xml. If you want to refer additional jar files, add them to build.xml. A commented code in build.xml display hot to do this.


     
  1. Edit your project's manifest file as follows.
    2. Manifest-Version: 1.0
Created-By: IFS Research & Development AB
Receiver-class: connectreaderexample.MyProtocolReader
  2. Edit your implementation file MyProtocolReader.java in connectreaderexample to perform the read operation.
     
  3. Build your project.
    Copy the MyReader.jar file in project's dist folder to $FNDEXT_HOME/javaruntime directory.
     
  4. Add the connector reader instance MY_READER1 to the CONNECTORS attribute of your connect server instance.
     
  5. Restart your connect server.
     
  6. See the connect server instance log file to check your connector reader is Started.