第一章：Android Studio (和风天气API和SDK开发)

最新推荐文章于 2023-03-02 01:35:36 发布

Rx_ing

最新推荐文章于 2023-03-02 01:35:36 发布

阅读量4.2k

点赞数 5

文章标签： android json sdk wapi asynctask

本文链接：https://blog.csdn.net/weixin_46039219/article/details/103579018

版权

Android Studio 请求和风天气数据（API和SDK两种方式）并解析返回的JSON数据
本文纯菜鸟笔记，两个模块：

一、 Web API请求
二、Android SDK请求

和风天气
和风天气提供商业收费和免费接口（个人开发者可以直接注册申请免费接口），在此只讨论Android Studiio API和SDK的操作过程（菜鸟笔记，有错希望能帮忙指出）
和风天气API开发文档 ----------------------- 和风天气SDK开发文档
API方式是Web服务端提供了接口，开发者需了解接口接入方式和建立对应的解析文件
SDK方式是已经封装好的软体开发工具包，方便开发快速开发

编码之前事先需要在和风官网注册账号，新建应用，添加KEY。
（官网操作简单，要注意的是API开发的KEY和SDK的KEY是两个不同的KEY）

一、Web API请求

1、调用AsyncTask类请求网络数据，得到返回的JSON格式的数据；
2.0、用JSONObject类一一解析出对应的JSON数据，并文本显示。
2.1、或者用GSON解析（推荐）结构清晰，易于维护。

1、AsyncTask请求


private StringBuilder sb = new StringBuilder("");
private StringBuilder sbmsg = new StringBuilder("");
private InputStream is = null;
private BufferedReader br = null;
private String msg = "",Location="",WebKey="";
//异步请求类，WebKey是web api key值，location可以是地名也可以是经纬度等等。。。
private class DownloadTask extends AsyncTask<Void, Integer, Boolean> {
    String url = "https://free-api.heweather.net/s6/weather/now?key="+WebKey+"&location=" + Location;

