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

ICS65.020.30CCS B 40DB50重庆市地方标准DB 50/T 1096.52021畜牧兽医大数据应用与管理第 5 部分：共享交换技术要求2021 - 03 - 30 发布2021 - 07 - 01 实施重庆市市场监督管理局发 布DB50/T 1096.52021I前言本文件按照 GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则 的规定起草。本文件是DB50/T 1096的第5部分。DB50/T 1096已发布了以下部分：-第 1 部分：总则-第 2 部分：元数据-第 3 部分：信息分类与编码-第 4 部分：数据接口-第 5 部分：共享交换技术要求-第 6 部分：信息资源目录-第 7 部分：管理要求请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市农业农村委员会提出并归口。本文件起草单位：重庆市畜牧技术推广总站、重庆大学、广州中科易德科技有限公司、西南大学、广州中国科学院软件应用技术研究所。本文件主要起草人：夏云霓、古平、李引、李晓波、陈红跃、樊莉、张科、何道领、朱燕、黄文明、陈雷。DB50/T 1096.520211畜牧兽医大数据应用与管理第 5 部分：共享交换技术要求1范围本文件规定了畜牧兽医行业的数据共享与数据交换的技术要求。本文件适用于畜牧兽医行业的数据共享与交换的具体实现。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件，仅该日期对应的版本适用于本文件。不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法GB/T 11457 信息技术 软件工程术语GB/T 20014.1 良好农业规范GB/T 28167 信息技术 XML元数据交换（XMI）GB/T 35295 信息技术 大数据 术语GB/T 38672 信息技术 大数据 接口基本要求3术语、定义和缩略语3.1术语和定义下列术语和定义适用于本文件。3.1.1数据提供方data provider在数据共享与交换中提供数据的一方。3.1.2数据使用方data user在数据共享与交换中接收并使用数据的一方。3.2缩略语本文件中使用的缩略语如下：JSON：JS 对象标记（JavaScript Object Notation）HTTP：超文本传输协议（HyperText Transfer Protocol）DB50/T 1096.520212MD5：消息摘要算法第五版（Message-Digest Algorithm 5）4数据共享与交换要求4.1数据共享要求数据共享应符合以下要求：a） 数据共享以 WEB 服务方式提供，按照 GB/T 35295 和 GB/T 38672 的要求进行。b） 数据共享服务的设计、封装、开发按照 GB/T 11457 和 GB/T 20014.1 的要求进行。4.2数据交换方式数据交换按照 GB/T 7408 和 GB/T 28167 的要求进行，分为以下三个阶段：a） 数据使用方通过 HTTP 向数据提供方发起数据交换请求；b） 数据提供方收到数据交换请求，解析数据报文，进行校验后对合法数据进行发送，非法数据则发送错误代码；c） 数据使用方接收数据并存储，返回一个数据报文，数据提供方根据返回数据报文判断本次数据交换是否成功。4.3数据交换与内容格式数据交换的内容采用 JSON 作为数据交换的媒介, 其格式应符合 ECMAScript 8.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数据共享与交换安全DB50/T 1096.5202134.6.1数据交换请求及数据交换返回中的 data 部分， 均使用 MD5 加密方式进行加密。 在数据交换时，数据发送方在传输数据的同时提供 MD5 码，数据接收方接收后使用 MD5 码对接收的数据进行验证。4.6.2使用 MD5 加密的实现示例见附录 D。DB50/T 1096.520214附录 A（资料性）数据交换请求 JSON 示例图A.1给出了数据交换请求 JSON 示例。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-09 15: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/T 1096.520215附录 B（资料性）数据交换成功返回 JSON 示例图B.1给出了数据交换成功返回 JSON 示例。errorCode: 0,errorMessage: ,success: true,data: 图B.1数据交换成功返回 JSON 示例DB50/T 1096.520216附录 C（资料性）数据交换失败返回 JSON 示例图C.1给出了数据交换失败返回 JSON 示例。errorCode: 00000003,errorMessage: JSON数据验证失败,success: false,data: P_ID:JY14406040114403, ZTYT:40001001图C.1数据交换失败返回 JSON 示例DB50/T 1096.520217附录 D（资料性）MD5 摘要 JAVA 实现示例图D.1给出了MD5 摘要 JAVA 实现示例。import java.io.File;import java.io.FileInputStream;import java.io.IOException;import java.security.MessageDigest;public class MD5 static char hexdigits = 0, 1, 2, 3, 4, 5, 6, 7, 8,9, a, b, c,d, e, f;/* 对data生成MD5摘要paramfile 要加密的文件returnMD5摘要码*/public static String getMD5(File file) FileInputStream fis = null;try MessageDigest md = MessageDigest.getInstance(MD5);fis = new FileInputStream(file);byte buffer = new byte2048;int length = -1;while (length = fis.read(buffer) != -1) md.update(buffer, 0, length); byte b = md.digest();return byteToHexString(b);catch (Exception ex) ex.printStackTrace();return null;finally try fis.close(); catch (IOException ex) ex.printStackTrace(); /* 把byte数组转换成十六进制字符串表示形式param tmp 要转换的bytereturn 十六进制字符串表示形式DB50/T 1096.520218*/private static String byteToHexString(byte tmp)String s;char str = new char16 * 2;int k = 0;for (int i = 0; i 4&0 xf;strk+ = hexdigitsbyte0&0 xf;s = new String(str);return s;public static void main(String arg) System.out.println(getMD5(new File(d:/test.zip);图D.1MD5 摘要 JAVA 实现示例