QuickFix/J (3)：自定义字段

自定义Fields

我们在做FIX开发的时候，经常遇到原生的FIX标签并不能满足我们的业务需求；这个时候就需要涉及到自定义的“字段”，“类”，“集合”。

非安全性的自定义Fields

message.setField(new DoubleField(6123), "value");
DoubleField field = message.getField(new DoubleField(6123));

推荐的自定义Fields方法

 上面的自定义方法在团队开发中，经常会引起不必要的麻烦（标签被重用，标签难以理解等问题。）
 FIXJ官网推荐我们使用如下方法自定义Field
 // RemiteNOField.java
 import quickfix.StringField;
 public class RemiteNOField extends StringField
 { 
     public RemiteNOField () { super(C); }
     public RemiteNOField (String data) { super(RemiteNOField , data); 
}}

当然自定义完字段以后！需要在FIX4.4.xml文件中添加相应的Field描述。

 <fields>
      <field number="1" name="RemiteNOField" type="String" />
      ...
      <field number="4" name="AdvSide" type="CHAR">
       <value enum="B" description="BUY" />
       <value enum="S" description="SELL" />
       <value enum="X" description="CROSS" />
       <value enum="T" description="TRADE" />
     </field>

自定义Message

FIX中的Message相当我们理解的JAVA类。你可以自定义Message来描述一个对象。然后再XML文件中添加相应的Message描述。
注意：记得在35标签的位置添加相应的枚举
<value enum="Z6666" description="OrdersAfterSomeIDRequest"/>

JAVA类代码

import quickfix.Message;
import quickfix.field.OrdStatus;
import quickfix.field.OrderID;
import quickfix.field.SecurityType;
import quickfix.field.StrikeCurrency;
import quickfix.field.Symbol;
import quickfix.field.TradeRequestID;
import quickfix.field.TradeRequestType;

import com.okcoin.okfix.okserver.response.future.PageNO;

/** * @ClassName: OrdersRequest * @Description:获取指定ID的订单号 * */
public class OrdersAfterSomeIDRequest extends Message {

    private static final long serialVersionUID = 7922839466982400795L;
    public static final String MSGTYPE = "Z6666";

    public OrdersAfterSomeIDRequest() {
        getHeader().setField(new quickfix.field.MsgType("Z6666"));
    }

    public void set(Symbol field) { // 55
        setField(field);
    }

    public void set(OrderID field) { // 37
        setField(field);
    }

    public void set(OrdStatus field) { // 39
        setField(field);
    }

    public void set(TradeRequestID field) { // 568
        setField(field);
    }

    public void set(TradeRequestType field) { // 569
        setField(field);
    }

    public void set(PageNO field) { // 8214 页码
        setField(field);
    }

    public void set(StrikeCurrency field) { // 947
        setField(field);
    }
    public void set(SecurityType field) { // 167
        setField(field);
    }

}

XML描述

  <message name="TradeOrdersAfterOneID" msgtype="Z6666" msgcat="app">
      <field name="Symbol" required="N"/>
      <field name="OrderID" required="N"/>
      <field name="OrdStatus" required="N"/>
      <field name="TradeRequestID" required="N"/>
      <field name="TradeRequestType" required="N"/>
      <field name="PageNO" required="N"/>
      <field name="StrikeCurrency" required="N"/>
      <field name="SecurityType" required="N"/>
    </message>

自定义Group

Group本质上是一个集合，其用来描述相同的属性的一类集合。qFixJ 充分的体现了其灵活性。
注意！在fields标签中添加相应的Field

Group,JAVA代码

/** * @ClassName: FuturePositionsResponse * @Description: 持仓信息 * */
public class FuturePositionsResponse extends Message {

    private static final long serialVersionUID = 1L;

    private static final String MSGTYPE = "Z3333";

    public FuturePositionsResponse() {
        getHeader().setField(new quickfix.field.MsgType(MSGTYPE));
    }

    public void set(Currency field) { // 货币类型
        setField(field);
    }

    public void set(Symbol field) { // 标志
        setField(field);
    }

    /** * @ClassName: NoUserPostion * @Description: 用户信息持仓信息 </group> */
    public static class NoUserPostion extends Group {

        private static final long serialVersionUID = 6684058490806701199L;

        public NoUserPostion() {
            super(8303, 55, new int[] { 55,8213, 6, 38, 8212, 44, 99, 54, 8001, 8203,
                    898, 8207, 8208,8210,8209});
        }

        public void set(ContractID field) { // 期货合约ID
            setField(field);
        }
        public void set(AvgPx field) {// 开仓均价
            setField(field);
        }

        public void set(OrderQty field) { // 持仓量
            setField(field);
        }

        public void set(ContractName field) { // 合约类型 contract_name LTC0108
            setField(field);
        }
        public void set(Price field) {// 开仓价
            setField(field);
        }
        public void set(StopPx field) {// 强平价格
            setField(field);
        }

        public void set(Side field) { // position: 开多,开空
            setField(field);
        }
        public void set(Balance field) {// 合约账户余额
            setField(field);
        }

        public void set(PositionRealProfit field) { // 已实现盈亏
            setField(field);
        }
        public void set(MarginRatio field) { // position: 保证率（杠杆倍数）
            setField(field);
        }
        public void set(FrozenAmt field) {// 当前合约冻结保证金
            setField(field);
        }
        public void set(MarginCash field) { // position: 保证金
            setField(field);
        }

        public void set(PositionType field) { // 仓位Type
            setField(field);
        }

        public void set(PositionsID field) { // 仓位ID
            setField(field);
        }
        public void set(Symbol field) { // 合约类型
            setField(field);
        }
        public void set(Eveningup field){ //可平仓量
            setField(field);
        }
    }

}

GroupXML配置

 <message name="FuturePositionsResponse" msgtype="Z3333" msgcat="app">
      <field name="Currency" required="N"/>
      <field name="Symbol" required="N"/>

      <group name="NoUserPostion" required="N">
        <field name="Symbol" required="Y"/>
        <field name="ContractID" required="N"/>
        <field name="AvgPx" required="N"/>
        <field name="OrderQty" required="N"/>
        <field name="ContractName" required="N"/>
        <field name="Price" required="N"/>
        <field name="StopPx" required="N"/>
        <field name="Side" required="N"/>
        <field name="Balance" required="N"/>
        <field name="PositionRealProfit" required="N"/>
        <field name="MarginRatio" required="N"/>
        <field name="FrozenAmt" required="N"/>
        <field name="MarginCash" required="N"/>
        <field name="PositionType" required="N"/>
        <field name="PositionsID" required="N"/>
        <field name="Eveningup" required="N"/>
      </group>
    </message>