Shibor数据接口用户手册

Shibor数据接口使用手册登入服务器:启动客户端程序，进入登入界面，输入用户名和密码，如下图1图1点击确定后，程序自动从互联网下载最新一天的数据并提示运作状态，如下图2.1, 如果登入的时间为当日11：30分之前，会出现如图2.2的提示。

图2.1 图2.2之后登入成功进入程序主界面。

数据下载进入程序主界面后自动进入数据下载页面，如下图3，通过下拉菜单选择所需下载的某年某月的数据图3注：如数据下载完成后提示“数据下载成功，但文件保存失败”，请查看程序安装目录下的save目录中的文件是否已被损坏，如果损坏请手动删除该文件，重新下载历史数据。

数据转换在主界面点击数据转换按钮，进入数据转换页面，如下图4图4输入所需转换的时间段，点击导出按钮，弹出转换结果后，在程序的安装路径下的convert目录中会生成转换后的文件。

（例如：程序的安装路径为C:\ShiborDataClient，那么生成的转换文件在C:\ShiborDataClient\convert\目录下）Imix数据解析说明iMIX消息传输示例1、iMIX消息分为消息头（Header）、消息体（Body）、消息尾（Trailer）三部分，消息头（Header）主要承载消息传输协议本身所需要的一些信息；消息体（Body）主要承载消息内容本身；消息尾（Trailer）主要负责检验等工作。

2、由于iMIX协议基于“FIX4.4”制定，目前还没有制定完成，所以我们暂时使用“FIX4.4”协议作为“iMIX1.0”协议，进行iMIX消息的传输示例。

2.1、为保证消息被正确传输，域“8、9、10、34、35、49、52、56”在“iMIX1.0”协议中为必需域，在消息头（Header）、消息尾（Trailer）中使用。

2.2、域“43、50、57、89、90、91、93、97、115、116、122、128、129、142、143、144、145、212、213、347、369、627、628、629、630”在iMIX协议中作为可选域，在消息头（Header）、消息尾（Trailer）中使用，来保证消息被正确、安全地在多方之间传输。

2.3、消息头（Header）中的MsgType域（域 35）被用来设定消息类型；其中， "0"、"1"、"2"、"3"、"4"、"5"、"A" 六种消息类型被用来作为 Admin消息，以保证消息通讯。

其他消息类型均为App消息。

4、API提供下列方法来得到消息头（Header）和消息尾（Trailer）：5、API67、设置group的方式与设置消息体（Body）的方式相似，并提供下列方法添加Group到一条消息中去：8、对于接收到的消息，可以提供下列两种方式分别从消息头（Header）、消息体（Body）、消息尾（Trailer）中取出具体的域和值(包括group)：一是根据消息中应包含的具体的域取解析实例：首先在工程中导入Imix的jar包（iMIXProtocol.jar），然后引入解析时所需的解析文件iMIX10.xml和MessageUtils.java，下面给出具体解析实例。

注：上述红色字体文件均可在“上海银行间同业拆放利率数据下载与转换工具”程序在本地安装的example目录中找到。

