1、ICS 65.020.30CCS B 40 DB50重 庆 市 地 方 标 准DB50/T 1096.52021畜 牧 兽 医 大 数 据 应 用 与 管 理第 5 部 分 ： 共 享 交 换 技 术 要 求 2021-03-30 发 布 2021-07-01 实 施重 庆 市 市 场 监 督 管 理 局 发 布 DB50/T 1096.52021 I 前 言本 文 件 按 照 GB/T1.1 2020 标 准 化 工 作 导 则 第 1 部 分 ： 标 准 化 文 件 的 结 构 和 起 草 规 则 的 规 定起 草 。本 文 件 是 DB50/T 1096的 第 5 部 分 。 DB50/
2、T 1096已 发 布 了 以 下 部 分 ：-第 1 部 分 ： 总 则-第 2 部 分 ： 元 数 据-第 3 部 分 ： 信 息 分 类 与 编 码-第 4 部 分 ： 数 据 接 口-第 5 部 分 ： 共 享 交 换 技 术 要 求-第 6 部 分 ： 信 息 资 源 目 录 -第 7 部 分 ： 管 理 要 求请 注 意 本 文 件 的 某 些 内 容 可 能 涉 及 专 利 。 本 文 件 的 发 布 机 构 不 承 担 识 别 专 利 的 责 任 。本 文 件 由 重 庆 市 农 业 农 村 委 员 会 提 出 并 归 口 。本 文 件 起 草 单 位 ： 重 庆 市 畜 牧
3、技 术 推 广 总 站 、 重 庆 大 学 、 广 州 中 科 易 德 科 技 有 限 公 司 、 西 南 大 学 、广 州 中 国 科 学 院 软 件 应 用 技 术 研 究 所 。本 文 件 主 要 起 草 人 ： 夏 云 霓 、 古 平 、 李 引 、 李 晓 波 、 陈 红 跃 、 樊 莉 、 张 科 、 何 道 领 、 朱 燕 、 黄 文 明 、陈 雷 。 DB50/T 1096.52021 1 畜 牧 兽 医 大 数 据 应 用 与 管 理第 5 部 分 ： 共 享 交 换 技 术 要 求1 范 围本 文 件 规 定 了 畜 牧 兽 医 行 业 的 数 据 共 享 与 数 据 交
4、换 的 技 术 要 求 。本 文 件 适 用 于 畜 牧 兽 医 行 业 的 数 据 共 享 与 交 换 的 具 体 实 现 。2 规 范 性 引 用 文 件下 列 文 件 中 的 内 容 通 过 文 中 的 规 范 性 引 用 而 构 成 本 文 件 必 不 可 少 的 条 款 。 其 中 ， 注 日 期 的 引 用 文 件 ， 仅 该 日 期 对 应 的 版 本 适 用 于 本 文 件 ； 不 注 日 期 的 引 用 文 件 ， 其 最 新 版 本 （ 包 括 所 有 的 修 改 单 ） 适 用 于 本文 件 。GB/T 7408 数 据 元 和 交 换 格 式 信 息 交 换 日 期 和
5、 时 间 表 示 法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数 据 使 用
6、方 data user在 数 据 共 享 与 交 换 中 接 收 并 使 用 数 据 的 一 方 。3.2 缩 略 语本 文 件 中 使 用 的 缩 略 语 如 下 ： JSON： JS 对 象 标 记 （ JavaScript Object Notation）HTTP： 超 文 本 传 输 协 议 （ HyperText Transfer Protocol） DB50/T 1096.52021 2 MD5： 消 息 摘 要 算 法 第 五 版 （ Message-Digest Algorithm 5）4 数 据 共 享 与 交 换 要 求4.1 数 据 共 享 要 求数 据 共 享 应 符
7、合 以 下 要 求 ：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） 数 据 提 供 方 收 到 数 据
8、交 换 请 求 ， 解 析 数 据 报 文 ， 进 行 校 验 后 对 合 法 数 据 进 行 发 送 ， 非 法 数 据 则发 送 错 误 代 码 ；c） 数 据 使 用 方 接 收 数 据 并 存 储 ， 返 回 一 个 数 据 报 文 ， 数 据 提 供 方 根 据 返 回 数 据 报 文 判 断 本 次 数 据交 换 是 否 成 功 。4.3 数 据 交 换 与 内 容 格 式数 据 交 换 的 内 容 采 用 JSON作 为 数 据 交 换 的 媒 介 , 其 格 式 应 符 合 ECMAScript 8.0的 要 求 。4.4 数 据 交 换 请 求 JSON格 式4.4.1 数
9、据 交 换 请 求 JSON 应 包 含 以 下 四 个 核 心 参 数 ：a） accessToken： 调 用 接 口 的 令 牌 。 登 陆 成 功 后 ， 返 回 一 个 32 位 的 Hash字 符 串 ；b） timestamp： 接 口 使 用 方 发 出 请 求 的 客 户 端 时 间 （ 采 用 东 八 区 系 统 时 间 UTC/GMT+08:00） ； c） totalNum： 表 示 数 据 交 换 所 携 带 的 记 录 数 量 ；d） data： 为 JSON数 组 ， 存 放 交 换 数 据 。4.4.2 数 据 交 换 请 求 示 例 见 附 录 A。4.5 数
10、 据 交 换 返 回 JSON格 式4.5.1 数 据 交 换 返 回 结 果 JSON 应 包 含 以 下 四 个 核 心 参 数 ：a） errorCode： 为 错 误 代 码 ， 表 明 数 据 交 换 失 败 的 原 因 。 当 数 据 交 换 成 功 时 ， 该 参 数 为 0； 当 数据 交 换 失 败 时 ， 该 参 数 为 自 定 义 的 错 误 代 码 ；b） errorMessage： 为 返 回 结 果 信 息 ， 描 述 数 据 交 换 出 错 的 具 体 情 况 。 当 数 据 交 换 成 功 时 ， 该 参 数为 空 值 ； 当 数 据 交 换 失 败 时 ， 该
11、 参 数 为 自 定 义 的 错 误 原 因 ；c） success： 标 志 此 次 数 据 交 换 是 否 成 功 。 成 功 为 true， 失 败 为 false；d） data： 当 数 据 交 换 成 功 时 ， 则 data参 数 为 空 值 ； 当 数 据 交 换 失 败 时 ， data参 数 存 放 交 换 失 败 的 数 据 。4.5.2 数 据 交 换 返 回 示 例 见 附 录 B 和 附 录 C 。4.6 数 据 共 享 与 交 换 安 全 DB50/T 1096.52021 3 4.6.1 数 据 交 换 请 求 及 数 据 交 换 返 回 中 的 data部 分
12、 ， 均 使 用 MD5加 密 方 式 进 行 加 密 。 在 数 据 交 换 时 ，数 据 发 送 方 在 传 输 数 据 的 同 时 提 供 MD5 码 ， 数 据 接 收 方 接 收 后 使 用 MD5 码 对 接 收 的 数 据 进 行 验 证 。4.6.2 使 用 MD5加 密 的 实 现 示 例 见 附 录 D。 DB50/T 1096.52021 4 附 录 A（ 资 料 性 ）数 据 交 换 请 求 JSON 示 例图 A.1给 出 了 数 据 交 换 请 求 JSON示 例 。http:/SERVER_IP/SYTSTEM_NAME/?accessToken=C7ABF9DA
13、D2F94BB1907ADE0AFE3F4EC1importjava.io.FileInputStream;importjava.io.IOException;importjava.security.MessageDigest; publicclassMD5staticcharhexdigits=0,1,2,3,4,5,6,7,8,9,a,b,c,d,e,f;/*对data生 成MD5摘 要paramfile要 加 密 的 文 件returnMD5摘 要 码*/publicstaticStringgetMD5(Filefile)FileInputStreamfis=null;tryMessag
14、eDigestmd=MessageDigest.getInstance(MD5); fis=newFileInputStream(file);bytebuffer=newbyte2048;intlength=-1;while(length=fis.read(buffer)!=-1)md.update(buffer,0,length);byteb=md.digest();returnbyteToHexString(b);catch(Exceptionex)ex.printStackTrace();returnnull; finallytryfis.close();catch(IOExceptio
15、nex)ex.printStackTrace();/*把byte数 组 转 换 成 十 六 进 制 字 符 串 表 示 形 式paramtmp要 转 换 的bytereturn十 六 进 制 字 符 串 表 示 形 式*/ DB50/T 1096.52021 8 privatestaticStringbyteToHexString(bytetmp)Strings;charstr=newchar16*2;intk=0;for(inti=0;i4strk+=hexdigitsbyte0s=newString(str);returns; publicstaticvoidmain(Stringarg)System.out.println(getMD5(newFile(d:/test.zip);图 D.1 MD5摘 要 JAVA实 现 示 例
