畜牧兽医大数据应用与管理 第5部分：共享交换技术要求DB50-T 1096.5-2021

ICS65.020.30CCSB40

DB50重 庆 市 地 方 标 准DB50/T1096.5—202152021-03-30发布 2021-07-01实施重庆市市场监督管理局 发布DB50/T1096.5DB50/T1096.5—2021II前  言本文件按照GB/T1.1—20201本文件是DB50/T1096的第5部分。DB50/T1096已发布了以下部分：第1部分：总则第2部分：元数据第3部分：信息分类与编码第4部分：数据接口第5部分：共享交换技术要求第6部分：信息资源目录第7部分：管理要求请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市农业农村委员会提出并归口。本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、广州中国科学院软件应用技术研究所。DB50/T1096.5DB50/T1096.5—2021PAGEPAGE4畜牧兽医大数据应用与管理5范围本文件规定了畜牧兽医行业的数据共享与数据交换的技术要求。本文件适用于畜牧兽医行业的数据共享与交换的具体实现。规范性引用文件（包括所有的修改单适用于本文件。GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T11457信息技术软件工程术语GB/T20014.1良好农业规范GB/T28167信息技术XML元数据交换（XMI）GB/T35295信息技术大数据术语GB/T38672信息技术大数据接口基本要求术语、定义和缩略语术语和定义下列术语和定义适用于本文件。3.1.1数据提供方dataprovider在数据共享与交换中提供数据的一方。3.1.2数据使用方datauser在数据共享与交换中接收并使用数据的一方。缩略语本文件中使用的缩略语如下：JSON：JS对象标记（JavaScriptObjectNotation）HTTP：超文本传输协议（HyperTextTransferProtocol）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）数据共享与交换要求数据共享要求数据共享应符合以下要求：a）数据共享以WEB服务方式提供，按照GB/T35295和GB/T38672的要求进行。b）数据共享服务的设计、封装、开发按照GB/T11457和GB/T20014.1的要求进行。数据交换方式数据交换按照GB/T7408和GB/T28167的要求进行，分为以下三个阶段：a）数据使用方通过HTTP向数据提供方发起数据交换请求；数据交换与内容格式数据交换的内容采用JSON作为数据交换的媒介,其格式应符合ECMAScript8.0的要求。JSON数据交换请求JSONaccessToken32位的Hash字符串；timestamp：接口使用方发出请求的客户端时间（采用东八区系统时间UTC/GMT+08:00）；c）totalNum：表示数据交换所携带的记录数量；d）data：为JSON数组，存放交换数据。A。JSON数据交换返回结果JSONerrorCode0；当数据交换失败时，该参数为自定义的错误代码；errorMessagesuccess：标志此次数据交换是否成功。成功为true，失败为false；data参数存放交换失败的数据。B和附录C。数据共享与交换安全dataMD5MD5MD5MD5D。附录A（资料性）数据交换请求JSON示例图A.1给出了数据交换请求JSON示例。http://{SERVER_IP}/{SYTSTEM_NAME}/?http://{SERVER_IP}/{SYTSTEM_NAME}/?accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001×tamp=20171109153905Content-Type:application/json{"totalNum":1,"data":[{"P_OPERATION":"ADD","OBJID":"5CFC5CABA549CA9DE050A8C0DD01357A","GSZCH":null,"JYXM_DETAIL":"畜禽肉类产品销售","ZTYT_DETAIL":"肉类销售点","SHXYM":"92440604MA4X4E4U5H","RCJDGLJG":"重庆市农业执法总队","FDDBR":"张XX","JYCS":"重庆市九龙坡区白市驿镇黄金桥二号"P_REGION_CODE":"440604","FZRQ":"2017-10-18","P_LAST_UPDATE_TIME":"2017-11-0915:09:15","PERMIT_STATUS":"NORMAL","ZS":"重庆市九龙坡区白市驿镇黄金桥二号","O_PERMIT_CODE":"\","RCJDGLRY":"由负责日常监督管理机构指派","YXKZ":"2022-10-17","FZJG":"440604000000","ZZJGDM":null,"XKZBH":"JY14406040114403","QFR":"王XX","FZJG_DETAIL":"重庆市农业执法总队","P_ID":"JY14406040114403","ZSZTXZBM":"440604","ZTYT":"1003","JYXM":"0102、0301",}]}图A.1数据交换请求JSON示例DB50/T1096.5—DB50/T1096.5—2021附录B（资料性）PAGEPAGE5数据交换成功返回JSON示例图B.1给出了数据交换成功返回JSON示例。{{"errorCode":"0","errorMessage":"","success":"true","data":[]}图B.1数据交换成功返回JSON示例DB50/T1096.5DB50/T1096.5—2021PAGEPAGE6附录C（资料性）数据交换失败返回JSON示例图C.1给出了数据交换失败返回JSON示例。{{"errorCode":"00000003","errorMessage":"JSON数据验证失败","success":"false","data":[{"P_ID":"JY14406040114403"},{"ZTYT":"40001001"}]}图C.1数据交换失败返回JSON示例DB50/T1096.5DB50/T1096.5—2021PAGEPAGE8附录D（资料性）MD5摘要JAVA实现示例图D.1给出了MD5摘要JAVA实现示例。importjava.io.File;importjava.io.File;importjava.io.FileInputStream;importjava.io.IOException;importjava.security.MessageDigest;publicclassMD5{staticcharhexdigits[]={'0','1','2','3','4','5','6','7','8','9','a','b','c','d','e','f'};/**对data生成MD5摘要@paramfile@returnMD5摘要码*/publicstaticStringgetMD5(Filefile){FileInputStreamfis=null;try{MessageDigestmd=MessageDigest.getInstance("MD5");fis=newFileInputStream(file);byte[]buffer=newbyte[2048];intlength=-1;while((length=fis.read(buffer))!=-1){md.update(buffer,0,length);}byte[]b=md.digest();returnbyteToHexString(b);}catch(Exceptionex){ex.printStackTrace();returnnull;}finally{try{fis.close();}catch(IOExceptionex){ex.printStackTrace();}}}/**把byte[]数组转换成十六进制字符串表示形式@paramtmp要转换的byte[]@return十六进制字符串表示形式*/privatestaticStringbyteToHexString(byte[]tmp){Strings;privatestaticStringbyteToHexString(byte[]tmp){Strings;charstr[]=newchar[16*2];intk=0;for(inti=0;i<16;i++){bytebyte0=tmp[i];s