示例一：Shibor数据解析：public static void getShibor(){DefaultMessageFactory msgFactory = new DefaultMessageFactory();DataDictionary dd = null;DBResultDataSet quoteData = new DBResultDataSet();try {dd = new DataDictionary("iMIX10.xml");Message msg = (Message)MessageUtils.parse(msgFactory, dd, inImaxString); // inImaxString 为传入需要解析的数据TransactTime tt1 = new TransactTime();NoMDTypes nomdtypes1 = new NoMDTypes();//------------------shibor-------------------------------------- MDType mdtype1 = new MDType();NoRelatedSym norelatedsym1 = new NoRelatedSym();SecurityID securityid1 = new SecurityID();SecurityIDSource securityidsource1 = new SecurityIDSource();MDEntryType mdentrytype1 = new MDEntryType();MDEntryPx mdentrypx1 =new MDEntryPx();NoMDEntries nomdentries1 = new NoMDEntries();msg.getField(tt1);String tmp = DataUtil.date2StringDate(tt1.getValue());//msg.getGroup(1, nomdtypes1);nomdtypes1.get(mdtype1);int colSize = nomdtypes1.get(new imix.field.NoRelatedSym()).getValue();String[] shiborStr = new String[colSize+1];shiborStr[0] = tmp;for(int i = 1; i <= nomdtypes1.get(new imix.field.NoRelatedSym()).getValue(); i++){nomdtypes1.getGroup(i, norelatedsym1);norelatedsym1.get(securityid1);securityid1.getValue();//termCodenorelatedsym1.get(securityidsource1);for(int j = 1; j <= norelatedsym1.get(new imix.field.NoMDEntries()).getValue(); j++){norelatedsym1.getGroup(j, nomdentries1);nomdentries1.get(mdentrytype1);nomdentries1.get(mdentrypx1);shiborStr[i] = new BigDecimal(mdentrypx1.getValue()).setScale(4,BigDecimal.ROUND_HALF_UP ).toString();//}}quoteData.addRow(shiborStr);System.out.println("print: Shibor");for(int y=0;y<shiborStr.length;y++){System.out.print (shiborStr[y]+" ");}System.out.println();} catch (Exception e1) {e1.printStackTrace();}}示例二：银行报价解析：public static void getQuote(){DefaultMessageFactory msgFactory = new DefaultMessageFactory();DataDictionary dd = null;DBResultDataSet quoteData = new DBResultDataSet();try {dd = new DataDictionary("iMIX10.xml");Message msg = (Message)MessageUtils.parse(msgFactory, dd, inImaxString); // inImaxString 为传入需要解析的数据TransactTime tt1 = new TransactTime();SecurityID securityid1 = new SecurityID();SecurityIDSource securityidsource1 = new SecurityIDSource();NoQuoteSets noquotesets1 = new NoQuoteSets();QuoteSetID quotesetid1 = new QuoteSetID();NoPartyIDs nopartyids1 = new NoPartyIDs();PartyID partyid1 = new PartyID();NoPartySubIDs nopartysubids1 = new NoPartySubIDs();PartySubID partysubid1 = new PartySubID();PartySubIDType partysubidtype1 = new PartySubIDType();NoQuoteEntries noquoteentries1 = new NoQuoteEntries();securityid1 = new SecurityID();securityidsource1 = new SecurityIDSource();NoLegs nolegs3 = new NoLegs();LegSecurityID legsecurityid1 = new LegSecurityID();LegSide legside1 = new LegSide();LegPrice legprice1 = new LegPrice();msg.getField(tt1);System.out.println("print:Quote");for(int i = 1; i <= msg.getField(new imix.field.NoQuoteSets()).getValue(); i++){msg.getGroup(i, noquotesets1);int colSize = noquotesets1.get(new imix.field.NoQuoteEntries()).getValue();String[] shiborStr = new String[colSize*2+2];shiborStr[0] = DataUtil.date2StringDate(tt1.getValue());//noquotesets1.get(quotesetid1);for(int k = 1; k <= noquotesets1.get(new imix.field.NoPartyIDs()).getValue(); k++){noquotesets1.getGroup(k, nopartyids1);nopartyids1.get(partyid1);for(int j = 1; j <= nopartyids1.get(new imix.field.NoPartySubIDs()).getValue(); j++){nopartyids1.getGroup(j, nopartysubids1);nopartysubids1.get(partysubid1);shiborStr[1] = partysubid1.getValue();//nopartysubids1.get(partysubidtype1);}}for(int n = 1; n <= noquotesets1.get(new imix.field.NoQuoteEntries()).getValue(); n++){noquotesets1.getGroup(n, noquoteentries1);noquoteentries1.get(securityid1);noquoteentries1.get(securityidsource1);for(int m = 1; m <= noquoteentries1.get(new imix.field.NoLegs()).getValue(); m++){noquoteentries1.getGroup(m, nolegs3);nolegs3.get(legsecurityid1);nolegs3.get(legside1);nolegs3.get(legprice1);shiborStr[n*2+m-1] = new BigDecimal(legprice1.getValue()).setScale(4,BigDecimal.ROUND_HALF_UP) .toString();//}}quoteData.addRow(shiborStr);for(int y=0;y<shiborStr.length;y++){System.out.print (shiborStr[y]+" ");}System.out.println();}System.out.println();System.out.println();} catch (Exception e1) {e1.printStackTrace();}}示例三：Shibor均值解析：public static void getTendency(){DefaultMessageFactory msgFactory = new DefaultMessageFactory();DataDictionary dd = null;DBResultDataSet quoteData = new DBResultDataSet();try {dd = new DataDictionary("iMIX10.xml");Message msg = (Message)MessageUtils.parse(msgFactory, dd, inImaxString); // inImaxString 为传入需要解析的数据TransactTime tt1 = new TransactTime();NoMDTypes nomdtypes1 = new NoMDTypes();//------------------shibor--------------------------------------MDType mdtype1 = new MDType();NoRelatedSym norelatedsym1 = new NoRelatedSym();SecurityID securityid1 = new SecurityID();SecurityIDSource securityidsource1 = new SecurityIDSource();MDEntryType mdentrytype1 = new MDEntryType();MDEntryPx mdentrypx1 =new MDEntryPx();NoMDEntries nomdentries1 = new NoMDEntries();nomdtypes1 = new NoMDTypes();mdtype1 = new MDType();norelatedsym1 = new NoRelatedSym();securityid1 = new SecurityID();securityidsource1 = new SecurityIDSource();mdentrytype1 = new MDEntryType();mdentrypx1 =new MDEntryPx();nomdentries1 = new NoMDEntries();msg.getGroup(1, nomdtypes1);int colSize = nomdtypes1.get(new imix.field.NoRelatedSym()).getValue();String[] shiborStr = new String[colSize*3+1];shiborStr[0] = DataUtil.date2StringDate(tt1.getValue());//for(int b=1;b<=3;b++){msg.getGroup(b, nomdtypes1);nomdtypes1.get(mdtype1);// System.out.println(mdtype1.getValue());for(int i = 1; i <= nomdtypes1.get(new imix.field.NoRelatedSym()).getValue(); i++){nomdtypes1.getGroup(i, norelatedsym1);norelatedsym1.get(securityid1);norelatedsym1.get(securityidsource1);//System.out.println(securityidsource1.getValue());//for(int j = 1; j <= norelatedsym1.get(new imix.field.NoMDEntries()).getValue(); j++){norelatedsym1.getGroup(j, nomdentries1);nomdentries1.get(mdentrytype1);//System.out.println(mdentrytype1.getValue());//nomdentries1.get(mdentrypx1);shiborStr[(i-1)*3+b] = new BigDecimal(mdentrypx1.getValue()).setScale(4,BigDecimal.ROUND_HALF_UP ).toString();//}}}quoteData.addRow(shiborStr);System.out.println();System.out.println();System.out.println("print: ShiborTendency");for(int y=0;y<shiborStr.length;y++){System.out.print (shiborStr[y]+" ");}System.out.println();//-----------------------------------------------------------------------------------} catch (Exception e1) {e1.printStackTrace();}}。