ICS65.020.30

CCSB40

DB50

重慶市地方標(biāo)準(zhǔn)

DB50/T1096.5—2021

畜牧獸醫(yī)大數(shù)據(jù)應(yīng)用與管理

第5部分：共享交換技術(shù)要求

2021-03-30發(fā)布2021-07-01實(shí)施

重慶市市場(chǎng)監(jiān)督管理局發(fā)布

DB50/T1096.5—2021

前??言

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定

起草。

本文件是DB50/T1096的第5部分。DB50/T1096已發(fā)布了以下部分：

----第1部分：總則

----第2部分：元數(shù)據(jù)

----第3部分：信息分類與編碼

----第4部分：數(shù)據(jù)接口

----第5部分：共享交換技術(shù)要求

----第6部分：信息資源目錄

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

請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。

本文件由重慶市農(nóng)業(yè)農(nóng)村委員會(huì)提出并歸口。

本文件起草單位：重慶市畜牧技術(shù)推廣總站、重慶大學(xué)、廣州中科易德科技有限公司、西南大學(xué)、

廣州中國(guó)科學(xué)院軟件應(yīng)用技術(shù)研究所。

本文件主要起草人：夏云霓、古平、李引、李曉波、陳紅躍、樊莉、張科、何道領(lǐng)、朱燕、黃文明、

陳雷。

I

DB50/T1096.5—2021

畜牧獸醫(yī)大數(shù)據(jù)應(yīng)用與管理

第5部分：共享交換技術(shù)要求

1范圍

本文件規(guī)定了畜牧獸醫(yī)行業(yè)的數(shù)據(jù)共享與數(shù)據(jù)交換的技術(shù)要求。

本文件適用于畜牧獸醫(yī)行業(yè)的數(shù)據(jù)共享與交換的具體實(shí)現(xiàn)。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T7408數(shù)據(jù)元和交換格式信息交換日期和時(shí)間表示法

GB/T11457信息技術(shù)軟件工程術(shù)語(yǔ)

GB/T20014.1良好農(nóng)業(yè)規(guī)范

GB/T28167信息技術(shù)XML元數(shù)據(jù)交換（XMI）

GB/T35295信息技術(shù)大數(shù)據(jù)術(shù)語(yǔ)

GB/T38672信息技術(shù)大數(shù)據(jù)接口基本要求

3術(shù)語(yǔ)、定義和縮略語(yǔ)

3.1術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1.1

數(shù)據(jù)提供方dataprovider

在數(shù)據(jù)共享與交換中提供數(shù)據(jù)的一方。

3.1.2

數(shù)據(jù)使用方datauser

在數(shù)據(jù)共享與交換中接收并使用數(shù)據(jù)的一方。

3.2縮略語(yǔ)

本文件中使用的縮略語(yǔ)如下：

JSON：JS對(duì)象標(biāo)記（JavaScriptObjectNotation）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

1

DB50/T1096.5—2021

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

4數(shù)據(jù)共享與交換要求

4.1數(shù)據(jù)共享要求

數(shù)據(jù)共享應(yīng)符合以下要求：

a）數(shù)據(jù)共享以WEB服務(wù)方式提供，按照GB/T35295和GB/T38672的要求進(jìn)行。

b）數(shù)據(jù)共享服務(wù)的設(shè)計(jì)、封裝、開發(fā)按照GB/T11457和GB/T20014.1的要求進(jìn)行。

4.2數(shù)據(jù)交換方式

數(shù)據(jù)交換按照GB/T7408和GB/T28167的要求進(jìn)行，分為以下三個(gè)階段：

a）數(shù)據(jù)使用方通過HTTP向數(shù)據(jù)提供方發(fā)起數(shù)據(jù)交換請(qǐng)求；

b）數(shù)據(jù)提供方收到數(shù)據(jù)交換請(qǐng)求，解析數(shù)據(jù)報(bào)文，進(jìn)行校驗(yàn)后對(duì)合法數(shù)據(jù)進(jìn)行發(fā)送，非法數(shù)據(jù)則

發(fā)送錯(cuò)誤代碼；

c）數(shù)據(jù)使用方接收數(shù)據(jù)并存儲(chǔ)，返回一個(gè)數(shù)據(jù)報(bào)文，數(shù)據(jù)提供方根據(jù)返回?cái)?shù)據(jù)報(bào)文判斷本次數(shù)據(jù)

交換是否成功。

4.3數(shù)據(jù)交換與內(nèi)容格式

數(shù)據(jù)交換的內(nèi)容采用JSON作為數(shù)據(jù)交換的媒介,其格式應(yīng)符合ECMAScript8.0的要求。

4.4數(shù)據(jù)交換請(qǐng)求JSON格式

4.4.1數(shù)據(jù)交換請(qǐng)求JSON應(yīng)包含以下四個(gè)核心參數(shù)：

a）accessToken：調(diào)用接口的令牌。登陸成功后，返回一個(gè)32位的Hash字符串；

b）timestamp：接口使用方發(fā)出請(qǐng)求的客戶端時(shí)間（采用東八區(qū)系統(tǒng)時(shí)間UTC/GMT+08:00）；

