接口设计说明书v1.01

1、接口设计说明书 目录 1引言1 1.1编写目的1 1.2背景1 2接口设汁说明1 2接口列表1 2.2接口说明2 221上传防治信息2 2. 2. 2上传采收信息2 2. 2. 3上传灌溉信息3 2. 2. 4上传II I版包装信息3 225上传新版包装信息4 226上传种植信息5 227上传施肥信息5 228上传检测信息6 229验证执法巡查系统用户6 2210获取产品信息7 2211下载企业皋本信息7 2. 2. 12耙III数据库中的数据转换到新的数据库里8 1.1编写目的 广州市农产品质量安全追溯系统接口设计说明书详细介绍广州市 农产品质量安全追溯系统涉及的接口及接口说明，指出了接口与

2、应用 程疗;之间的关系。 该接口设计说明书的读者包括程序开发人员、以上相关系统的开 发人员、测试人员。 二I匕旦 12冃尽 接口设计基于已有系统及新增系统功能提岀0 2接口设计说明 2 - 1接口列表 序号 接口名称 功能描述 1 addtbCHamper 上传防治信息 2 addtbCharvest 上传采收信息 3 addtbCIrrigation 上传灌溉信息 4 addtbCpacking 上传旧版包装信息 5 addtbCpacking2 上传新版包装信息 6 addtbCseed 上传种植信息 7 addtbFert订ize 上传施肥信息 8 addtbSelflnspect 上传

3、检测信息 9 checkuserzfxc 验证执法巡查系统用户 10 getAllProducts 获取产品信息 11 getUserXml 根据用户名密码下载企业注册基本信息 15 transformDataFromOldDatabase 把旧数据库屮的数据转换到新的数据库里 16 uploadPicture 上传图片 22接口说明 2. 2.1上传防治信息 功能说明 上传防治信息 调用位置 生产管理系统上传数据时 函数方法 iampe 输入数据库 服务器数据库GZSY TEMP J) B 输出数据库 终端数据库GZVWSJJB 输入参数 参数代码 数据类型 参数说明 tbCHamperXM

