http接口
2 HTTP invoker 服务模式
2. 客户端：通过 HTTP invoker 代理向服务器端发送请求，远程调用服务接口的方法
3. 服务器端与客户端通信的数据需要序列化
配置服务器端和客户端的步骤
配置服务器端
1. 添加 springJAR 文件
建议使用 spring2+.jar 版本
2. 创建服务接口
3. 创建服务接口的具体实现类
4. 公开服务
配置客户端
1. 添加 springJAR 文件
建议使用 spring2+.jar 版本
2. 创建服务接口
3. 访问服务
实例讲解
服务器端
1. 服务接口： UcService.java
它提供两项服务，查询用户信息和记录日志，如下：
public interface UcService {
public UserInfo getUserInfobyName(String userName);
public int recordLog(String username, String point, String operate, String desc);
}
说明：举这个列子是因为其比较有代表性，它将展示普通数据类型（ int,long 等）和复杂数据类型（ DTO 等）的远程调用方式。 UserInfo 是一个普通的 DTO ，代码如下：
public class UserInfo implements Serializable {
private static final long serialVersionUID= -6970967506712260305L;
/**用户名*/
private String userName ;
/**电子邮箱*/
private String email ;
/**注册日期*/
private Date registDate ;
public String getUserName() {
return userName ;
}
public void setUserName(String userName) {
this. userName = userName;
}
public String getEmail() {
return email ;
}
public void setEmail(String email) {
this. email = email;
}
public Date getRegistDate() {
return registDate ;
}
public void setRegistDate(Date registDate) {
this. registDate = registDate;
}
}
注意：因为是在网络间传输对象，所以需要将 UserInfo 实现 Serializable 接口，并指定一个serialVersionUID（任意值即可，同时客户端也要有这个类，否则在客户端接收对象时会因为serialVersionUID不匹配而出现异常）
回到UcService.java ，它提供了两个服务（在这里一个方法代表一个服务功能），我们需要具体的实现类来实现真正的服务
2. 实现类是 UCServiceImpl.java
public class UCServiceImpl implements UcService {
private static Logger pointrecordlog= Logger.getLogger ( "pointrecordlog" );
private static Logger logger= Logger.getLogger (UCServiceImpl. class);
private UcFacade ucFacade ;
public void setUcFacade(UcFacade ucFacade) {
this. ucFacade = ucFacade;
}
public UserInfo getUserInfobyName(String userName) {
UserInfo user = null;
try{
user = ucFacade .getUserInfoDetail(userName);
logger.debug( "get userinfo success by username:" + userName);
} catch(Throwable t) {
logger.error( "get userinfo fail by username:" + userName, t);
}
return user;
}
public int recordLog(String username, String point, String operate, String desc) {
int result = 0;
try{
https://www.wendangku.net/doc/463230230.html,(username + " - " + point + " - " + operate + " - " + desc);
} catch(Throwable t) {
result = -1;
logger.error(t);
}
return result;
}
}
说明： ucFacade 是通过 spring 注入的一个数据查询类，因为它与 http invoker 没有直接关系，所以不进行介绍。
3. 公开服务 UcService.java
2 WEB-INF/application-context.xml ：将接口声明为 HTTP invoker 服务
class = "org.springframework.remoting.httpinvoker.HttpInvokerServiceExporter"> value = "https://www.wendangku.net/doc/463230230.html,qin.baike.service.UcService">
说明：HttpInvokerServiceExporter实际上是一个 spring mvc 控制器，它处理客户端的请求并调用服务实现。
2 WEB-INF/service-servlet.xml ：HttpInvokerServiceExporter实际上是一个 spring mvc 控制器，所以需要为其提供 spring URL 处理器，这里我们使用SimpleUrlHandlerMapping class = "org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"> 2 WEB-INF/web.xml ：配置 spring 监听及 DispatcherServlet /WEB-INF/application-context.xml org.springframework.web.context.ContextLoaderListener org.springframework.web.servlet.DispatcherServlet 说明：不了解为什么这么配置的可以去看看 spring mvc 方面的资料。 好了，经过以上配置，一个基于 spring HTTP invoker 的远程服务就完成了，服务的地址为：http://${serviceName}:${port}/${contextPath}/service/httpService 客户端 1. 创建服务接口及网络间传输的 DTO 类 为了方便，可以将服务器端创建好的的 UcService.java 和 UserInfo.java 拷贝到客户端 , 或打个 jar 包放到 lib 下。 2. 配置访问服务 2 WEB-INF/application-context.xml ：如果项目中已经存在 spring 配置文件，则不需要创建该文件，需要配置 HTTP invoker 的代理 class = "org.springframework.remoting.httpinvoker.HttpInvokerProxyFactoryBean"> value = "https://www.wendangku.net/doc/463230230.html,qin.baike.service.UcService"> 说明：客户端使用HttpInvokerProxyFactoryBean代理客户端向服务器端发送请求，请求接口为UcService的服务 注意：需要修改 serviceUrl 为实际的服务器地址 2 WEB-INF/web.xml ：配置 spring 监听 如果项目没有 spring 环境，则需要在 web.xml 中加入对 spring 的支持 /WEB-INF/application-context.xml org.springframework.web.context.ContextLoaderListener 3. 访问服务方法 u 读取 spring 上下文，以远程调用 getUserInfobyName 方法为例 2在 jsp,servlet,action 等等文件中 UcService service = (UcService) WebApplicationContextUtils .getRequiredWebApplicationContext( request.getSession().getServletContext()).getBean( "httpService" ); UserInfo user = service .getUserInfobyName( "hanqunfeng" ); 2如果不想配置 spring 运行环境，可以使用如下方式：ApplicationContext applicationContext = new FileSystemXmlApplicationContext( "classpath:application-context.xml" ); service = (UcService) applicationContext.getBean( "httpService" ); u 依赖注入，远程调用 recordLog 方法为例 2在 WEB-INF/application-context.xml 中加入如下配置： 2为 https://www.wendangku.net/doc/463230230.html,qin.test.abc 中加入对 service 的 set 方法： private UcService service ; public void setService(UcService service){ this. service = service; } public String recordUserLog(String username,String point,String operate,String desc){ String result = service .recordLog(username, point, operate, desc); return result; } 关于服务器端配置的补充说明： 有一个误区：有些关于springMVC的书上说，如果没有明确声明一个处理适配器，默认会使用org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter，这个适配器专门负责处理所有实现了 org.springframework.web.servlet.mvc.Controller 接口的处理器，我就是受其影响，认为org.springframework.remoting.httpinvoker.HttpInvokerServiceExporter实现的是 org.springframework.web.HttpRequestHandler接口，所以按理说应该使用的处理适配器是org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter，但实际上并不会出现异常。 其实，原因是因为spring默认会使用四个处理适配器（参看DispatcherServlet.properties，spring2.5，spring2.0只默认三个，2.5增加注解方式）： org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter,/ org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter,/ org.springframework.web.servlet.mvc.throwaway.ThrowawayControllerHandlerAdapter,/ org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter 关于DispatcherServlet.properties的详细信息可以参看： https://www.wendangku.net/doc/463230230.html,/hanqunfeng/archive/2010/01/08/5161319.aspx 但是，如果明确声明了其它的处理适配器，比如 org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter，等等，则默认规则则会覆盖，需要明确声明 org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter这个处理适配器，否则系统会抛异常： javax.servlet.ServletException: No adapter for handler [org.springframework.remoting.httpinvoker.HttpInvokerServiceExporter@179bd14]: Does your handler implement a supported interface like Controller? 所以，建议在使用spring invoker时，最好明确声明 org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter这个处理适配器 补充: 默认情况下，客户端的HttpInvokerProxy使用J2SE的HTTP Client来建立连接，即 org.springframework.remoting.httpinvoker.SimpleHttpInvokerRequestExecutor，可以通过设置httpInvokerRequestExecutor属性来改变默认配置，spring提供了另外一种HttpClient，https://www.wendangku.net/doc/463230230.html,monsHttpInvokerRequestExecutor。 修改配置如下： class="org.springframework.remoting.httpinvoker.HttpInvokerProxyFactoryBean"> class="https://www.wendangku.net/doc/463230230.html,monsHttpInvokerRequestExecutor " /> 需要在项目中引入两个jar包： commons-codec-x.x.jar commons-httpclient-x.x.x.jar CommonsHttpInvokerRequestExecutor具有HTTP connection pooling，不过通过使用jmeter进行压力测试发现，SimpleHttpInvokerRequestExecutor性能高于CommonsHttpInvokerRequestExecutor 一、查询菜品列表接口(DONE) 1、功能说明 接受提供的菜品 XXX画面XXX功能（比如人口查询画面-查询 | 人口查询画面-详细等） 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDinnerQueryAction?ope ration=queryServiceItem 2.2http请求方式 GET 2.3数据返回格式 JSON 2.4传递参数 2.5成功返回结果 [ “serverResponse”:”Success”, “totalRecords”:”52”, “page” : “10”, “pageSize” : “5”, “data”：{ “id” : “123”, “itemName” : “皇堡”, “priceNow” : “10”, “pricePast” : “12”, “servicePicture” :”s9118668.jpg”, “serviceStars” : “3” }, ……. { “id” : “”, “itemName” : “”, “priceNow” : “”, “pricePast” : “”, “servicePicture” :” s9118668.jpg”, “serviceStars” : “3” } ] 2.6返回结果解释 二、查询广告接口（DONE） 1、功能说明 接受广告图片，目前为一张 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDinnerQueryAction?ope ration=queryAdvertisePicture 视频监控平台调研报告【海康】 目录 1.前言 本次从海康租借了一台硬盘录像机、一个枪机和一个球机。由于对方HTTP告警消息模块有BUG，调测花费时间较长。对方提供升级测试版本后已经解决。从目前的进展情况看基本完成了我们的预期目标。主要常用功能均已验证通过，包括：视频监控（VLC插件方式）、录像回放、读取设备信息、设备重启、图像抓拍、告警通知、云台控制。本次报告主要目的是记录相关功能具体实现和验证的方式方法及注意事项。 2.部署情况 租借的三台设备均部署在五层实验室，通过无线路由器连接到公司网络。 1)账号信息 设备类型设备型号IP地址管理账号密码 枪机DS-2CD2T20-I3admin Nuctech123 录相机DS-8608N-E8admin Nuctech123 球机DS-2DE7184-A admin Nuctech123 2)设备部署&端口映射 3)设备配置注意事项 IPC和NVR均需要通过修改管理员密码才可以激活，然后接入网络； 录相机（NVR）标准配置都是不带硬盘，所以需要事先准备好SATA硬盘； 录相机（NVR）在接入枪机时，自动识别的设备协议为“海康协议”但实际需要根据说 明书修改为ONVIF才可以，否则会一直报“未知错误“； 枪机（IPC）须另备 DC12V Φ圆头电源； 设备因为是租借来的，所以不是全新，建议配置调试之前先做出厂设置； 设备默认出厂IP均为： 3.视频监控 3.1主码流与字码流 主码流与子码流是海康威视提出的概念，是为了解决在网络情况不好时为了满足远程预览的流畅性，而不影响本地录像提出的双码流技术，主码流分辨率高于子码流，主码流用来录像，子码流用来网传，默认客户端访问采用主码流，客户可以根据网络情况选择子码流访问，以达到改善网络浏览的流畅性，而又不改变本地录像的录像效果。 3.2RTSP地址格式 (1)摄像头(IPC/IPD) 地址格式： username: pwd @ ip: port [554]/h264/ch1/码流类型/av_stream 码流类型：main表示为主码流，sub表示为子码流 举例： IPC主码流： number >，1-32是模拟通道，33以后是IP通道。 举例： IPC@NVR：举例： ，设备 信息和配置推荐使用ISAPI接口，云台控制则推荐使用CGI接口。 接口入口地址：，GET表示读取当前信息、PUT表示更新配置、POST表示创建数据、DELETE表示删除配置。 3.3设备信息 3.3.1基本信息 调用地址：/ISAPI/System/deviceInfo PlaceAPI http 接口使用说明 1.1 Place API http 接口简介 Place API http 接口（以下简称http 接口）是一个供程序员调用的、http 形式的地图检索服务接口，且只向百度合作伙伴开放。 目前http 接口提供的功能包括：矩形区域关键字检索、周边区域关键字检索（也称：圆形区域检索）和城市内关键字检索。http 接口主要服务那些非网页程序的调用，例如：C# 、C++、Java 等开发的应用程序，这些开发语言都能发送http 请求且能接收返回数据。http 接口可以返回xml 和json 两种不同形式的的地理数据。 目前提供的功能不是很多、以后随着用户需求的收集和总结，会不断完善http 接口。 1.2 Place API http 接口使用说明 http 接口使用分为3个步骤：第一步，申请注册key ；第二步，拼写http 请求发送的url ，url 中附带上第一步申请的key 值；第三步，接收http 请求返回的数据（json 或xml 格式），如下图示意： 1.2.1申请注册key 说明 用户打开https://www.wendangku.net/doc/463230230.html,/wiki/static/mapws/placeapikey/页面，在此页面中申请注册key 值。该key 主要目的是判断用户请求的url 是否合法，且限制用户1天发送的http 请求数不能超过1000次。注册页面如下图： 填写好信息后，点击生成API密钥按钮就获取到所需的key值了，申请的key值和应用程序名称相关联，既相同的应用程序名称返回的key值是一样的。 特别注意：申请key之前会提示用户首先注册百度账号，只有拥有了百度账号，才能顺利的申请key值。 1.2.2 http接口请求参数说明 http接口请求参数主要包括：检索关键字、检索区域（3种选择形式）、输出结果类型（xml或json）,如下表： HTTP接口文档 接口域名： 一、工作方式....................................................................... 错误!未定义书签。 1.1 密码验证方式............................................................................... 错误!未定义书签。 二、字符编码....................................................................... 错误!未定义书签。 三、响应格式....................................................................... 错误!未定义书签。 四、短信发送（单条，多条发送）...................................... 错误!未定义书签。 五、接收状态报告................................................................ 错误!未定义书签。 5.1 主动获取状态............................................................................... 错误!未定义书签。 六、接收上行短信（回复）................................................. 错误!未定义书签。 6.1 主动接收上行短信（回复） ......................................................... 错误!未定义书签。 6.2 推送接收上行短信（回复） ......................................................... 错误!未定义书签。 七、取剩余短信条数............................................................ 错误!未定义书签。 八、取已发送总条数............................................................ 错误!未定义书签。 九、接口安全（绑定IP）.................................................... 错误!未定义书签。 十、取发送记录 ................................................................... 错误!未定义书签。 一、工作方式 双方通过HTTP方式交互数据，第三方可以简单的“name=value”方式发送提交内容或响应请求内容。即通过HTTP的GET/POST方式交换。 另外双方需要保证数据传输的完整性和安全性，每次发送请求都有响应(响应返回格式为纯文本)，安全验证目前采用用户名、密码和IP绑定的方式。 1.1 密码验证方式 接口密码使用“登录密码”与“用户名”拼接字符串后能过md5加密进行验证 如登录密码是：123123 如用户名是：test 接口密码（pwd）=md5(登录密码+用户名) pwd=md5(123123test) pwd=b9887c5ebb23ebb294acab183ecf0769 二、字符编码 服务器接收数据可以是GBK或UTF-8编码字符,默认接收数据是GBK编码,如提交的是UT F-8编码字符,需要添加参数encode=utf8。 请求响应返回内容是GBK编码。 三、响应格式 所为响应即每次向服务器提交请求后返回值 http接口说明模板 一、查询菜品列表接口(DONE) 1、功能说明 接受提供的菜品 XXX画面XXX功能（比如人口查询画面-查询 | 人口查询画面-详细等） 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDinnerQueryAction?op eration=queryServiceItem 2.2http请求方式 GET 2.3数据返回格式 JSON 2.4传递参数 类型示例描述 参数名称是否 必须 page 是String 1 获取第几个分页的菜 品，默认第一个分页 为1 pageSize 是String 5 每页显示多少个菜 品，默认为5 isFood 是String true 查询食物还是饮料， 查询食物为true 饮料为false 饮料和食物为空 2.5成功返回结果 [ “serverResponse”:”Success”, “totalRecords”:”52”, “page” : “10”, “pageSize” : “5”, “data”：{ “id” : “123”, “itemName” : “皇堡”, “priceNow” : “10”, “pricePast” : “12”, “servicePicture” :”s9118668.jpg”, “serviceStars” : “3” }, ……. { “id” : “”, “itemName” : “”, “priceNow” : “”, “pricePast” : “”, “servicePicture” :” s9118668.jpg”, “serviceStars” : “3” } ] 2.6返回结果解释 参数名称类型描述备注 page String 当前返回的 是第几页 id Int 菜品编号itemName String 菜品名字priceNow String 现价 pricePast String 原价servicePicture String 菜品图片 serviceStars String 菜品星级 公文对外接口说明 一、REST接口 1.导出公文数据接口 接口请求方式： http请求方式：POST http://ip:port/seeyon/rest/edoc/export public void test() { Map 2.导入公文数据接口 接口请求方式： 3.获取公文待签收列表 接口请求说明： http请求方式：GET http://ip:port/seeyon/rest/edocResource/signed?memberId={member Id} 参数说明： 4.获取公文待登记列表 接口请求说明： http请求方式：GET http://ip:port/seeyon/rest/edocResource/registered?memberId={m emberId} 参数说明： 5.导出MHT公文单 接口请求说明： http请求方式：POST http://ip:port/seeyon/rest/edoc/id/exportmht 参数示例： Map res = new HashMap(); String[] SummaryId={"-7993161577072146191"}; res.put("summaryid", SummaryId); res.put("folder", "F:\UFSeeyon\folder\"); 竭诚为您提供优质文档/双击可除java,http协议,接口 篇一：http接口 2.客户端：通过httpinvoker代理向服务器端发送请求，远程调用服务接口的方法 3.服务器端与客户端通信的数据需要序列化 配置服务器端和客户端的步骤 配置服务器端 1.添加springjaR文件 建议使用spring2+.jar版本 2.创建服务接口 3.创建服务接口的具体实现类 4.公开服务 配置客户端 1.添加springjaR文件 建议使用spring2+.jar版本 2.创建服务接口 3.访问服务 实例讲解 服务器端 1.服务接口：ucservice.java 它提供两项服务，查询用户信息和记录日志，如下： publicinterfaceucservice{ publicuserinfogetuserinfobyname(stringusername); publicintrecordlog(stringusername,stringpoint,strin goperate,stringdesc);} 说明：举这个列子是因为其比较有代表性，它将展示普通数据类型（int,long等）和复杂数据类型（dto等）的远程调用方式。userinfo是一个普通的dto，代码如下：publicclassuserinfoimplementsserializable{ privatestaticfinallongserialVersionuid=-69709675067 12260305l; /**用户名*/ privatestringusername; /**电子邮箱*/ privatestringemail; /**注册日期*/ privatedateregistdate; publicstringgetusername(){ 2 HTTP invoker 服务模式 2. 客户端：通过 HTTP invoker 代理向服务器端发送请求，远程调用服务接口的方法 3. 服务器端与客户端通信的数据需要序列化 配置服务器端和客户端的步骤 配置服务器端 1. 添加 springJAR 文件 建议使用 spring2+.jar 版本 2. 创建服务接口 3. 创建服务接口的具体实现类 4. 公开服务 配置客户端 1. 添加 springJAR 文件 建议使用 spring2+.jar 版本 2. 创建服务接口 3. 访问服务 实例讲解 服务器端 1. 服务接口： UcService.java 它提供两项服务，查询用户信息和记录日志，如下： public interface UcService { public UserInfo getUserInfobyName(String userName); public int recordLog(String username, String point, String operate, String desc); } 说明：举这个列子是因为其比较有代表性，它将展示普通数据类型（ int,long 等）和复杂数据类型（ DTO 等）的远程调用方式。 UserInfo 是一个普通的 DTO ，代码如下： public class UserInfo implements Serializable { private static final long serialVersionUID= -6970967506712260305L; /**用户名*/ private String userName ; HTTP接口说明文档 接口地址：http://203.171.227.208:9876/plan/Api/ 请先读这里: 通过API提交参数时, 参数内容编码必须为GB2312, 且经过url编码 例如:“您好”的url编码为“%C4%FA%BA%C3” API返回的内容是一些键值对的字符串集合，形式为:“k1=v1&k2=v2&k3=v3…” 返回内容中的键值显示为url编码形式, 经过url解码后的键值是GB2312编码的字符串 例如: 返回内容“result=0&description=%B7%A2%CB%CD%B3%C9%B9%A6&faillist=”表示的实际内容为“result=0&description=发送成功&faillist=” 1、发送短信 功能描述：短信发送 调用格式：http://203.171.227.208:9876/plan/Api/Send.aspx?username=用户名&password=密码&mobiles=手机号码&content=内容&f=1 返回格式:result=&description=错误描述&faillist=失败号码列表 注：faillist 列表中的号码间隔为英文”,” 返回值: 2、修改密码 功能描述：修改密码 调用格式：http://203.171.227.208:9876/plan/Api/ChgPwd.aspx?username=用户名&password=密码&newpwd=新密码 返回格式:result=&description=错误描述 参数说明： 返回值: 3、查询余额 功能描述：查询余额 调用格式：http://203.171.227.208:9876/plan/Api/Query.aspx?username=用户名&password=密码 返回格式：result=返回值&balance=条数&description=错误描述 注意: 当返回值为0时才同时返回条数 参数说明： 返回值: phpcms v9文章模型栏目接口第三版使用手册 一、简介 1、本接口应用于phpcms v9.2.4 - v9.3.3版文章模型栏目文章发布； 2、本接口支持非默认站点发布； 3、本接口支持自动获取关键词、自动提取缩略图、自动摘要、自动分页、自定义字段等功能，详见发布接口部分说明； 4、支持网站后台栏目生成HTML设置； 5、发布时请使用具有管理权限的用户帐号； 6、本接口基于phpcms v9 UTF8版制作，适用于phpcms v9 GBK/utf-8等版本，应用于其他版本时请自行测试调整； 7、在phpcms v9 utf8版使用本接口时，请在发布规则中选择编码为UTF-8； 8、接口文件无须任何改动即可使用，如果你希望增加校验或其他功能，请仔细修改； 9、2个接口文件请复制在phpcms v9网站根目录下使用； 二、安装接口 在接口文件夹中找到接口文件，如图： 请将etchk_cms.php、etpost_cms.php等接口文件上传到指定目录，请使用二进制方式上传，如图： 三、配置发布规则 1、将范例发布规则文本导入ET2发布配置，或使用软件内置发布规则范例，如图： 2、将检查网址和发布网址中的“您的网站”改为您要发布的网站网址，如图： 3、在检查网址填上您的栏目ID，如图： 4、在检查网址填上您的站点ID，站点ID如留空则默认为1，如图： 5、在参数取值页，填上您要发布的栏目ID和站点ID，如图： 6、在网站后台内容管理-栏目管理处，可以看到各栏目的catid号，如图： 7、在网站后台-设置-站点管理中，可以查看站点ID，如图： 8、填上您的账号、密码，注意格式和账号权限，如图： 游戏数据接口说明 游戏数据接口说明 (1) cboss系统数据接口 (1) Gm平台控制接口 (2) cboss系统数据接口 一、说明： 这里定义了游戏提供给cboss系统的数据结构及操作流程。 二、操作流程： 每个游戏线路，会收集玩家角色在该线路的登录信息，并定时（如：间隔10分钟）发送一次下面定义的所有数据到cboss系统提供的http接口。 三、数据定义： 四、当前在线人数(sum) 五、角色上下线记录(roles) 六、接口定义： http接口使用post协议提交数据，数据使用json格式，并用zip方式压缩；字符串数据使用utf-8编码； json格式：{"num": 当前在线人数, "roles": 角色上下线记录} 角色上下线记录json格式：[[角色名, 等级, 登录时间, 退出时间], ...] 例子：{"num": 100, "roles": [["abc", 10, "1112291212", "1112291812"], ["ddd", 11, "1112291212", "1112291812"]]} 上面例子经过Zip压缩后数据： 'x\x9c\xabV\xca+\xcdU\xb2R040\xd0QP*\xca\xcfI-\x06\xf2\xa2\xa3\x95\x12\x93\x92\x95t\x80\x c2@QCCC##KC#C#%\x04\xcf\x02\xc8\x8b\xd5Q\x88VJII\x01)4\xc4\xab0\xb6\x16\x00\x13\xc3 \x17T' 七、Cboss系统http接口地址： Gm平台控制接口 一、说明： 这里定义了游戏提供给gm系统的数据结构及其操作流程。 二、操作流程： 游戏提供http接口，gm系统使用http POST，调用游戏提供的http 接口。接口数据结构和安全认证，使用dgapi相同的数据结构和认证机制： 认证机制：由游戏方发放gm用户名和key给gm系统。gm系统使用key加密传输的具体数据，并将gm用户名和加密数据post到http接口； 数据加密过程： encrypt_data = DGCrypt.encrypt(key, json_data) 加密的数据= base64.b64encode(encrypt_data) 数据解密过程： encrypt_data = base64.b64decode(加密的数据) json_data = DGCrypt.decrypt(key, encrypt_data) 数据结构：{'client': gm用户名, 'data':加密的数据} 具体细节参考dgapi； 三、接口定义： 说明：http接口处理post协议提交的数据，原始数据使用json格式；数据中的字符串数据使用utf-8编码； a)获取线路列表 请求：{'barea':大区名, 'area':服名} 应答：{'area_key':area_key, 'list':[线路名, chl_key], [....], .....]} 说明： area_key, chl_key代表对应服或线路的唯一标识字符串，需要在后面使用； 大区名、服名，从(https://www.wendangku.net/doc/463230230.html,:8080/config/area_svr.xml)地址获取； b)系统消息发送 请求： 发送到整个服：{'area_key':area_key, 'message':消息, 'chat_scope':'世界', 'chat_type':消息类型, 'view_type':消息的显示位置} 发送到特定线：{'chl_key':chl_key, 'message':消息, 'chat_type':消息类型, 'view_type':消息的显示位置} 应答：{'result':Result, 'fail':失败的原因} 说明：'chat_type'：设定消息的类型：7=系统消息； 'view_type'：设定消息显示的位置：1=滚动位置 c)角色列表查询 概述 在http.client模块中，我们主要使用HTTPConnection和HTTPResponse对象来处理整个HTTP交互过程，所以我们接下里主要介绍以下内容: HTTPConnection HTTPResponse 基本示例 HTTPConnection 先看一下HTTPConnection初始化定义函数 HTTPConnection(host, port=None, [timeout, ] source_address=None) 参数说明 host: 目标服务器IP或url port: 目标服务端口(默认值 http: 80, https: 443), 可选参数 timeout：超时参数，可选 source_address:用于标识链接的来源，格式为(host, port) 一个HTTPConnection实例代表着一个http客户端与服务器端的交互事务，在实例化HTTPConnection时，应该传入目标服务主机（IP或url）和端口，如果没有传递端口，则会从主机字符串中解析端口号（例如 https://www.wendangku.net/doc/463230230.html,:80，则会尝试从该字符串中去解析出80作为交互端口），如果主机字符串中也无端口号，则使用http.client中定义的默认端口(http: 80, https: 443)。如果给出了可选的超时参数(即timeout)，则阻塞操作(如连接尝试)将在许多秒之后超时(如果没有给出，则使用全局缺省超时设置)。 下面看下几种初始化的方式: h1 = http.client.HTTPConnection('https://www.wendangku.net/doc/463230230.html,') h2 = http.client.HTTPConnection('https://www.wendangku.net/doc/463230230.html,:80') h3 = http.client.HTTPConnection('https://www.wendangku.net/doc/463230230.html,', 80) h4 = http.client.HTTPConnection('https://www.wendangku.net/doc/463230230.html,', 80, timeout=10) h5 = http.client.HTTPConnection('https://www.wendangku.net/doc/463230230.html,', 80, timeout=10, source_address= ("https://www.wendangku.net/doc/463230230.html,", 80) > 下面一起看看HTTPConnection提供出来的API，我们主要对常用的API进行简要说明： # http链接初始化 # 返回一个HTTPConnetion实例对象 HTTPConnection(host, port=None, [timeout, ]source_address=None) # https链接初始化 # 返回一个HTTPSConnection实例对象 接口协议说明书 受控状态： 发放号： 2017-07-13发布2017-07-13实施 版权说明 修订页 目录 通信协议说明书 (1) 目录 (4) 1引言 (5) 1.1Restful介绍 (5) 2中心服务器与播放控制器间通信协议 (5) 2.1概述 (5) 2.2用户管理 (5) 2.2.1登录 (5) 1引言 1.1Restful介绍 REpresentational State Transfer (REST) 是一种架构原则，其中将web 服务视为资源，可以由其URL 唯一标识。RESTful Web 服务的关键特点是明确使用HTTP 方法来表示不同的操作的调用。REST 的基本设计原则对典型CRUD 操作使用HTTP 协议方法：POST - 创建资源GET - 检索资源PUT –更新资源DELETE - 删除资源. REST 服务的主要优势在于：它们是跨平台(Java、.net、PHP 等）高度可重用的，因为它们都依赖基本HTTP 协议。它们使用基本的XML/JSON，而不是复杂的SOAP XML，使用非常方便。 2中心服务器与播放控制器间通信协议 2.1概述 云平台中心服务器与播放控制器间的通信采用restful通信协议框架，云平台作为restful服务器，播放控制器作为restful客户端。 登录 2.2用户管理 2.2.1登录 2.2.1.1请求API POST /api/v1/login 2.2.1.2请求参数描述 2.2.1.3请求参数示例 { "account": "admin", "password": "md5(admin)" } 2.2.1.4回应状态码 HTTP接口测试教程 HTTP基础知识介绍： HTTP协议中文名超文本传输协议，适用于OSI七层协议中的应用层，在web应用中使用抓包工具（例如fiddler）可以了解到，一个完整的HTTP协议都包含了请求和响应的过程。请求有开始行、请求头、body构成；响应由状态行、信息头、响应报文构成； 开始行 开始行一般有三部分构成：分别是请求方式、请求地址的相对路径、HTTP的版本，我们需要重点理解一下HTTP的请求方式，HTTP有八种请求方式，分别是： GET 请求获取Request-URI所标识的资源 POST 在Request-URI所标识的资源后附加新的数据 HEAD 请求获取由Request-URI所标识的资源的响应消息报头 PUT 请求服务器存储一个资源，并用Request-URI作为其标识 DELETE 请求服务器删除Request-URI所标识的资源 TRACE 请求服务器回送收到的请求信息，主要用于测试或诊断 CONNECT 保留将来使用 OPTIONS 请求查询服务器的性能，或者查询与资源相关的选项和需求 重点掌握GET请求和POST两种请求方式，他们的区别如下： 第一：GET把参数包含在URL中，POST通过request body传递参数。 第二：GET产生一个TCP数据包；POST产生两个TCP数据包。 第三：GET是获取数据请求；post是提交数据请求，会改变服务器状态 第四：GET 请求不应在处理敏感数据时使用，post较安全 第五：GET参数有长度限制（受限于url长度，具体的数值取决于浏览器和服务器的限制），而post无限制 第六：GET 请求可被缓存 第七：GET 请求保留在浏览器历史记录中 第八：GET 请求可被收藏为书签 信息头：向服务器发送更加详细的参数，常见的参数如下 Accept：浏览器可接受的MIME类型。 Accept - Charset：浏览器可接受的字符集。 Accept - Encoding：浏览器能够进行解码的数据编码方式，比如gzip。Servlet能够向支持gzip 的浏览器返回经gzip编码的HTML页面。许多情形下这可以减少5到10倍的下载时间。Accept - Language：浏览器所希望的语言种类，当服务器能够提供一种以上的语言版本时要用到。 Authorization：授权信息，通常出现在对服务器发送的WWW - Authenticate头的应答中。 Connection：表示是否需要持久连接。如果Servlet看到这里的值为“Keep - Alive”，或者看到请求使用的是HTTP 1.1（HTTP 1.1默认进行持久连接），它就可以利用持久连接的优点，当页面包含多个元素时（例如Applet，图片），显著地减少下载所需要的时间。要实现这一点，Servlet需要在应答中发送一个Content - Length头，最简单的实现方法是：先把内容写入ByteArrayOutputStream，然后在正式写出内容之前计算它的大小。 Resellerclub –API接口说明 说明一 1.进入代理控制面板，点击【设置】-【应用程序接口(API)】，可见下图页面： 2.支持HTTP API和SOAP API(注：SOAP API将要停用，建议使用HTTP API更加简易！) 3.在上图红圈中，需要填入服务器的IP地址进行授权（注：不接受IP段） 4、API说明和测试账户： API说明文档地址：https://www.wendangku.net/doc/463230230.html,/kb/servlet/KBServlet/cat106.html 测试代理账户可在以下地址创建： https://www.wendangku.net/doc/463230230.html,/servlet/ResellerSignupServlet?&validatenow=false 也可以使用下面的账户进行测试： 代理登录信息：https://www.wendangku.net/doc/463230230.html,/reseller rock.h@https://www.wendangku.net/doc/463230230.html, rock123456 客户登录信息：https://www.wendangku.net/doc/463230230.html,/customer test@https://www.wendangku.net/doc/463230230.html, qwer1234 注：请使用测试账户进行API调试。 说明二 ResellerClub所提供的所有产品均有提供Http API接口，不受开发语言限制，代理商可以根据我们提供的说明文档自行整合。下面介绍的是域名API接口的一些简要说明。 1、ResellerClub提供的Http API文档说明地址： https://www.wendangku.net/doc/463230230.html,/kb/answer/752 此链接是关于不同域名参数的说明，其中底部有个示例： https://https://www.wendangku.net/doc/463230230.html,/api/domains/register.json?auth-userid=0&auth-password=password&d omain-name=https://www.wendangku.net/doc/463230230.html,&years=1&ns=https://www.wendangku.net/doc/463230230.html,&ns=https://www.wendangku.net/doc/463230230.html,&customer-id= 0®-contact-id=0&admin-contact-id=0&tech-contact-id=0&billing-contact-id=0&invoice-op tion=KeepInvoice&protect-privacy=true 在上面的地址中有一些参数 Auth-uesrid & auth-password 此处应填代理商的ID号和密码 https://www.wendangku.net/doc/463230230.html, & https://www.wendangku.net/doc/463230230.html, 此处应填代理商的DNS，如果使用我们为代理商提供的DNS记录，请在代理后台默认的四组DNS中选择两组 如果是用我们Demo平台，测试DNS为https://www.wendangku.net/doc/463230230.html, https://www.wendangku.net/doc/463230230.html, Customer-id 填入直接客户的ID，由于ResellerClub是走代理渠道的，所有产品需要以直接客户身份来购买 Reg-contact-id & admin-contact-id & tech-contact-id & billing-contact-id 请填入直接客户联系信息的ID，这些信息将用于域名whois信息，具体可以通过在直接客户后台--域名--联系人管理--列表查看到这些联系信息的ID 另外需要注意的是，请保证代理账户和直接客户账户上有余额，此外，有些域名后缀对于联系信息的要求有所差异，请认真核对。 说明三 如果您是用的WINIIS（慧林）的主机管理系统，该系统默认有整合我们的API域名接口，您只需要填写相应的参数和设置。 1、首先在我们代理后台--设置--应用程序接口（API）填上你的IP地址 2、在慧林后台找到设置我司接口的地方（LogicBoxes API） LogicBoxes用户名填入代理账户的用户名即邮箱地址 LogicBoxes密码填入代理账户的密码 LogicBoxes父ID号在代理后台--设置--个人信息--主要资料可查看该父ID号 LogicBoxes客户ID 直接客户的ID号 LogicBoxes主DNS LogicBoxes辅DNS 这两个填代理商在我们后台设置的默认DNS，如果是用我们提供的免费DNS服务，可以挑选任意两组填上。 竭诚为您提供优质文档/双击可除 http协议的接口测试 篇一：如何做接口测试 如何做好接口测试？ 发布时间:20xx-1-1910:44作者:小刀来源:51testing 软件测试论坛 字体:小中大|上一篇下一篇|打印|我要投稿|推荐标签：软件测试接口测试sgbtmy：基于selenium的自动化框架开发，我主要是想问一下，你的框架除了前台的自动化，后台的数据的测试是否集成在你的测试框架中？ 小刀：你好，个人理解的你所说的后台的数据的测试是指的是对数据的校验，不知理解的是否正确，那么根据这个理解，我的解释是，在我们框架中，增加了很多的功能方法用来帮助进行自动化脚本的编写和结果校验，其中就包括后台数据校验方法，当我们的测试用例需要在后台进行数据校验的时候，调用这些数据校验方法即可。相当于是，前台页面操作的自动化是封装selenium的方法去操作页面，而对 后台数据的校验是通过增加功能方法来实现的，可以理解为不同的两部分，但是在编写测试脚本的似乎，根据测试用例 的设计，这两部分都可以拿过来使用。 不知道是否解答了你的疑问，如果没有，请你指出，谢谢你。 tjy688：你们做接口测试的流程一般是怎么样的？ 小刀：接口测试的流程其实和功能测试的流程类似，因为接口测试依赖的主要对象也是需求说明书，所以，最初的流程就是参与需求讨论，评审需求。 需求确定以后，开发会根据需求进行接口设计，会产出接口定义，在开发设计过程中，有能力的话，可以给出一些针对设计的建议，提高可测性，针对需求及设计，进行测试计划，测试设计，然后还需要和配管确定测试环境相关的事情。 在开发完成接口定义之后，就根据需求文档及接口定义进行测试用例设计，测试用例设计主要从业务场景，功能，以及异常测试几个方面考虑。 测试用例设计完成后，针对测试用例进行评审，然后，如果开发代码部分可测时，即可进入测试了，因为是部分可测，可能会使用到mock方法。 已有测试代码时，就要进行测试代码的持续集成了，我们是使用hudson来进行持续集成的在项目结束后，会对每个项目进行总结。 如果有问题，请指出，我们一起讨论。 http接口说明模板 查询菜品列表接口（DONE） 1、功能说明 接受提供的菜品 XXX画面XXX功能（比如人口查询画面-查询I人口查询画面-详细等）2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDi nn erQueryActio n?op erati on=queryServiceltem 2.2http 请求方式 GET 2.3数据返回格式 JSON 2.4传递参数 2.5成功返回结果 [ “totalRecords ” : ” 52”， page : 10 , “ data ”：{ “ id ”：“ 123”， “itemName : “皇堡”， “ pricePast ” : “ 12” , “servicePicture ”：” s9ii8668.jpg “ serviceStars ” : “ 3” }， “servicePicture”：” s9ii8668.jpg 】、查询广告接口（DONE 1、功能说明 接受广告图片，目前为一张 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDi nn erQueryActio n?op erati on=queryAdvertisePicture 2.2http 请求方式 GET 2.3数据返回格式 JSON 2.4传递参数 2.5成功返回结果 { “advertisePicture ” : “ 0f736a68b929b0955b319ebc41336.jpg } 2.6返回结果解释 三、查询订单列表接口（DONE） 1、功能说明 根据指定的客户id查询订单 2、接口调用说明 2.1获取地址 http://192.168.0.6:8080/FamilyServiceSystem/BookDi nn erQueryActio n?op erati on=queryServiceOrderListhttp接口说明模板
海康威视摄像头HTTP接口能力调研报告
Place API http接口使用说明
HTTP接口文档
http接口说明模板
公文对外接口说明
java,http协议,接口
http接口
短信HTTP接口说明文档
接口说明
游戏数据接口说明
[接口测试 - http.client篇] 15 常用API说明及基本的示例
restfu接口文档模板
http接口测试
API接口说明
http协议的接口测试
http接口说明模板