biz.onixs.fix.fixml

Class FixmlConverter

java.lang.Object

biz.onixs.fix.fixml.FixmlConverter

public class FixmlConverter
extends Object

A utility class for converting between FIX and FIXML messages.

Constructor Summary

Constructors

Constructor and Description
FixmlConverter(String schemaPath, Version fixVersion) Initializes converter instance.
FixmlConverter(Version fixVersion) Initializes converter instance.

Method Summary

Modifier and Type	Method and Description
void	addCustomMessage(String msgType, String messageName) Adds custom message.
void	addCustomRepeatingGroup(int instanceNumberTag, String groupBlockName) Adds custom repeating group.
String	fix2fixml(Message fixMsg) Converts FIX message to FIXML.
String	fix2fixml(Message fixMsg, boolean formatting) Converts FIX message to FIXML.
Message	fixml2fix(String fixmlMsg) Converts FIXML to FIX message without failing on warnings.
Message	fixml2fix(String fixmlMsg, boolean failOnWarning) Converts FIXML to FIX message.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FixmlConverter

public FixmlConverter(Version fixVersion)
               throws Exception

Initializes converter instance.

Parameters:

fixVersion - fix version used for vise-versa conversion based on internal schemas

Throws:

Exception - if an error occurred during creation of FIXML converter

FixmlConverter

public FixmlConverter(String schemaPath,
                      Version fixVersion)
               throws Exception

Initializes converter instance.

Parameters:

schemaPath - custom schema used for visa-versa conversion

fixVersion - fix version used for visa-versa conversion

Throws:

Exception - if an error occurred during creation of FIXML converter

Method Detail

fix2fixml

public String fix2fixml(Message fixMsg)
                 throws FixmlConverterException

Converts FIX message to FIXML.

Parameters:

fixMsg - FIX message

Returns:

converted and formatted FIXML

Throws:

FixmlConverterException - if an error occurred during conversion

fix2fixml

public String fix2fixml(Message fixMsg,
                        boolean formatting)
                 throws FixmlConverterException

Converts FIX message to FIXML.

Parameters:

fixMsg - FIX message

formatting - whether to format output or not

Returns:

converted FIXML

Throws:

FixmlConverterException - if an error occurred during conversion

fixml2fix

public Message fixml2fix(String fixmlMsg)
                  throws FixmlConverterException

Converts FIXML to FIX message without failing on warnings.

Parameters:

fixmlMsg - FIXML message

Returns:

FIX message

Throws:

FixmlConverterException - if an error occurred during conversion

fixml2fix

public Message fixml2fix(String fixmlMsg,
                         boolean failOnWarning)
                  throws FixmlConverterException

Converts FIXML to FIX message.

Parameters:

fixmlMsg - FIXML message

failOnWarning - whether to fail on warning or not

Returns:

FIX message

Throws:

FixmlConverterException - if an error occurred during conversion

addCustomMessage

public void addCustomMessage(String msgType,
                             String messageName)

Adds custom message. If there is already such a message then it will be replaced.

Parameters:

msgType - message type

messageName - message name

addCustomRepeatingGroup

public void addCustomRepeatingGroup(int instanceNumberTag,
                                    String groupBlockName)

Adds custom repeating group. If there is already such a repeating group then it will be replaced.

Parameters:

instanceNumberTag - instance number tag

groupBlockName - repeating group name