Acceptor或者Initiator能够为您维护尽可能多的FIX会话,因而FIX会话标识的唯一性非常重要。在QuickFIX/N中,一个FIX会话的唯一标识是由:BeginString(FIX版本号)、SenderCompID(发送方ID)及TargetCompID(目标方ID)等标识字符组合而成。通常还会加上SessionQualifier来保证会话的唯一性。
每个FIX会话可以有很多与它们相关联的配置信息。在编译的时候,有些配置可能还是未知的,因此可以通过类SessionSettings来设置或加载。 SessionSettings是一个数据字典,可以随意设置和查询配置信息。
SessionSettings有两个带参数构造函数,其中一个是System.IO.TextReader的参数,它能够解析TextReader的配置信息;另外一个构造参数是文件名,把配置文件的文件路径作为参数传入,它可以解析当中的配置信息 。当然,你也可以自己定义组件(例如,一个特定的数据库存储),然后使用SessionSettings存储配置信息(SessionSettings提供了一个Set方法)。
配置文件当中有两个类型的配置节点: [DEFAULT],[SESSION]。[SESSION]定义一个会话。[DEFAULT]节点定义与会话相关,但没在会话当中明确定义的相关配置,比如连接对手方的IP、端口、心跳间隔等。QuickFIX/N并不会为所有必需配置的定义默认值。如果配置有任何一个QuickFIX/N必需的配置项缺失,它将抛出ConfigError异常,提示配置缺少或格式不正确。
1) 会话配置(SESSION)
配置 | 描述 | 有效值 | 默认 |
BeginString | 会话使用的FIX版本号(发送和接收消息起始字符串) | FIXT.1.1 |
|
FIX.4.4 | |||
FIX.4.3 | |||
FIX.4.2 | |||
FIX.4.1 | |||
FIX.4.0 | |||
SenderCompID | 会话当中定义本方的ID | 区分大小写的字符串 | |
SenderSubID | 会话相关的本方的子ID号 (可选) | 区分大小写的字符串 |
|
SenderLocationID | 会话相关的本方的locationID号 (可选) | 区分大小写的字符串 | |
TargetCompID | 本会话当中的对方ID | 区分大小写的字符串 |
|
TargetSubID | 本会话当中的对方SubID (可选) | 区分大小写的字符串 | |
TargetLocationID | 本会话当中的对方locationID (可选) | 区分大小写的字符串 |
|
SessionQualifier | 附加的限定词,用于消除歧义,保证会话的唯一性 | 区分大小写的字符串 | |
DefaultApplVerID | 仅FIXT1.1(或以上版本)需要。忽略早期版本的传输。指定会话的默认应用程序的版本ID。ApplVerID的枚举值(请看ApplVerID字段详细介绍),或默认BeginString。 | FIX.5.0SP2 | - |
FIX.5.0SP1 | |||
FIX.5.0 | |||
FIX.4.4 | |||
FIX.4.3 | |||
FIX.4.2 | |||
FIX.4.1 | |||
FIX.4.0 | |||
ConnectionType | 定义会话当中本方的角色:acceptor或者r initiator | initiator | - |
acceptor | |||
StartTime | 交易日的会话有效开始时间,这时FIX会话被激活 | UTC时间,格式: HH:MM:SS, | - |
EndTime | 交易日的会话失效时间,FIX会话将被停止 | 同上 | - |
StartDay | 对于为期一周的会话配置,一周会话开始的第一天。与STARTTIME结合使用。 | 使用一周中某天的英语任何缩写都是有效的(比如,mo, mon, mond, monda,Monday都是有效的) | - |
EndDay | 对于为期一周的会话配置,一周会话结束的最后一天。与EndTime结合使用。 | 同上 | - |
MillisecondsInTimeStamp | 时间戳是否加入毫秒。FIX.4.2和更高版本可用。 | Y | Y |
N | |||
ResetOnLogon | 接收登录请求时,序列号是否要复位。只用于Acceptor | Y | N |
N | |||
ResetOnLogout | 正常注销登录时,序列号是否要复位 | Y | N |
N | |||
ResetOnDisconnect | 连接异常断开后是否要将序列号重置为1 | Y | N |
N | |||
RefreshOnLogon | 确定是否应当从持久层登录时恢复会话状态。在创建热故障切换会话时有用。 | Y | N |
N | |||
EnableLastMsgSeqNumProcessed | 是否在header中添加最后一条消息的序列号(可选tag369)。 | Y | N |
N | |||
MaxMessagesInResendRequest | 设置一次重发请求的消息的最大消息数。 | 任何大于0的整数。使用0为无穷大(默认)。 | 0 |
SendLogoutBeforeDisconnectFromTimeout | 指定是否因超时断开连接之前发送logout消息。 | Y | N |
N | |||
IgnorePossDupResendRequests | 当PossDupFlag(tag 43)设置为true时,是否忽略一次重发请求, | Y | N |
N |
2) 验证配置
配置 | 描述 | 有效值 | 默认 |
UseDataDictionary | 告诉会话是否使用数据字典,或不希望使用数据字典。 如果你要使用repeating group,你必须使用DataDictionary。 | Y | Y |
N | |||
DataDictionary | XML定义文件用于验证传入的FIX消息。如果没有提供DataDictionary,只会做基本消息的验证。 | 有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据 | - |
该配置只用于比FIXT.1.1还老的版本。详细参考FIXT.1.1的TransportDataDictionary和AppDataDictionary的配置。 | FIX44.xml | ||
FIX43.xml | |||
FIX42.xml | |||
FIX41.xml | |||
FIX40.xml | |||
TransportDataDictionary | XML定义文件用于验证传入的管理消息。如果没有提供DataDictionary,只会做基本消息的验证。该配置只用于FIXT.1.1(或更高版本)的会话。 | 有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据 | - |
更多信息请参考(FIX.4.0到 FIX.4.4)的DataDictionary。 | FIXT1.1.xml | ||
AppDataDictionary | 用于验证应用层消息的XML定义文件。仅对FIXT.1.1(或更高版本)的会话有效。 更多信息请参考(FIX.4.0到 FIX.4.4)的DataDictionary。 该配置可以为每个会话指定一个自定义应用的数据字典。该配置仅用于FIXT.1.1或更新的传输协议。使用FIXT传输时,该配置可以作为指定多个应用的数据字典的前缀。例如: DefaultApplVerID=FIX.4.2 # For default application version ID AppDataDictionary=FIX42.xml # For nondefault application version ID # Use BeginString suffix for app version AppDataDictionary.FIX.4.4=FIX44.xml | 有效的XML数据字典文件。QuickFIX/N 配备默认的协议字典数据 | - |
FIX50SP2.xml | |||
FIX50SP1.xml | |||
FIX50.xml | |||
FIX44.xml | |||
FIX43.xml | |||
FIX42.xml | |||
FIX41.xml | |||
FIX40.xml | |||
ValidateFieldsOutOfOrder | 如果设置为N,字段放置区域错误(例如,body字段在header区域内,或在header字段在body区域内)将不会被拒绝。用于连接字段要求不严格的系统。 | Y | Y |
N | |||
ValidateFieldsHaveValues | 如果设置为N,没有值的字段将不会被拒绝。用于连接到系统不当发送空标签。 | Y | Y |
N | |||
ValidateUserDefinedFields | 如果设置为N,用户自定义的字段将不会被拒绝,即使没有在数据字典中定义,或没出现在消息中。 | Y | Y |
N |
1) Initiator
设置 | 描述 | 有效值 | 默认 |
ReconnectInterval | 尝试重新连接的时间间隔(秒)。仅用于 initiator。 | 正整数 | 30 |
HeartBtInt | 心跳间隔(秒)。仅用于initiator。 | 正整数 | - |
LogonTimeout | 登录超时时间间隔(秒) | 正整数 | 10 |
LogoutTimeout | 注销登录超时时间间隔(秒)。 | 正整数 | 2 |
SocketConnectPort | Socket服务端口,用于建立会话。仅用于 initiator | 正整数 | - |
SocketConnectHost | 连接主机.仅用于 initiator | x.x.x.x格式IP地址或域名 | - |
SocketConnectPort<n> | 一组备用Socket端口,用于连接会话的故障转移,n是正整数。SocketConnectPort1,SocketConnectPort2 ... 必须是连续的,并有一个与之相匹配的数组SocketConnectHost<n> | 正整数 | - |
SocketConnectHost<n> | 一组备用Socket服务主机,用于连接会话的故障转移,n是正整数。SocketConnectHost1, SocketConnectHost2... 必须是连续的,并有一个与之相匹配的数组SocketConnectPort<n> | x.x.x.x格式IP地址或域名 | - |
SocketNodelay | 连接是否禁用Nagle算法。在[DEFAULT]配置节点定义。 | Y | Y |
N |
注:Nagle算法的目的是避免TCP发送大量的小数据包。TCP在接收到前一个小段的ACK消息之前,一直保存小数据包。然而Nagle算法和TCP的延迟确认策略间的交互会因一段暂时性的“死锁”而使应用程序产生严重的性能下降。
2) acceptor
设置 | 描述 | 有效值 | 默认 |
SocketAcceptPort | 监听接入连接Socket端口。仅用于acceptor | 正整数,有效的、开放的套接字端口 | - |
SocketAcceptHost | 监听接入连接的Socket服务的主机。如果不提供,acceptor将监听所有网络端口(0.0.0.0) | 有效的x.x.x.x格式IP地址 | 0.0.0.0 |
SocketNodelay | 连接是否禁用Nagle算法。在[DEFAULT]配置节点定义。 | Y | Y |
N |
3) Storage
设置 | 描述 | 有效值 | 默认 |
PersistMessages | 如果设置为N,被不会保存消息。这样将迫使quickfix总是发送GapFills,而不是重新发送消息。如果你知道你永远不需要重新发送消息,使用此配置。有用的市场数据流。 | Y | Y |
N |
4) File Storage
设置 | 描述 | 有效值 | 默认 |
FileStorePath | 存储序列号和消息的文件目录。 | 有效的文件存储目录,必须有写入权限。 | - |
5) Logging
设置 | 描述 | 有效值 | 默认 |
FileLogPath | 存储日志的目录。 | 有效的文件存储目录,必须有写入权限。 | - |
6) 配置文件的样例
(1) Initiator 配置文件的样例
只能用一个[DEFAULT]节点,可以有多个[SESSION]节点,多个[SESSION]节点是定义多个会话。
#
定义会话的默认配置(
default节点,对于全部会话有效,当然允许
SESSIION
节点重写)
[DEFAULT]
FileStorePath=store
FileLogPath=log
ConnectionType=initiator
ReconnectInterval=60
SenderCompID=TW
# session
定义
[SESSION]
# FileStorePath,FileLogPath,ConnectionType,
# ReconnectInterval and SenderCompID
等配置延用
default
的配置
BeginString=FIX.4.1
TargetCompID=ARCA
StartTime=12:30:00
EndTime=23:30:00
HeartBtInt=20
SocketConnectPort=9823
SocketConnectHost=123.123.123.123
DataDictionary=somewhere/FIX41.xml
[SESSION]
BeginString=FIX.4.0
TargetCompID=ISLD
StartTime=12:00:00
EndTime=23:00:00
HeartBtInt=30
SocketConnectPort=8323
SocketConnectHost=23.23.23.23
DataDictionary=somewhere/FIX40.xml
[SESSION]
BeginString=FIX.4.2
TargetCompID=INCA
StartTime=12:30:00
EndTime=21:30:00
#
自定义
ReconnectInterval
时间间隔值,不用
default
配置节点的配置,仅本会话有效
ReconnectInterval=30
HeartBtInt=30
SocketConnectPort=6523
SocketConnectHost=3.3.3.3
# (
可选
)
连接端口及连接服务主机列表
,
用于故障恢复时自动切换
SocketConnectPort1=8392
SocketConnectHost1=8.8.8.8
SocketConnectPort2=2932
SocketConnectHost2=12.12.12.12
DataDictionary=somewhere/FIX42.xml
(2) Acceptor 配置文件的样例
#
定义会话的默认配置(
default节点)
[DEFAULT]
FileStorePath=store
FileLogPath=log
ConnectionType=acceptor
ReconnectInterval=
60
SenderCompID=ARCA
# session definition
[SESSION]
# FileStorePath,FileLogPath,ConnectionType,
# ReconnectInterval and SenderCompID
等配置延用
default
的配置
BeginString=FIX.
4.1
TargetCompID=TW
StartTime=
12:
30:
00
EndTime=
23:
30:
00
HeartBtInt=
20
SocketAcceptPort=
9823
DataDictionary=somewhere/FIX41.xml
[SESSION]
BeginString=FIX.
4.0
TargetCompID=TW
StartTime=
12:
00:
00
EndTime=
23:
00:
00
HeartBtInt=
30
SocketAcceptPort=
8323
DataDictionary=somewhere/FIX40.xml
[SESSION]
BeginString=FIX.
4.2
TargetCompID=TW
StartTime=
12:
30:
00
EndTime=
21:
30:
00
#
自定义
ReconnectInterval
时间间隔值,不用
default
配置节点的配置,仅本会话有效
ReconnectInterval=
30
HeartBtInt=
30
SocketAcceptPort=
6523
# (
可选
)
仅监听指定主机的连接请求
SocketAcceptHost=
127.0.
0.1
DataDictionary=somewhere/FIX42.xml