c）totalNum：表示數(shù)據(jù)交換所攜帶的記錄數(shù)量；

d）data：為JSON數(shù)組，存放交換數(shù)據(jù)。

4.4.2數(shù)據(jù)交換請(qǐng)求示例見附錄A。

4.5數(shù)據(jù)交換返回JSON格式

4.5.1數(shù)據(jù)交換返回結(jié)果JSON應(yīng)包含以下四個(gè)核心參數(shù)：

a）errorCode：為錯(cuò)誤代碼，表明數(shù)據(jù)交換失敗的原因。當(dāng)數(shù)據(jù)交換成功時(shí)，該參數(shù)為0；當(dāng)數(shù)

據(jù)交換失敗時(shí)，該參數(shù)為自定義的錯(cuò)誤代碼；

b）errorMessage：為返回結(jié)果信息，描述數(shù)據(jù)交換出錯(cuò)的具體情況。當(dāng)數(shù)據(jù)交換成功時(shí)，該參數(shù)

為空值；當(dāng)數(shù)據(jù)交換失敗時(shí)，該參數(shù)為自定義的錯(cuò)誤原因；

c）success：標(biāo)志此次數(shù)據(jù)交換是否成功。成功為true，失敗為false；

d）data：當(dāng)數(shù)據(jù)交換成功時(shí)，則data參數(shù)為空值；當(dāng)數(shù)據(jù)交換失敗時(shí)，data參數(shù)存放交換失敗的

數(shù)據(jù)。

4.5.2數(shù)據(jù)交換返回示例見附錄B和附錄C。

4.6數(shù)據(jù)共享與交換安全

2

DB50/T1096.5—2021

4.6.1數(shù)據(jù)交換請(qǐng)求及數(shù)據(jù)交換返回中的data部分，均使用MD5加密方式進(jìn)行加密。在數(shù)據(jù)交換時(shí)，

數(shù)據(jù)發(fā)送方在傳輸數(shù)據(jù)的同時(shí)提供MD5碼，數(shù)據(jù)接收方接收后使用MD5碼對(duì)接收的數(shù)據(jù)進(jìn)行驗(yàn)證。

4.6.2使用MD5加密的實(shí)現(xiàn)示例見附錄D。

3

DB50/T1096.5—2021

附錄A

（資料性）

數(shù)據(jù)交換請(qǐng)求JSON示例

圖A.1給出了數(shù)據(jù)交換請(qǐng)求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":"畜禽肉類產(chǎn)品銷售",

"ZTYT_DETAIL":"肉類銷售點(diǎn)",

"SHXYM":"92440604MA4X4E4U5H",

"RCJDGLJG":"重慶市農(nóng)業(yè)執(zhí)法總隊(duì)",

"FDDBR":"張XX",

"JYCS":"重慶市九龍坡區(qū)白市驛鎮(zhèn)黃金橋二號(hào)",

"P_REGION_CODE":"440604",

"FZRQ":"2017-10-18",

"P_LAST_UPDATE_TIME":"2017-11-0915:09:15",

"PERMIT_STATUS":"NORMAL",

"ZS":"重慶市九龍坡區(qū)白市驛鎮(zhèn)黃金橋二號(hào)",

"O_PERMIT_CODE":"\",

"RCJDGLRY":"由負(fù)責(zé)日常監(jiān)督管理機(jī)構(gòu)指派",

"YXKZ":"2022-10-17",

"FZJG":"440604000000",

"ZZJGDM":null,

"XKZBH":"JY14406040114403",

"QFR":"王XX",

"FZJG_DETAIL":"重慶市農(nóng)業(yè)執(zhí)法總隊(duì)",

"P_ID":"JY14406040114403",

"ZSZTXZBM":"440604",

"ZTYT":"1003",

"JYXM":"0102、0301",

}]

}

圖A.1數(shù)據(jù)交換請(qǐng)求JSON示例

4

DB50/T1096.5—2021

附錄B

（資料性）

數(shù)據(jù)交換成功返回JSON示例

圖B.1給出了數(shù)據(jù)交換成功返回JSON示例。

{

"errorCode":"0",

"errorMessage":"",

"success":"true",

"data":[]

}

圖B.1數(shù)據(jù)交換成功返回JSON示例

5

DB50/T1096.5—2021

附錄C

（資料性）

數(shù)據(jù)交換失敗返回JSON示例

圖C.1給出了數(shù)據(jù)交換失敗返回JSON示例。

{

"errorCode":"00000003",

"errorMessage":"JSON數(shù)據(jù)驗(yàn)證失敗",

"success":"false",

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

}

圖C.1數(shù)據(jù)交換失敗返回JSON示例

6

DB50/T1096.5—2021

附錄D

（資料性）

MD5摘要JAVA實(shí)現(xiàn)示例

圖D.1給出了MD5摘要JAVA實(shí)現(xiàn)示例。

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'};

/**對(duì)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[]數(shù)組轉(zhuǎn)換成十六進(jìn)制字符串表示形式

@paramtmp要轉(zhuǎn)換的byte[]

@return十六進(jìn)制字符串表示形式

*/