QuickFIX/N入门：三、 如何配置QuickFIX/N
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=storeFileLogPath=logConnectionType=initiatorReconnectInterval=60SenderCompID=TW # session定义
[SESSION]# FileStorePath,FileLogPath,ConnectionType, # ReconnectInterval and SenderCompID等配置延用default的配置
BeginString=FIX.4.1TargetCompID=ARCAStartTime=12:30:00EndTime=23:30:00HeartBtInt=20SocketConnectPort=9823SocketConnectHost=123.123.123.123DataDictionary=somewhere/FIX41.xml [SESSION]BeginString=FIX.4.0TargetCompID=ISLDStartTime=12:00:00EndTime=23:00:00HeartBtInt=30SocketConnectPort=8323SocketConnectHost=23.23.23.23DataDictionary=somewhere/FIX40.xml [SESSION]BeginString=FIX.4.2TargetCompID=INCAStartTime=12:30:00EndTime=21:30:00#自定义ReconnectInterval时间间隔值，不用default配置节点的配置，仅本会话有效
ReconnectInterval=30HeartBtInt=30SocketConnectPort=6523SocketConnectHost=3.3.3.3# (可选)连接端口及连接服务主机列表,用于故障恢复时自动切换
SocketConnectPort1=8392SocketConnectHost1=8.8.8.8SocketConnectPort2=2932SocketConnectHost2=12.12.12.12DataDictionary=somewhere/FIX42.xml
(2) Acceptor 配置文件的样例
#定义会话的默认配置（default节点）
[DEFAULT]FileStorePath=storeFileLogPath=logConnectionType=acceptorReconnectInterval=60
SenderCompID=ARCA # session definition[SESSION]# FileStorePath,FileLogPath,ConnectionType, # ReconnectInterval and SenderCompID等配置延用default的配置
BeginString=FIX.4.1
TargetCompID=TWStartTime=12:30:00
EndTime=23:30:00
HeartBtInt=20
SocketAcceptPort=9823
DataDictionary=somewhere/FIX41.xml [SESSION]BeginString=FIX.4.0
TargetCompID=TWStartTime=12:00:00
EndTime=23:00:00
HeartBtInt=30
SocketAcceptPort=8323
DataDictionary=somewhere/FIX40.xml [SESSION]BeginString=FIX.4.2
TargetCompID=TWStartTime=12:30:00
EndTime=21:30:00
#自定义ReconnectInterval时间间隔值，不用default配置节点的配置，仅本会话有效
ReconnectInterval=30
HeartBtInt=30
SocketAcceptPort=6523
# (可选)仅监听指定主机的连接请求
SocketAcceptHost=127.0.0.1
DataDictionary=somewhere/FIX42.xml