4、L String ：nl恪式的防治数据 输出参数 参数代码 数据类型 参数说明 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSet ds 二 getHamperTable(dba result(sqlString); sum二 ds Tables0 Rows Count; Console WriteLine(sum); try service addtbCHamper(ds GetXml(): sqlString 二 update tbHamper set iUp=l； dba - execute (sqlString); return sum

5、;catch return 1; 2. 2. 2上传米收信息 功能说明 上传采收信息 调用位置 生产管理系统上传数据时 函数方法 addtbCharvest (string tbCharvestXVIL) 输入数据库 服务器数据库GZSY TEMP)B 输出数据库 终端数据库GZVMPS DB 输入参数 参数代码 数据类型 参数说明 tbCharvestXML String Xml恪式的采收数据 输出参数 参数代码 数据类型 参数说明 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSet ds 二 getHarvestTable(dba - re

6、sult(sqlString); sum 二 ds Tables0 Rows Count; try service addtbCharvest(ds GetXml(): sqlString 二 update tbHarvest set iUp二1; dba - execute (sqlString); return sum; catch return 2.2.3上传灌溉信息 功能说明 上传灌溉信息 调用位置 生产管理系统上传数据时 函数方法 addtbCIrrigation (string tbCIrrigationXML) 输入数据库 服务器数据库GZSY TEMP DB 输出数据库 终端数

7、据库GZVMPS DB 输入参数 参数代码 数据类型 参数说明 tbCIrrigati onXML String Xml1勺灌溉数据 输出参数 参数代码 数据类型 参数说明 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSet ds 二 getlrrigationTable(dba result (sqlString); sum 二 ds Tables LO Rows Count; try service - addtbCIrrigat ion (ds - GetXml(): sqlString 二 update tblmgation set d

8、ba execute (sqlString); return sum; catch return 、1; 2.2.4 土传旧版包装信息 功能说明 调用位置 生产管理系统上传数据时 函数方法 addtbCpacking (string tbCpackingXML) 输入数据库 服务器数据库GZSY TEMP DB 输出数据库 终端数据库GZVMPS DB 输入参数 参数代码 数据类型 参数说明 tbCpackingXML String 丄ill恪式的包装数据 输出参数 参数代码 数据类型 参数说明 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSe

9、t ds 二 getPackingTable (dt); int sum; sum 二 ds Tables0 Rows Count; try service addtbCpacking (DBFactory GetDataSetXml (tbpackingz，, dt. CopyO); sqlString 二update tbPacking set iUp=l; dba execute (sqlString); sqlString 二update tb_Packing set isUp二r*： dba execute(sqlString); return sum; catch return 1

10、; 2. 2. 5上传新版包装信息 功能说明 上传新版包装信息 调用位置 生产管理系统上传数据时 函数方法 addtbCpacking2 (string tbCpacking2XML) 输入数据库 服务器数据床GZSY TEMP J) B 输出数据库 终端数据库GZVMPSJJB 输入参数 参数代码 数据类型 参数说明 tbCpacking2XML String X:nl恪式的包装数据 参数代码 数据类型 参数说明 输出参数 result返回值 boolean 上传成功则返回true 否则返回false DataSet ds 二 getPackingTable (dt); int sum; s

11、um 二 ds Tables 0 Rows Count; try service addtbCpacking2(DBFactory GetDataSetXmlCtbpacking, 示例 dt. CopyO); sqlString 二 update tbPacking set iUp=l； dba execute(sqlString); sqlString 二update tb_Packing set isUp二 1 ； dba execute(sqlString); return sum; catch ( :return 1; 2. 2. 6上传种植信息 功能说明 上传种植信息 调用位置 生

12、产管理系统上传数据时 函数方法 addtbCseed (string tbCseedXML) 输入数据库 服务器数据库GZSY TEMP J) B 输出数据库 终端数据库GZVMPSJJB 输入参数 参数代码 数据类型 参数说明 tbCseedXML String Xml恪式的. 参数代码 数据类型 参数说明 输出参数 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSet ds 二 getSeed (dba result (sqlString); sum 二 ds Tables LO： Rows Count; try service addtbC

13、seed (ds GetXmlO): sqlString 二update tbSeed set oldid二1； dba - execute (sqlString); return sum; catch return 1; 2. 2. 7上传施肥信息 功能说明 上传施肥信息 调用位賢 生产管理系统上传数据时 函数方法 addtbFertilize (string tbFertilizeXML) 输入数据库 服务器数据库GZSY TEMP DB 输出数据库 终端数据库GZVMPS DB 输入参数 参数代码 数据类型 参数说明 tbFer ti lizeXVIL String Xml式的施肥数据

14、输出参数 参数代码 数据类型 参数说明 result返回值 boolean 上传成功则返回true 否则返回false 示例 DataSet ds 二 getHamperTable(dba result (sqlString); sum二 ds Tables LO Rows Count; Console WriteLine(sum); try service addtbCHamper(ds GetXml(); sqlString 二update tbHamper set iUp二1*; dba execute (sqlString); return sum;catch return T; 2.

15、 2. 8上传检测信恩 功能说明 上传检测信息 调用位置 生产管理系统上传数据时 函数方法 addtbSelflnspect (string tbSelflnspectXML) 输入数据库 服务器数据库GZSY TEMP DB 输出数据库 终端数据库GZVMPS DB 输入参数 参数代码 数据类型 参数说明 tbSelflnspectXML String xJ恪式的检测数据 参数代码 数据类型 参数说明 输出参数 result返回值 boolean 上传成功则返回true 否则返回false DataSet ds 二 getHamperTable(dba result(sqlString);

16、sum二 ds Tables0 Rows Count: 示例 Console WriteLine(sum); try service addtbCHamper(ds GetXml(); sqlString 二 update tbHamper set iUp二1*; dba - execute (sqlString): return sum;catch :return ”1; 2. 2.9验证执法巡査系统用户 功能说明 验证执法巡查系统用户 调用位置 执法巡査应用系统登录时 函数方法 checkuserzfxc (string username, string passv 输入数据库 服务器数据

17、库GZSY TEMP J) B 输出数据库 终端数据库GZVMPS J)B 输入参数 参数代码 数据类型 参数说明 username String Password String 输出参数 参数代码 数据类型 参数说明 result返回值 int 验证成功返回1失败返 回0 示例 try HashMaphm=new HashJlap 0: hm - put ( username, txtusername - getText () toStrmg (,); hm - put ( password, txtpassword - getText 0 toStringO); WebServiceJC

18、setUrl(inner, myDbHelper); String resuIt二WebServiceJC WotkJC(checkuse:rzfxc, hm); if (result - equals(1) insertUser(): setVideoUrlO ; return true; catch (Exception e) / TODO： handle exception weberror二1; 2.2.10获取产品信息 功能说明 调用位置 生产管理系统上传数据时 函数方法 getAllProducts 0 输入数据库 终端数据库GZVMPSJ)B 输出数据库 服务器数据库GZSY T

19、EMP)B 输入参数 参数代码 数据类型 参数说明 尢 输出参数 参数代码 数据类型 参数说明 result返回值 boolean Xml格式的企业基本信 息 示例 service Url 二io readText(Application StartupPath.ToStringO + *ServerPath ini) ToStringO ； DataSet ds 二 new DataSet (): string xmlresult 二 service getAllProducts (); StringReader sr 二 new StnngReader (xmlresuIt): ds ReadXml(sr); 2.2.11下载企业基本信息 功能说明 调用位賈 生产管理系统用户首次登陆时 函数方法 getUserXml(string uname, string upass) 输入数据库 终端数据库GZVMPS DB 输出数据库 服务器数据库GZSY TEMP DB 输入参数 参数代码 数据类型 参数说明 Vname String 用户名 Upass String 输出参数