    @Override
    protected Boolean doInBackground(Void... count) {
        try {
            URL uri = new URL(url);
            HttpURLConnection connection = (HttpURLConnection) uri.openConnection();
            connection.setRequestMethod("GET");     //GET方式请求数据
            connection.setReadTimeout(5000);
            connection.setConnectTimeout(5000);
            connection.connect();   //开启连接
            if (connection.getResponseCode() == HttpURLConnection.HTTP_OK) {
                is = connection.getInputStream();
                //参数字符串，如果拼接在请求链接之后，需要对中文进行 URLEncode   字符集 UTF-8
                br = new BufferedReader(new InputStreamReader(is, "UTF-8"));
                String line;
                while ((line = br.readLine()) != null) {    //缓冲逐行读取
                    sb.append(line);
                }
                String jmsg = sb.toString();        //接收结果，接收到的是JSON格式的数据
                getweather weather = new getweather();
                msg = weather.JXJSON(jmsg);     //解析接收到的和风now天气json数据
            }else{
                msg = "获取天气失败";
            }
        } catch (Exception ignored) {
            msg = "获取天气异常";
        }
        return true;
    }
    //结束接收
    @Override
    protected void onPostExecute(Boolean result) {
        ring.setVisibility(View.GONE);
        try {
            if (is != null) {
                is.close();
            }
            if (br != null) {
                br.close();
            }
        } catch (Exception ignored) {}
        if (result) {
            tvlog.setText(msg);
            tvlog.setVisibility(View.VISIBLE);    //文本显示解析后的结果
        } else {
            Toast.makeText(context, "获取天气失败", Toast.LENGTH_LONG).show();
        }
    }
}`

2.0、JSONObject 解析


import org.json.JSONArray;
import org.json.JSONObject;

/**
 * Created by Hesiod on 2018/10/01.
 */

public class getweather {
    private StringBuilder sbmsg = new StringBuilder("");
    //解析JSON
    public String JXJSON(String jmsg) {
        try {
            JSONObject ObjMsg = new JSONObject(jmsg);              //和风数据最外层是个大括号对象{}
            JSONArray ListMsg = ObjMsg.getJSONArray("HeWeather6");    //大对象下存放的是很一个数组list[]
            for (
                    int i = 0;
                    i < ListMsg.length(); i++) {   //因为前面链接里只请求了now天气数据，所以这里list长度只为1
                JSONObject jsonObject = ListMsg.getJSONObject(i);     //这个数组下有四个对象{}，key分别为basic，update，status，now
                //第一个对象
                JSONObject ObjBasic = jsonObject.getJSONObject("basic");  //basic里面对应的是类
                sbmsg.append("城市ID:").append(ObjBasic.getString("cid")).append("\r\n");
                sbmsg.append("区:").append(ObjBasic.getString("location")).append("\r\n");
                sbmsg.append("市:").append(ObjBasic.getString("parent_city")).append("\r\n");
                sbmsg.append("省:").append(ObjBasic.getString("admin_area")).append("\r\n");
                sbmsg.append("国家:").append(ObjBasic.getString("cnty")).append("\r\n");
                sbmsg.append("纬度:").append(ObjBasic.getString("lat")).append("\r\n");
                sbmsg.append("经度:").append(ObjBasic.getString("lon")).append("\r\n");
                sbmsg.append("时区:").append(ObjBasic.getString("tz")).append("\r\n");
                //第二个对象
                JSONObject ObjUpdate = jsonObject.getJSONObject("update");  //update里面对应的是类
                sbmsg.append("当地时间:").append(ObjUpdate.getString("loc")).append("\r\n");
                sbmsg.append("UTC时间:").append(ObjUpdate.getString("utc")).append("\r\n");
                //第三个对象，status下是字符型数据
                sbmsg.append("接口状态:").append(jsonObject.getString("status")).append("\r\n");
                //第四个对象，
                JSONObject ObjNow = jsonObject.getJSONObject("now");  //now里面对应的是类
                sbmsg.append("云量:").append(ObjNow.getString("cloud")).append("\r\n");
                sbmsg.append("天气代码:").append(ObjNow.getString("cond_code")).append("\r\n");
                sbmsg.append("天气描述:").append(ObjNow.getString("cond_txt")).append("\r\n");
                sbmsg.append("体感温度（℃）:").append(ObjNow.getString("fl")).append("\r\n");
                sbmsg.append("湿度:").append(ObjNow.getString("hum")).append("\r\n");
                sbmsg.append("降水量:").append(ObjNow.getString("pcpn")).append("\r\n");
                sbmsg.append("气压:").append(ObjNow.getString("pres")).append("\r\n");
                sbmsg.append("温度（℃）:").append(ObjNow.getString("tmp")).append("\r\n");
                sbmsg.append("能见度:").append(ObjNow.getString("vis")).append("\r\n");
                sbmsg.append("风向角度:").append(ObjNow.getString("wind_deg")).append("\r\n");
                sbmsg.append("风向:").append(ObjNow.getString("wind_dir")).append("\r\n");
                sbmsg.append("风力:").append(ObjNow.getString("wind_sc")).append("\r\n");
                sbmsg.append("风速:").append(ObjNow.getString("wind_spd")).append("\r\n");
            }
        } catch (Exception ex) {
            return "解析天气失败";
        }
        return sbmsg.toString();
    }
}

2.1、GSON解析
1、首先得先在build.gradle添加依赖

compile 'com.google.code.gson:gson:2.7'

2、根据官方给出的数据例子，创建jsonbean类，这里我添加了lombox插件，所以省略了编写get/set方法，有兴趣的可以参考第二章：Android Studio lombok插件

import java.util.ArrayList;
import java.util.List;
import lombok.Data;
/**
 * Created by Hesiod on 2018/10/11.
 */
@Data
public class BasicNowBean {
    private List<BasicNow> HeWeather6 = new ArrayList<>();
    @Data
    public class BasicNow {
        private basic basic;
        private update update;
        private String status;
        private now now;
    }
    @Data
    public class basic {
        String cid, location, parent_city, admin_area, cnty, lat, lon, tz;
    }
    @Data
    public class update {
        String loc, utc;
    }
    @Data
    public class now {
        private String fl, tmp, cond_code, cond_txt, hum, pcpn, pres, vis;
        private String cloud, wind_deg, wind_dir, wind_sc, wind_spd;
    }
}

3、使用GSON解析到上面建立的BasicNowBean类
(将全部的数据都解析到了BasicNowBean类中，但这里只提取了BasicNowBean.now里面的数据，与前面第四个对象段效果完全相同)

//第四个对象，
Gson gson = new Gson();
BasicNowBean basicNo**wBean = gson.fromJson(jmsg,ne**w TypeToken<BasicNowBean>(){}.getType());
BasicNowBean.now nowBean = basicNowBean.getHeWeather6().get(0).getNow();
sbmsg.append("云量:").append(nowBean.getCloud()).append("\r\n");
sbmsg.append("天气代码:").append(nowBean.getCond_code()).append("\r\n");
sbmsg.append("天气描述:").append(nowBean.getCond_txt()).append("\r\n");
sbmsg.append("体感温度（℃）:").append(nowBean.getFl()).append("\r\n");
sbmsg.append("湿度:").append(nowBean.getHum()).append("\r\n");
sbmsg.append("降水量:").append(nowBean.getPcpn()).append("\r\n");
sbmsg.append("气压:").append(nowBean.getPres()).append("\r\n");
sbmsg.append("温度（℃）:").append(nowBean.getTmp()).append("\r\n");
sbmsg.append("能见度:").append(nowBean.getVis()).append("\r\n");
sbmsg.append("风向角度:").append(nowBean.getWind_deg()).append("\r\n");
sbmsg.append("风向:").append(nowBean.getWind_dir()).append("\r\n");
sbmsg.append("风力:").append(nowBean.getWind_sc()).append("\r\n");
sbmsg.append("风速:").append(nowBean.getWind_spd()).append("\r\n");

两种解析方法对比下，是否觉得GSON方法解析过程更清晰！

二、Android SDK请求

1、官网下Android SDK包，并复制到project–>app–>libs下
2、gradle 添加

compile files('libs/HeWeather_Public_Android_V3.1.jar')
compile 'com.squareup.okhttp3:okhttp:3.9.0'
compile 'com.google.code.gson:gson:2.6.2'

3、在aplication全局类下oCreate里加入，这里已经设置了全局的SDK key变量，所以后面就不用再写了

//和风天气,用户名，Android SDK key:
HeConfig.init("UserNamexxxxx自己申请", "AndroidSdkKeyxxxxxx自己申请");
//设置为免费连接
HeConfig.switchToFreeServerNode()

4、在ProGuard rules.pro混淆文件后加入
5、并别忘了声明网络权限

// 排除okhttp
  -dontwarn com.squareup.**
  -dontwarn okio.**
  -keep public class org.codehaus.* { *; }
  -keep public class java.nio.* { *; }

// 排除HeWeather
  -dontwarn interfaces.heweather.com.interfacesmodule.**
  -keep class interfaces.heweather.com.interfacesmodule.** { *;}

5、调用获取数据类，这里只举例官网例出的获取Basic基本类，关于NowBase获取now天气数据请参考官网例子，查看一下Basic基本类源码就对照官网文档就可以直接提取所要的信息了。

HeWeather.getSearch(context, location,"",1, Lang.CHINESE_SIMPLIFIED, new HeWeather.OnResultSearchBeansListener(){
    @Override
    public void onError(Throwable e) {
        Toast.makeText(clientmap.this, "获取城市失败:"+e, Toast.LENGTH_LONG).show();
    }

    @Override
    public void onSuccess(Search dataObject) {
        if ( Code.OK.getCode().equalsIgnoreCase(dataObject.getStatus()) ) {
            //此时返回数据，这是个数据类
            try {
                List<Basic> basiclist = dataObject.getBasic();
                Basic basic = basiclist.get(0);	  //因为只有1个列表所以直接选0
                StringBuilder strb = new StringBuilder();
                strb.append("位置：\n");
                strb.append(basic.getCnty()).append("\r");//国
                strb.append(basic.getAdmin_area()).append("\r");//省
                strb.append(basic.getParent_city()).append("\r");//市
                strb.append(basic.getLocation()).append("\n\n");//区
                //strb.append(tvlog.getText());	//其他数据
                tvlog.setText(strb);	//文本显示解析后的数据
            } catch (Exception e) {
                Toast.makeText(context, "获取城市失败:", Toast.LENGTH_LONG).show();
            }
        }else {
            //在此查看返回数据失败的原因
            String status = dataObject.getStatus();
            Code code = Code.toEnum(status);
            Toast.makeText(context, "获取城市失败:"+code.getTxt(), Toast.LENGTH_LONG).show();
        }
    }
});

以上就是这两种请求方法，API方法就是什么都要自己一步步了解、构建、解析，SDK方法就可以照搬就行，达到快速开发的效果。其实都可以参考官网给出的资料和历程结合编写，只是有些许地方不能很顺利，不能直接复制粘贴，但稍微研究理解后就会觉得官网给的才是最好的。
----------------------纯菜鸟笔记，欢迎指出错误，一起学习。