在本章节中:
概要
Parasoft FIX 消息侦听器允许虚拟资产通过 FIX(财务信息交换)接收和响应消息。支持 4.0 - 5.0 SP2 版本的 FIX。
要求
- 以下 FIX 消息格式之一:4.0、4.1、4.2、4.4、5.0 或 5.0 SP2。可以从 Parasoft Marketplace下载一种格式。
- SOAtest 消息客户端工具中,FIX 传输支持需要 FIX 传输。
安装指南
可以从 UI 或命令行安装该工具。
UI 安装指南
- 选择 Parasoft > Preferences ,然后单击 System Properties 类别。
- 单击 Add JARs ,并选择 FIXListener.jar 文件。一旦此 jar 文件添加到 SOAtest/Virtualize 类路径中,则将加载所有必需的依赖项。
- 重复此过程以安装正在使用的任何修复格式。
- 重启 SOAtest/Virtualize。
命令行安装指南
将 FIXListener.jar 文件添加到 localsettings 属性文件中的 system.properties.classpath
属性。例如:
system.properties.classpath=<path to jar>/FIXListener.jar
一旦路径完成更改,将加载所有必需的依赖项。
使用说明
安装了 FIX 消息侦听器后,FIX 将在虚拟资产配置面板的 Transports> Custom 选项卡中可用。双击虚拟资产的 Virtualize Server 节点以打开该面板。
如果有多个自定义侦听器可用,则可以从 Select Implementation 下拉菜单选择要使用的:
配置
可以配置以下设置。
设置选项
Acceptor settings path 或 Socket accept port 都是必需的。Logging level 是可选项。
Acceptor settings path | 指定 cfg 属性文件的绝对路径,该文件定义了虚拟服务器中的 FIX 引擎应该如何接受来自客户机的连接。可以查看下面的 示例接受器 cfg 文件 有关属性的详细定义,请参阅以下文档: https://www.quickfixj.org/usermanual/1.5.3/usage/configuration.html 需要接收器设置路径或套接字接受端口。 |
---|---|
Socket accept port | 如果指定,FIX 引擎将接受此端口上的连接,而其他接收器属性值将假定默认值。特别是,该选项将接受任何 |
Logging level | 日志级别可以输入 0 (最详细)、 1 或 2 (最简洁)。这是可选项。 |
示例接收器 cfg 文件
下面是一个示例接收器 cfg 文件。
[default] FileStorePath=/tmp/fix/virt/acceptor FileLogPath=/tmp/fix/logs ConnectionType=acceptor StartTime=00:00:00 EndTime=00:00:00 HeartBtInt=30 ReconnectInterval=60 SenderCompID=VIRT TargetCompID=CLIENT UseDataDictionary=Y ValidateIncomingMessage=N RejectInvalidMessage=N ResetOnLogon=Y [session] BeginString=FIX.4.4 SocketAcceptPort=9889 DataDictionary=FIX44.xml
录制选项
必须启用 Recording? 选项,以便所有其他选项都适用。如果启用了录制,则需要 Proxy initiator settings path 和 TargetCompID 选项。
Recording? | 启用/禁用录制输入 如果启用了录制功能,则不使用响应器,而 Virtualize 将连接到另一个 FIX 引擎来响应。 |
---|---|
Proxy initiator settings path | 指定 cfg 属性文件的绝对路径,该文件定义了 Virtualize 应该如何启动到 FIX 引擎的连接。 下面提供了一个 示例启动程序 cfg 文件。有关属性的详细定义,请参阅以下文档: https://www.quickfixj.org/usermanual/1.5.3/usage/configuration.html |
TargetCompID | 该 target comp ID 用于标识 FIX 客户机应用程序。 |
Proxy response timeout | Virtualize 等待请求响应的毫秒数。默认为 30000 。 |
Number of responses to wait for | 该请求预计将触发的响应的数量,以及 Virtualize 应该等待的响应数量。默认为 1 。 |
Record and return all responses | 如果 Number of responses to wait for 选项中指定的值大于 1 ,则此选项确定是否应该由 Virtualize 返回所有响应。输入 y 表示 yes。输入 n 表示 no,并且只返回收到的最后一个响应。默认为 n 。 |
Traffic file path | 文件的绝对路径,该文件应该记录在实际客户机和 FIX 引擎之间传递的通讯报文。 |
示例启动程序 cfg 文件
下面是一个示例启动程序 cfg 文件。在 FIX 请求消息中, SenderCompID
和 TargetCompID
必须匹配启动程序 cfg 文件中相应的值。
[default] #FileStorePath=/tmp/fix/virt/initiator #FileLogPath=/tmp/fix/logs ConnectionType=initiator StartTime=00:00:00 EndTime=00:00:00 HeartBtInt=30 ReconnectInterval=60 SenderCompID=CLIENT TargetCompID=VIRT UseDataDictionary=Y #ValidateIncomingMessage=N #RejectInvalidMessage=N SocketConnectHost=localhost ResetOnLogon=Y [session] BeginString=FIX.4.4 SocketConnectPort=9889 DataDictionary=FIX44.xml
第三方内容
此扩展包括来自第三方的资源项,如下:
- QuickFIX/J (QuickFIX License)
- Apache Mina (Apache License)
- SLF4J (MIT License)
更多的许可详情可在该插件的 licenses 文件夹中获得。