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

ICS65.020.30

CCSB40

DB50

重庆市地方标准

DB50/T1096.5—2021

畜牧兽医大数据应用与管理

第5部分：共享交换技术要求

2021-03-30发布2021-07-01实施

重庆市市场监督管理局发布

DB50/T1096.5—2021

前  言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

本文件是DB50/T1096的第5部分。DB50/T1096已发布了以下部分：

----第1部分：总则

----第2部分：元数据

----第3部分：信息分类与编码

----第4部分：数据接口

----第5部分：共享交换技术要求

----第6部分：信息资源目录

----第7部分：管理要求

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由重庆市农业农村委员会提出并归口。

本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、

广州中国科学院软件应用技术研究所。

本文件主要起草人：夏云霓、古平、李引、李晓波、陈红跃、樊莉、张科、何道领、朱燕、黄文明、

陈雷。

I

DB50/T1096.5—2021

畜牧兽医大数据应用与管理

第5部分：共享交换技术要求

1范围

本文件规定了畜牧兽医行业的数据共享与数据交换的技术要求。

本文件适用于畜牧兽医行业的数据共享与交换的具体实现。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB/T11457信息技术软件工程术语

GB/T20014.1良好农业规范

GB/T28167信息技术XML元数据交换（XMI）

GB/T35295信息技术大数据术语

GB/T38672信息技术大数据接口基本要求

3术语、定义和缩略语

3.1术语和定义

下列术语和定义适用于本文件。

3.1.1

数据提供方dataprovider

在数据共享与交换中提供数据的一方。

3.1.2

数据使用方datauser

在数据共享与交换中接收并使用数据的一方。

3.2缩略语

本文件中使用的缩略语如下：

JSON：JS对象标记（JavaScriptObjectNotation）

HTTP：超文本传输协议（HyperTextTransferProtocol）

1

DB50/T1096.5—2021

MD5：消息摘要算法第五版（Message-DigestAlgorithm5）

4数据共享与交换要求

4.1数据共享要求

数据共享应符合以下要求：

a）数据共享以WEB服务方式提供，按照GB/T35295和GB/T38672的要求进行。

b）数据共享服务的设计、封装、开发按照GB/T11457和GB/T20014.1的要求进行。

4.2数据交换方式

数据交换按照GB/T7408和GB/T28167的要求进行，分为以下三个阶段：

a）数据使用方通过HTTP向数据提供方发起数据交换请求；

b）数据提供方收到数据交换请求，解析数据报文，进行校验后对合法数据进行发送，非法数据则

发送错误代码；

c）数据使用方接收数据并存储，返回一个数据报文，数据提供方根据返回数据报文判断本次数据

交换是否成功。

4.3数据交换与内容格式

数据交换的内容采用JSON作为数据交换的媒介,其格式应符合ECMAScript8.0的要求。

4.4数据交换请求JSON格式

4.4.1数据交换请求JSON应包含以下四个核心参数：

a）accessToken：调用接口的令牌。登陆成功后，返回一个32位的Hash字符串；

b）timestamp：接口使用方发出请求的客户端时间（采用东八区系统时间UTC/GMT+08:00）；

c）totalNum：表示数据交换所携带的记录数量；

d）data：为JSON数组，存放交换数据。

4.4.2数据交换请求示例见附录A。

4.5数据交换返回JSON格式

4.5.1数据交换返回结果JSON应包含以下四个核心参数：

a）errorCode：为错误代码，表明数据交换失败的原因。当数据交换成功时，该参数为0；当数

据交换失败时，该参数为自定义的错误代码；

b）errorMessage：为返回结果信息，描述数据交换出错的具体情况。当数据交换成功时，该参数

为空值；当数据交换失败时，该参数为自定义的错误原因；

c）success：标志此次数据交换是否成功。成功为true，失败为false；

d）data：当数据交换成功时，则data参数为空值；当数据交换失败时，data参数存放交换失败的

数据。

4.5.2数据交换返回示例见附录B和附录C。

4.6数据共享与交换安全

2

DB50/T1096.5—2021

4.6.1数据交换请求及数据交换返回中的data部分，均使用MD5加密方式进行加密。在数据交换时，

数据发送方在传输数据的同时提供MD5码，数据接收方接收后使用MD5码对接收的数据进行验证。

4.6.2使用MD5加密的实现示例见附录D。

3

DB50/T1096.5—2021

附录A

（资料性）

数据交换请求JSON示例

图A.1给出了数据交换请求JSON示例。

http://{SERVER_IP}/{SYTSTEM_NAME}/?

accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001×tamp=201711091

53905

Content-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示例

4

DB50/T1096.5—2021

附录B

（资料性）

数据交换成功返回JSON示例

图B.1给出了数据交换成功返回JSON示例。

{

"errorCode":"0",

"errorMessage":"",

"success":"true",

"data":[]

}

图B.1数据交换成功返回JSON示例

5

DB50/T1096.5—2021

附录C

（资料性）

数据交换失败返回JSON示例

图C.1给出了数据交换失败返回JSON示例。

{

"errorCode":"00000003",

"errorMessage":"JSON数据验证失败",

"success":"false",

"data":[{"P_ID":"JY14406040114403"},{"ZTYT":"40001001"}]

}

图C.1数据交换失败返回JSON示例

6

DB50/T1096.5—2021

附录D

（资料性）

MD5摘要JAVA实现示例

图D.1给出了MD5摘要JAVA实现示例。

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十六进制字符串表示形式

*/