step1:选择本文所示例的接口"全国天气预报接口" 聚合数据url:http://www.juhe.cn/docs/api/id/39/aid/87
step2:每个接口都需要传入一个参数key,相当于用户的令牌,所以第一步你需要申请一个key.
step3:学过java的同学们都知道,当我们对一个类或者方法不明白其意图和思想时,我们可以去查看文档,这里也不例外,而且对于英文不是特别好的同学来说很幸运的是,聚合网站上的文档都是中文版本的,比起阅读java源码里的英文文档应该轻松很多.全国天气预报接口下面有六个子接口,打开第一个接口链接,看文档发现需要传入一个城市名或者城市ID参数,这个参数我们可以通过第六个子接口获取(接口之间参数的调用类似于java中方法之间的调用),即支持城市列表获取.所以示例中我们先调用这个接口.调用接口涉及到请求网络资源的问题,这里我封装了一个工具类,包含GET和POST两种方法.
step4:代码如下：
Demo1:网络访问工具类(封装get和post方法)
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
package
juheAPI;import
java.io.BufferedReader;import
java.io.BufferedWriter;import
java.io.InputStream;import
java.io.InputStreamReader;import
java.io.OutputStream;import
java.io.OutputStreamWriter;import
java.net.HttpURLConnection;import
java.net.URL;import
java.util.Map;/** *
网络访问工具类 *
@author silk * */public
class
PureNetUtil { /** *
get方法直接调用post方法 *
@param url 网络地址 *
@return 返回网络数据 */ public
static
String get(String url){ return
post(url,null); } /** *
设定post方法获取网络资源,如果参数为null,实际上设定为get方法 *
@param url 网络地址 *
@param param 请求参数键值对 *
@return 返回读取数据 */ public
static
String post(String url,Map param){ HttpURLConnection
conn=null; try
{ URL
u=new
URL(url); conn=(HttpURLConnection)
u.openConnection(); StringBuffer
sb=null; if(param!=null){//如果请求参数不为空 sb=new
StringBuffer(); /*A
URL connection can be used for input and/or output. Set the DoOutput *
flag to true if you intend to use the URL connection for output, *
false if not. The default is false.*/ //默认为false,post方法需要写入参数,设定true conn.setDoOutput(true); //设定post方法,默认get conn.setRequestMethod("POST"); //获得输出流 OutputStream
out=conn.getOutputStream(); //对输出流封装成高级输出流 BufferedWriter
writer=new
BufferedWriter(new
OutputStreamWriter(out)); //将参数封装成键值对的形式 for(Map.Entry
s:param.entrySet()){ sb.append(s.getKey()).append("=").append(s.getValue()).append("&"); } //将参数通过输出流写入 writer.write(sb.deleteCharAt(sb.toString().length()-1).toString()); writer.close();//一定要关闭,不然可能出现参数不全的错误 sb=null; } conn.connect();//建立连接 sb=new
StringBuffer(); //获取连接状态码 int
recode=conn.getResponseCode(); BufferedReader
reader=null; if(recode==200){ //Returns
an input stream that reads from this open connection //从连接中获取输入流 InputStream
in=conn.getInputStream(); //对输入流进行封装 reader=new
BufferedReader(new
InputStreamReader(in)); String
str=null; sb=new
StringBuffer(); //从输入流中读取数据 while((str=reader.readLine())!=null){ sb.append(str).append(System.getProperty("line.separator")); } //关闭输入流 reader.close(); if
(sb.toString().length() == 0)
{ return
null; } return
sb.toString().substring(0, sb.toString().length()
- System.getProperty("line.separator").length()); } }
catch
(Exception e) { e.printStackTrace(); return
null; }finally{ if(conn!=null)//关闭连接 conn.disconnect(); } return
null; } } |
Demo2:调用获取城市列表接口示例
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
package
juheAPI;import
net.sf.json.JSONArray;import
net.sf.json.JSONObject;/** *
获取城市列表 *
全国天气预报接口调用JAVA示例 *
dtype string N 返回数据格式：json或xml,默认json *
key string Y 你申请的key *
@author silk * */public
class
GetCityList { /** *
调用获取城市列表接口,返回所有数据 *
@return 返回接口数据 */ public
static
String excute(){ //PureNetUtil是一个封装了get和post方法获取网络请求数据的工具类 return
PureNetUtil.get(url);//使用get方法 } /** *
调用接口返回数据后,解析数据,根据输入城市名得到对应ID *
@param cityName 城市名称 *
@return 返回对应ID */ public
static
String getIDBycityName(String cityName) { String
result=excute();//返回接口结果,得到json格式数据 if(result!=null){ JSONObject
obj=JSONObject.fromObject(result); result=obj.getString("resultcode");//得到返回状态码 if(result!=null&&result.equals("200")){//200表示成功返回数据 result=obj.getString("result");//得到城市列表的json格式字符串数组 JSONArray
arr=JSONArray.fromObject(result); for(Object
o:arr){//对arr进行遍历 //将数组中的一个json个数字符串进行解析 obj=JSONObject.fromObject(o.toString()); /*此时obj如
{"id":"2","province":"北京","city":"北京","district":"海淀"}*/ //以city这个key为线索判断所需要寻找的这条记录 result=obj.getString("district"); //防止输入城市名不全,如苏州市输入为苏州,类似与模糊查询 if(result.equals(cityName)||result.contains(cityName)){ result=obj.getString("id");//得到ID return
result; } } } } return
result; } public
static
void
main(String[] args) { System.out.println(getIDBycityName("香港")); }} |
Demo3:调用根据城市名/id查询天气
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
package
juheAPI; import
net.sf.json.JSONObject; /** *
根据城市名/id查询天气 *
@author silk * */public
class
WeatherReportByCity { /** *
根据城市名获取 *
@param cityName *
@return */ public
static
String excute(String cityName){ String
url=//此处以返回json格式数据示例,所以format=2,以根据城市名称为例,cityName传入中文 return
PureNetUtil.get(url);//通过工具类获取返回数据 } /** *
获取返回数据中的一个属性示例,此处以获取今日温度为例 *
"temperature": "8℃~20℃" 今日温度 *
@param args *
@return */ public
static
String GetTodayTemperatureByCity(String city) { String
result=excute(city); if(result!=null){ JSONObject
obj=JSONObject.fromObject(result); /*获取返回状态码*/ result=obj.getString("resultcode"); /*如果状态码是200说明返回数据成功*/ if(result!=null&&result.equals("200")){ result=obj.getString("result"); //此时result中数据有多个key,可以对其key进行遍历,得到对个属性 obj=JSONObject.fromObject(result); //今日温度对应的key是today result=obj.getString("today"); obj=JSONObject.fromObject(result); //今日温度对应当key是temperature result=obj.getString("temperature"); return
result; } } return
result; } public
static
void
main(String[] args) { System.out.println(GetTodayTemperatureByCity("苏州")); }} |
Demo4:调用天气种类及表示列表接口示例
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
package
juheAPI;import
net.sf.json.JSONArray;import
net.sf.json.JSONObject;/** *
天气种类及标识列表接口调用JAVA示例 *
@author silk */public
class
GetWeatherSignAndTypeList { //接口地址,因为只需要传入一个固定的key为参数,所以设为常量 private
static
final
String URL= "http://v.juhe.cn/weather/uni?key=***a7558b2e0bedaa19673f74a6809ce"; /** *
通过工具类获取数据 *
@return */ public
static
String excute(){ return
PureNetUtil.get(URL);//调用工具类获取接口数据 } /** *
利用遍历数组的方式获取 *
@param wid天气对应id *
@return 天气名称 */ public
static
String getWeatherByWid(String wid) { String
result=excute();//获取接口数据 if(result!=null){ JSONObject
obj=JSONObject.fromObject(result); result=obj.getString("resultcode"); /*获取返回状态码*/ if(result!=null&&result.equals("200")){ /*获取数组数据*/ result=obj.getString("result"); JSONArray
arr=JSONArray.fromObject(result); for(Object
o:arr){//遍历数组 obj=JSONObject.fromObject(o.toString()); //如果遍历到需要的数据后直接返回结果,根据key(wid)得到value判断是否等于传入参数 if(obj.getString("wid").equals(wid)){ result=obj.getString("weather"); return
result; } } } } return
result; } public
static
void
main(String[] args) { System.out.println(getWeatherByWid("10")); } |
