FIXML Converter Plugin

Overview

FIXML Converter Plugin created for easy customize FIXML converters according to dictionaries. It replaces generate-tools module. It has two goals: generate-jar and generate-source. By default it executes on phase generate-sources

Goal generate-source

This goal generates FIXML Converters source code for passed dictionaries. Input parameters:

• transformations (required) array of transform items. Contains a set of transformation configurations. Each configuration sould include:
  • fixmlSchemaPath - path to FIXML XSD schema
  • fixDictPath - path to FIX dictionary file
  • fixDictTPath - path to FIX dictionary file with FIXT definition (required only for versions FIX 5.0 and above)
  • fixVersion - FIX protocol vetsion (optional)
• source-output-dir (default value = target/gen-source/) directory for generated sources.

Goal generate-jar

This goal generates FIXML Converters source code, compile and package it to jar. Jar will be named as fixmlconverter-model-VERSION.jar Input parameters:

• transformations (required) array of transform items. Contains a set of transformation configurations. Each configuration sould include:
  • fixmlSchemaPath - path to FIXML XSD schema
  • fixDictPath - path to FIX dictionary file
  • fixDictTPath - path to FIX dictionary file with FIXT definition (required only for versions FIX 5.0 and above)
  • fixVersion - FIX protocol vetsion (optional)
• jar-output-dir - output directory for created jar. Default value is target.
• artifact-name - name for jar. By default artifact name is "fixmlconverter-model"
• install - boolean value equals to false by default. If its true, then generated jar will be install to local maven repository

Usage

Configure plugin something like this if you want generate sources of FIXML converters

<plugin>
    <groupId>com.epam.epm-bfix.fixml</groupId>
    <artifactId>generator-plugin</artifactId>
    <version>2.5.2</version>

    <executions>
        <execution>
            <goals>
                <goal>generate-source</goal>
            </goals>
            <configuration>
                <transformations>
                    <transformConfiguration>
                        <fixmlSchemaPath>fixml-spec/fixml43/fixml4.3v20020920.xsd</fixmlSchemaPath>
                        <fixDictPath>fix-spec/fixdic43.xml</fixDictPath>
                        <fixVersion>FIX43</fixVersion>
                    </transformConfiguration>
                    <transformConfiguration>
                        <fixmlSchemaPath>fixml-spec/fixml50sp2/fixml-main-5-0-SP2.xsd</fixmlSchemaPath>
                        <fixDictPath>${project.build.directory}/fix-spec/fixdic50sp2.xml</fixDictPath>
                        <fixDictTPath>${project.build.directory}/fix-spec/fixdict11.xml</fixDictTPath>
                    </transformConfiguration>
                </transformations>
                <source-output-dir>${project.build.directory}/generated-sources</source-output-dir>
            </configuration>
        </execution>
    </executions>
</plugin>

Configure plugin something like this if you want generate source of FIXML converters, compile it and package to jar:

<plugin>
    <groupId>com.epam.epm-bfix.fixml</groupId>
    <artifactId>generator-plugin</artifactId>
    <version>2.5.2</version>

    <executions>
        <execution>
            <goals>
                <goal>generate-jar</goal>
            </goals>
            <configuration>
                <transformations>
                    <transformConfiguration>
                        <fixmlSchemaPath>fixml-spec/fixml43/fixml4.3v20020920.xsd</fixmlSchemaPath>
                        <fixDictPath>fix-spec/fixdic43.xml</fixDictPath>
                        <fixVersion>FIX43</fixVersion>
                    </transformConfiguration>
                </transformations>
                <!-- Install jar to local maven repository-->
                <install>true</install>
                <jar-output-dir>target</jar-output-dir>
            </configuration>
        </execution>
    </executions>
</plugin>