基于http协议的接口测试(2)

一）.接口约定：
1、接口均采用http协议，Get方法。

2、城市公交请求参数为app_key、city、start_addr、end_addr，app_key为需要你申请密钥key

http://openapi.aibang.com/bus/transfer?app_key=????&city=????&start_addr=????&end_addr=????

如果不清楚请求协议的方法，可以使用F12 -网络查看具体的参数列表和使用的请求方法

二）.参数列表：

参数说明

参数	类型	是否可选	意义	备注
city	string	否	城市
start_addr	string	是	起点	如：五道口，与start_lng和start_lat不能都为空
end_addr	string	是	终点	如：东直门，与end_lng和end_lat不能都为空
start_lng	float	是	起点经度
start_lat	float	是	起点纬度
end_lng	float	是	终点经度
end_lat	float	是	终点纬度
rc	int	是	排序方式	默认是0，定义如下： 0：综合排序 1：换乘次数 2：步行距离 3：时间 4：距离 5：地铁优先
count	int	是	最大返回记录数量	默认为10，最大值不能超过10
with_xys	int	是	是否包含坐标信息	默认为0，不包含各个站点和路线的坐标信息，如果为1，则包含

该API返回换乘方案。

字段	类型	意义	备注
result_num	int	结果数量
web_url	string	爱帮web站对应url
wap_url	string	爱帮wap站对应url
dist	int	总距离	单位：米
time	int	估计耗费时间	单位：分钟
foot_dist	int	总步行距离	单位：米
last_foot_dist	int	从终点站走到终点的距离	单位：米
start_stat	string	起点站名
end_stat	string	终点站名
line_name	string	线路名称
stats	string	沿途站点	半角分号;（英文分号）分隔
line_dist	int	行驶距离	单位：米
foot_dist	int	步行距离	单位：米
stat_xys	string	途径站点经纬度	经度与纬度用半角逗号,（英文逗号）分隔；每组经纬度用半角分号;（英文分号）分隔
line_xys	string	途径线路经纬度	经度与纬度用半角逗号,（英文逗号）分隔；每组经纬度用半角分号;（英文分号）分隔

三).样例：

http://openapi.aibang.com/bus/transfer?app_key=f41c8afccc586de03a99c86097e98ccb&city=%E6%B7%B1%E5%9C%B3&start_addr=%E6%B0%91%E5%BA%B7%E8%B7%AF%E5%8F%A3&end_addr=%E4%B8%96%E7%95%8C%E4%B9%8B%E7%AA%97

成功应答数据（http包体数据）：

<?xml version="1.0" encoding="utf-8" ?>
<root>
<result_num>10</result_num><web_url>http://bus.aibang.com</web_url><wap_url>http://wap.aibang.com</wap_url><buses>
<bus><dist>16075</dist><time>55</time><foot_dist>954</foot_dist><last_foot_dist>235</last_foot_dist><segments><segment>
<start_stat>梅龙路公交站</start_stat><end_stat>朗山路口</end_stat><line_name>高峰专线7(梅龙路公交站-科苑南公交总站)</line_name>
<stats>梅龙路公交站;横岭工业区;横岭;惠鑫公寓(1);北环铜鼓天桥;朗山路中;朗山路口</stats><line_dist>15121</line_dist>
<foot_dist>719</foot_dist><stat_xys></stat_xys><line_xys></line_xys></segment></segments>
</bus>
</root>

失败应答数据（http包体数据）：

<?xml version="1.0" encoding="utf-8" ?>
<root><message>api不支持!</message></root>

实现代码如下：

String url="http://openapi.aibang.com/bus/transfer?";
String app_key="f41c8afccc586de03a99c86097e98ccb";
String city="深圳";
String start_addr="东泉新村";
String end_addr="科技园";


@Test
public void test1() throws ParseException, UnsupportedEncodingException, IOException, URISyntaxException, JSONException{
	//初始化httpclient  
	HttpClient httpclient = new DefaultHttpClient();
	//获取httpget 
	HttpGet httpget = new HttpGet(url);
	//添加参数
	List<NameValuePair> namevaluepair = new ArrayList<NameValuePair>();
	namevaluepair.add(new BasicNameValuePair("app_key", app_key));
	namevaluepair.add(new BasicNameValuePair("city", city));
	namevaluepair.add(new BasicNameValuePair("start_addr", start_addr));
	namevaluepair.add(new BasicNameValuePair("end_addr", end_addr));
	 // 设置报文头以及格式
	httpget.addHeader("Content-type","application/x-www-form-urlencoded");
	httpget.addHeader("Accept-Language", "zh-cn, zh;q=0.75, en-us;q=0.50, en;q=0.25");
      String str = EntityUtils.toString(new UrlEncodedFormEntity(namevaluepair,"utf-8"));  
      httpget.setURI(new URI(httpget.getURI().toString()  + str)); 
      System.out.println("请求地址："+url+str);
      // 发送请求  
      HttpResponse httpresponse = httpclient.execute(httpget);  
      //读取返回的数据  
      String  body = EntityUtils.toString(httpresponse.getEntity());
     
      System.out.println(body);
      System.out.println("------------------");
                   
      //关闭连接
     	httpclient.getConnectionManager().shutdown();  
}

关于get方式设置请求头的问题，最令人头疼：
   1）、列出的四种请求头一般情况下已够用，无需添加。
   2）、要特别注意accept-encoding的值，有两种:gzip, deflate 和utf-8, deflate。
 gzip是经过压缩的大量数据的，一般不常用；
 utf-8符合一般使用规律，具体可以两种都尝试一下，或者干脆不加该请求头。

//设置请求头，这里很关键，细节在注意事项中描述  
   httpGet.setHeader("user-agent", "Mozilla/5.0 (Windows NT 5.1; rv:8.0.1) Gecko/20100101") ;  
   httpGet.setHeader("accept", "*/*") ;  
   httpGet.setHeader("accept-language", "zh-CN") ;  
   httpGet.setHeader("accept-encoding", "utf-8, deflate") ; 

-----------------------TestNg执行完成输出的日志

请求地址：http://openapi.aibang.com/bus/transfer?app_key=f41c8afccc586de03a99c86097e98ccb&city=%E6%B7%B1%E5%9C%B3&start_addr=%E4%B8%9C%E6%B3%89%E6%96%B0%E6%9D%91&end_addr=%E7%A7%91%E6%8A%80%E5%9B%AD
<?xml version="1.0" encoding="utf-8" ?>
<root>
<result_num>10</result_num><web_url>http://bus.aibang.com</web_url><wap_url>http://wap.aibang.com</wap_url><buses>
<bus><dist>16075</dist><time>55</time><foot_dist>954</foot_dist><last_foot_dist>235</last_foot_dist><segments><segment>
<start_stat>梅龙路公交站</start_stat><end_stat>朗山路口</end_stat><line_name>高峰专线7(梅龙路公交站-科苑南公交总站)</line_name>
<stats>梅龙路公交站;横岭工业区;横岭;惠鑫公寓(1);北环铜鼓天桥;朗山路中;朗山路口</stats><line_dist>15121</line_dist>
<foot_dist>719</foot_dist><stat_xys></stat_xys><line_xys></line_xys></segment></segments>
</bus>
</root>
PASSED: test1