quickfix

Class DefaultMessageFactory

java.lang.Object

quickfix.DefaultMessageFactory

All Implemented Interfaces:

MessageFactory

public class DefaultMessageFactory
extends Object
implements MessageFactory

The default factory for creating FIX message instances.

Constructor Summary

Constructors

Constructor and Description
DefaultMessageFactory() Constructs a DefaultMessageFactory, which dynamically loads and delegates to the default version-specific message factories, if they are available at runtime.
DefaultMessageFactory(String defaultApplVerID) Constructs a DefaultMessageFactory, which dynamically loads and delegates to the default version-specific message factories, if they are available at runtime.

Method Summary

Modifier and Type	Method and Description
void	addFactory(String beginString, Class<? extends MessageFactory> factoryClass) Adds a factory of the given class, which will be delegated to for creating Message instances from messages with the given begin string.
void	addFactory(String beginString, String factoryClassName) Adds a factory of the given class, which will be delegated to for creating Message instances from messages with the given begin string.
Message	create(String beginString, ApplVerID applVerID, String msgType) Creates a message for a specified type, FIX version, and ApplVerID.
Message	create(String beginString, String msgType) Creates a message for a specified type and FIX version
Group	create(String beginString, String msgType, int correspondingFieldID) Creates a group for the specified parent message type and for the fields with the corresponding field ID Example: to create a quickfix.fix42.MarketDataRequest.NoMDEntryTypes you need to call create(quickfix.field.MsgType#MARKET_DATA_REQUEST, quickfix.field.NoMDEntryTypes#FIELD) Function returns null if the group cannot be created.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultMessageFactory

public DefaultMessageFactory()

Constructs a DefaultMessageFactory, which dynamically loads and delegates to the default version-specific message factories, if they are available at runtime.

Callers can set the context classloader, which will be used to load the classes if Class.forName fails to do so (e.g. in an OSGi environment).

Equivalent to DefaultMessageFactory(ApplVerID.FIX50).

DefaultMessageFactory

public DefaultMessageFactory(String defaultApplVerID)

Constructs a DefaultMessageFactory, which dynamically loads and delegates to the default version-specific message factories, if they are available at runtime.

Callers can set the context classloader, which will be used to load the classes if Class.forName fails to do so (e.g. in an OSGi environment).

Parameters:

defaultApplVerID - ApplVerID value used by default for create(String, ApplVerID, String)

Method Detail

addFactory

public void addFactory(String beginString,
                       String factoryClassName)
                throws ClassNotFoundException

Adds a factory of the given class, which will be delegated to for creating Message instances from messages with the given begin string.

Callers can set the context classloader, which will be used to load the classes if Class.forName fails to do so (e.g. in an OSGi environment).

Parameters:

beginString - the begin string whose messages will be delegated to the factory

factoryClassName - the name of the factory class to instantiate and add

Throws:

ClassNotFoundException - if the named factory class cannot be found

RuntimeException - if the named factory class cannot be instantiated

addFactory

public void addFactory(String beginString,
                       Class<? extends MessageFactory> factoryClass)

Adds a factory of the given class, which will be delegated to for creating Message instances from messages with the given begin string.

Parameters:

beginString - the begin string whose messages will be delegated to the factory

factoryClass - the class of the factory to instantiate and add

Throws:

RuntimeException - if the given factory class cannot be instantiated

create

public Message create(String beginString,
                      String msgType)

Description copied from interface: MessageFactory

Creates a message for a specified type and FIX version

Specified by:

create in interface MessageFactory

Parameters:

beginString - the FIX version (for example, "FIX.4.2")

msgType - the FIX message type (for example, "D" for an order)

Returns:

a message instance

create

public Message create(String beginString,
                      ApplVerID applVerID,
                      String msgType)

Description copied from interface: MessageFactory

Creates a message for a specified type, FIX version, and ApplVerID.

Specified by:

create in interface MessageFactory

Parameters:

beginString - the FIX version (for example, "FIX.4.2")

applVerID - the ApplVerID (for example "6" for FIX44)

msgType - the FIX message type (for example, "D" for an order)

Returns:

a message instance

create

public Group create(String beginString,
                    String msgType,
                    int correspondingFieldID)

Description copied from interface: MessageFactory

Creates a group for the specified parent message type and for the fields with the corresponding field ID Example: to create a quickfix.fix42.MarketDataRequest.NoMDEntryTypes you need to call create(quickfix.field.MsgType#MARKET_DATA_REQUEST, quickfix.field.NoMDEntryTypes#FIELD) Function returns null if the group cannot be created.

Specified by:

create in interface MessageFactory

Parameters:

beginString - the FIX version (for example, "FIX.4.2")

msgType - Message type of the enclosing message

correspondingFieldID - the fieldID of the field in the group

Returns:

group, or null if the group can't be created.