接口设计说明书v1.01

1、DDDDDDDDD目录TOC o 1-5 h z1引言1编写目的1背景12接口设计说明1接口列表1接口说明2上传防治信息2 HYPERLINK l bookmark5 上传采收信息2 HYPERLINK l bookmark7 上传灌溉信息3 HYPERLINK l bookmark9 上传旧版包装信息3 HYPERLINK l bookmark11 上传新版包装信息4 HYPERLINK l bookmark13 上传种植信息5 HYPERLINK l bookmark15 上传施肥信息5 HYPERLINK l bookmark17 上传检测信息6 HYPERLINK l bookmark

2、19 验证执法巡查系统用户6获取产品信息7 HYPERLINK l bookmark21 下载企业基本信息7把旧数据库中的数据转换到新的数据库里81引言编写目的广州市农产品质量安全追溯系统接口设计说明书详细介绍广州市农产品质量安全追溯系统涉及的接口及接口说明，指出了接口与应用程序之间的关系。该接口设计说明书的读者包括程序开发人员、以上相关系统的开发人员、测试人员。背景接口设计基于已有系统及新增系统功能提出。2接口设计说明接口列表序号接口名称功能描述1addtbCHamper上传防治信息2addtbCharvest上传采收信息3addtbCIrrigation上传灌溉信息4addtbCpacki

