共计 6090 个字符,预计需要花费 16 分钟才能阅读完成。
查问天气预报在 APP 中罕用的一个罕用性能,聚合数据天气数据 api 能够依据依据城市名 /id 查问天气、依据 IP 查问天气、据 GPS 坐标查问天气、查问城市天气三小时预报,并且反对全国不同城市天气预报查问。
代码形容:基于 JAVA 的天气数据 api 调用示例,依据文档中注明的需要参数, 调用接口返回数据。
关联数据:天气数据 api
接口地址:https://www.juhe.cn/docs/api/id/39
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 办法)
Java code
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 <K, V> String post(String url,Map<K,V> 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: 调用获取城市列表接口示例
Java code
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(){
String url="http://v.juhe.cn/weather/citys?key=***a7558b2e0bedaa19673f74a6809ce";// 接口 URL
//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 查问天气
Java code
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 传入中文
"http://v.juhe.cn/weather/index?cityname="+cityName+"&key=***a7558b2e0bedaa19673f74a6809ce";
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: 调用天气品种及示意列表接口示例
Java code
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"));
}
}
step5: 调用接口时候如果状态码不是 200, 认真参考文档阐明, 也就是返回 step3: 看文档!