WebServices业务接口规范说明书

WebServices务接口规范说明书第页共6页

1.范围本规范文档主要适用于开放式虚拟仿真实验教学系统和其它业务系统信息数据的接入。2.术语、定义和缩略术/义XMLWSDL

含描述数据的标准方法表示信息交换的协议Web务描述语言基于XML语的用于在互联网上描述服务的协议缩语

英原

中含开工具包运环境虚机数据库服务3.接口设计接口服务器通过：http://IP:port/EIP/WebService/

连接服务器，同时对外提供业务功能接口，接收的参数和返回的参数都用一定的xml格进行封装。请求

请类为String类version="1.0"encoding="utf-8"="xx01"version="1.0"reqtype="0"</header></request>头参体定第页共6页

请求参数的头部参数体格式固定，定义如下：参名typeversion

参说请求业务系统对应功能方法，具体详见各业务接口说明请求业务系统版本号请求业务系统类型请求业务系统当前用户id

请参体param定参数体中具请求参数，根据不同的业务而不同，详见各业务接口。返回

返类为String类version="1.0"encoding="utf-8"?><response>="XX01"value="XX00"info="成"></header></result>头参体定返回参数的头部参数体格固定，定义如下：参名typeinfo

参说相应业务系统对应功能方法（与请求对应）标识成功或失败返回码xx00为功其余为失败，具体失败码详见各业务接口）返回信息说明

返值数result定义参数体result中具体返回参数，根据不同的业务而不同。详见各业务功能返回值参数体result定。注意：在值识为失败时，无在任何业务功能下有可能为空。

返value值错码

说错误错误错误错误错误错误无数据数据已被删除第页共6页

传入参数错误

模接口型明编……错误型明编功1：登陆验证

接登录验证退出系统版本信息及更新接连接服失败解析请求失败解析业务模块失败解析参数失败查询失败用户不存在密码错误用户无效……

功描对用户名和密码进行验证，记录时址等信请参体param定version="1.0"encoding="utf-8"="1101"version="1.0"reqtype="0"</header>username="admin"</request>头部参数体中定义参数，详见本文档“请求参数头部参数定下各业务接口中头部参数体定相同，不再赘述属值，参数体param第页共6页

说明如下：参

说终端登陆用户名终端登录密码（说明：密码采用MD5密传输，具体密钥见后）

返值数result定义version="1.0"encoding="utf-8"<response>value="1100"成"></header>username="admin"userid="user000000000001"管员"></result>头部参数体中定义参数见文返参数头部参数体header定（下各业务接口中头部参数体定相同，不再赘述type属性值1101，参数体result说明如下：参功2：退出系统

说登陆用户名登录用户当前登陆用户的姓名

功描记录退出相关信息，如时间以及类型。请参体param定略返值数result定义略功3：

版信及新略

功描版本信息交互，查询到新版本后动更新，并记录更新信请参体param定

模接口型明第页共6页

编……错误型明编

接常规实验数据采集接口实验考核数据采集接口接连接服失败解析请求失败解析业务模块失败解析参数失败查询失败数据不完整数据错误数据无效……功略

功描对用户实验数据进行采集，包括、退出实验时间，用户模块名称，正常实验完成时间，实验完成情况、真实实成时间等请参体param定返值数result