3、ng上传旧版包装信息5addtbCpacking2上传新版包装信息6addtbCseed上传种植信息7addtbFertilize上传施肥信息8addtbSelfInspect上传检测信息9checkuserzfxc验证执法巡查系统用户10getAllProducts获取产品信息11getUserXml根据用户名密码下载企业注册基本信息15transformDataFromOldDatabase把旧数据库中的数据转换到新的数据库里16uploadPicture上传图片2.2接口说明2.2.1上传防治信息功能说明上传防治信息调用位置生产管理系统上传数据时函数方法addtbCHamper(stri

4、ngtbCHamperXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbCHamperXMLStringXml格式的防治数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getHamperTable(dba.result(sqlString);sum=ds.Tables0.Rows.Count;Console.WriteLine(sum);tryservice.addtbCHamper(ds.GetXml();sqlString=upd

5、atetbHampersetiUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.2上传采收信息功能说明上传采收信息调用位置生产管理系统上传数据时函数方法addtbCharvest(stringtbCharvestXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbCharvestXMLStringXml格式的采收数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getHarve

6、stTable(dba.result(sqlString);sum=ds.Tables0.Rows.Count;tryservice.addtbCharvest(ds.GetXml();sqlString=updatetbHarvestsetiUp=1;dba.execute(sqlString);returnsum;catch2.2.3上传灌溉信息功能说明上传灌溉信息调用位置生产管理系统上传数据时函数方法addtbCIrrigation(stringtbCIrrigationXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参

7、数说明tbCIrrigationXMLStringXml格式的灌溉数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getIrrigationTable(dba.result(sqlString);sum=ds.Tables0.Rows.Count;tryservice.addtbCIrrigation(ds.GetXml();sqlString=updatetbIrrigationsetiUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.4上传旧版包

8、装信息功能说明上传新版包装信息调用位置生产管理系统上传数据时函数方法addtbCpacking(stringtbCpackingXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbCpackingXMLStringXml格式的包装数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getPackingTable(dt);intsum;sum=ds.Tables0.Rows.Count;tryservice.addtbCpacking(DBF

9、actory.GetDataSetXml(tbpacking,dt.Copy();sqlString=updatetbPackingsetiUp=1;dba.execute(sqlString);sqlString=updatetb_PackingsetisUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.5上传新版包装信息功能说明上传新版包装信息调用位置生产管理系统上传数据时函数方法addtbCpacking2(stringtbCpacking2XML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS

10、_DB输入参数参数代码数据类型参数说明tbCpacking2XMLStringXml格式的包装数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getPackingTable(dt);intsum;sum=ds.Tables0.Rows.Count;tryservice.addtbCpacking2(DBFactory.GetDataSetXml(tbpacking,dt.Copy();sqlString=updatetbPackingsetiUp=1;dba.execute(sqlString);sqlStri

11、ng=updatetb_PackingsetisUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.6上传种植信息功能说明上传种植信息调用位置生产管理系统上传数据时函数方法addtbCseed(stringtbCseedXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbCseedXMLStringXml格式的种植数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getSeed(

12、dba.result(sqlString);sum=ds.Tables0.Rows.Count;tryservice.addtbCseed(ds.GetXml();sqlString=updatetbSeedsetoldid=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.7上传施肥信息功能说明上传施肥信息调用位置生产管理系统上传数据时函数方法addtbFertilize(stringtbFertilizeXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbFe

13、rtilizeXMLStringXml格式的施肥数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getHamperTable(dba.result(sqlString);sum=ds.Tables0.Rows.Count;Console.WriteLine(sum);tryservice.addtbCHamper(ds.GetXml();sqlString=updatetbHampersetiUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.8上传检

14、测信息功能说明上传检测信息调用位置生产管理系统上传数据时函数方法addtbSelfInspect(stringtbSelfInspectXML)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明tbSelfInspectXMLStringXml格式的检测数据输出参数参数代码数据类型参数说明result返回值boolean上传成功则返回true否则返回false示例DataSetds=getHamperTable(dba.result(sqlString);sum=ds.Tables0.Rows.Count;Console.Wri

15、teLine(sum);tryservice.addtbCHamper(ds.GetXml();sqlString=updatetbHampersetiUp=1;dba.execute(sqlString);returnsum;catchreturn-1;2.2.9验证执法巡查系统用户功能说明验证执法巡查系统用户调用位置执法巡查应用系统登录时函数方法checkuserzfxc(stringusername,stringpassword)输入数据库服务器数据库GZSY_TEMP_DB输出数据库终端数据库GZVMPS_DB输入参数参数代码数据类型参数说明usernameString用户名Passw

16、ordString密码输出参数参数代码数据类型参数说明result返回值int验证成功返回1失败返回0示例tryHashMaphm=newHashMap();hm.put(username”,txtusername.getText().toString();hm.put(password”,txtpassword.getText().toString();WebServiceJC.setUrl(inner”,myDbHelper);Stringresult=WebServiceJC.WorkJC(checkuserzfxc”,hm);if(result.equals(1)insertUser(

17、);setVideoUrl();returntrue;catch(Exceptione)/TODO:handleexceptionweberror=1;2.2.10获取产品信息功能说明获取产品信息调用位置生产管理系统上传数据时函数方法getAllProducts()输入数据库终端数据库GZVMPS_DB输出数据库服务器数据库GZSY_TEMP_DB输入参数参数代码数据类型参数说明无输出参数参数代码数据类型参数说明result返回值booleanXml格式的企业基本信息示例service.Url=io.readText(Application.StartupPath.ToString()+“Se

18、rverPath.ini).ToString();DataSetds=newDataSet();stringxmlresult=service.getAllProducts();StringReadersr=newStringReader(xmlresult);ds.ReadXml(sr);2.2.11下载企业基本信息功能说明下载企业基本信息调用位置生产管理系统用户首次登陆时函数方法getUserXml(stringuname,stringupass)输入数据库终端数据库GZVMPS_DB输出数据库服务器数据库GZSY_TEMP_DB输入参数参数代码数据类型参数说明UnameString用户名UpassString密码输出参数参数代码数据类型参数说明resultStringXml格式的企业基本信息示例IOio=newIO();TJFXCWS.Serviceservice=newTJFXCWS.Service();service.Url=io.readText(Application.StartupPath.ToString()+“ServerPath.ini).ToString();DataSetds=newDataSet();stringxmlresult=service.getUserXml(suname,upass);StringReadersr=newStringRea