安卓/JAVA获取天气数据（气象状况，温度等）全过程（以和风天气为例子）

本文链接：https://blog.csdn.net/krehizi/article/details/82216650

利用OkHttp库来访问网络,获取和风天气的数据

一.声明网络权限和导入OkHttp库:

<uses-permission android:name="android.permission.INTERNET"/>

implementation 'com.squareup.okhttp3:okhttp:3.4.1'

二.新建一个客户端:

OkHttpClient client = new OkHttpClient();

三.获取访问和风天气接口URL:

String weatherURL = "https://free-api.heweather.com/s6/weather/forecast?location=CN101010100&key=XXXXXXXX";

注意:其中的Key=XXXXXXX,需要你自行注册和风天气,并填入获取到相应的密钥,而location=CN101010100中的CN101010100即是代表北京的代码(此处和风天气的接口也支持直接中文),所以此处我们查询到的数据就是北京的天气数据,具体用法见和风天气官方.

四.新建请求:

Request request = new Request.Builder()
        .url(weatherURL)
        .build();

五.发送请求,并捕获和风服务器返回的JSON格式的天气数据:

try {
    Response response = client.newCall(request).execute();
    String responseData = response.body().string();
} catch (IOException e) {
    e.printStackTrace();
}

获取到的JSON格式的数据是字符串形式的,所以我们利用responseData接收起来即可.

六.获取到的北京天气的JSON数据样本:

{
	"HeWeather6": [{
		"basic": {
			"cid": "CN101010100",
			"location": "北京",
			"parent_city": "北京",
			"admin_area": "北京",
			"cnty": "中国",
			"lat": "39.90498734",
			"lon": "116.4052887",
			"tz": "+8.00"
		},
		"update": {
			"loc": "2018-08-29 09:45",
			"utc": "2018-08-29 01:45"
		},
		"status": "ok",
		"daily_forecast": [{
			"cond_code_d": "100",
			"cond_code_n": "100",
			"cond_txt_d": "晴",
			"cond_txt_n": "晴",
			"date": "2018-08-29",
			"hum": "45",
			"mr": "20:30",
			"ms": "07:57",
			"pcpn": "0.0",
			"pop": "3",
			"pres": "1011",
			"sr": "05:40",
			"ss": "18:48",
			"tmp_max": "31",
			"tmp_min": "20",
			"uv_index": "10",
			"vis": "20",
			"wind_deg": "351",
			"wind_dir": "北风",
			"wind_sc": "1-2",
			"wind_spd": "3"
		}, {
			"cond_code_d": "101",
			"cond_code_n": "101",
			"cond_txt_d": "多云",
			"cond_txt_n": "多云",
			"date": "2018-08-30",
			"hum": "63",
			"mr": "20:59",
			"ms": "08:57",
			"pcpn": "0.0",
			"pop": "20",
			"pres": "1012",
			"sr": "05:41",
			"ss": "18:47",
			"tmp_max": "30",
			"tmp_min": "20",
			"uv_index": "5",
			"vis": "18",
			"wind_deg": "217",
			"wind_dir": "西南风",
			"wind_sc": "1-2",
			"wind_spd": "4"
		}, {
			"cond_code_d": "104",
			"cond_code_n": "101",
			"cond_txt_d": "阴",
			"cond_txt_n": "多云",
			"date": "2018-08-31",
			"hum": "61",
			"mr": "21:30",
			"ms": "09:59",
			"pcpn": "0.0",
			"pop": "0",
			"pres": "1014",
			"sr": "05:42",
			"ss": "18:45",
			"tmp_max": "29",
			"tmp_min": "20",
			"uv_index": "3",
			"vis": "20",
			"wind_deg": "126",
			"wind_dir": "东南风",
			"wind_sc": "1-2",
			"wind_spd": "1"
		}]
	}]
}

将上面简化一下的,容易看一下是这样的:

{
"HeWeather6": [{
	"basic": {...},
	"update": {...},
	"status": "ok",
	"daily_forecast": [{...},{...},{...}]
}]
}

我们可能会发现JSON数据{}或者[]前有类似 "HeWeather6": 这样的东西:
1.数组的名称,称它为数据头,防止跟里面的字段有歧义.
2.如果没有数据头,那就叫它纯数据,或者纯数组数据.
3.有数据头和没数据头解析时有区别.

解析和风天气返回的的JSON数据

一.将json字符串转化为json对象:

JSONObject jsonObject = new JSONObject(responseData);

二.获取json对象中数据头为HeWeather6(或者名称为HeWeather6)的数组:

JSONArray jsonArray = jsonObject.getJSONArray("HeWeather6");

三.获取HeWeather6数组中位置为0( 即"HeWeather6": [{...}]中的{...}之间的内容 )的json对象的字符串形式:

String weatherContent = jsonArray.getJSONObject(0).toString();

其内容即是:

[{
	"basic": {...},
	"update": {...},
	"status": "ok",
	"daily_forecast": [{...},{...},{...}]
}]

四.解析JSON数据常用的有两种(JSONObject,GSON),在此处我们使用GSON:

1.使用前导入GSON库依赖:

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

2.GSON主要可以将一段JSON格式的字符串自动映射成一个对象,所以我们需要参照JSON数据,建立JSON数据所对应的所有对象:Basic,Update,Status,Forecast,然后用一个总的类(Weather)持有它们.

public class Basic {
    @SerializedName("loaction")
    public String cityName;
    @SerializedName("cid")
    public String code;
}
-----------------------
public class Update {
    @SerializedName("loc")
    public String updateTime;
}
-----------------------
public class Forecast {
    @SerializedName("tmp_max")
    public String MaxT;
    @SerializedName("tmp_min")
    public String MinT;
    @SerializedName("cond_txt_d")
    public String dayTime;
}

public class Weather {
    public Basic basic;
    public Update update;
    public String status;

    @SerializedName("daily_forecast")
    public List<Forecast> forecastList;
}

研究以上代码,可以发现这些类里面的写的字段也是一一对应JSON数据格式里面的字段的,并且变量名也要一一对应,不过,JSON格式中的字段名阅读性很差,如cond_code_d我们一般看出来是什么,那我们如何自定义变量名并且让其与JSON格式中的数据对应起来呢?这就用到了注解功能了,如被@SerializedName("cond_code_d")注解的字符串就可以对应json格式中的cond_code_d字段了.

和风天气返回的天气数据很多,我们并不需要这么多,所以我们在建立这些类时,里面的字段并不用参照JSON格式里的字段全部建立,只需建立我们需要的天气数据的字段即可.

3.开启解析(映射):

Weather weather = new Gson().fromJson(weatherContent , Weather.class);

4.然后便可以利用Weather对象获取相应的数据了,比如获取JSON数据中字段为status的值:

String value = weather.status;

5.我们可以观察到JSON数据的daily_forecast字段有点特殊,里面有三个一样的大括号,那我们怎么拿出里面的数据呢?用List即可:

List<Forecast> forecastList = weather.forecastList;

不难猜出forecastList的长度为3,其对应的就是三个大括号,比如拿出第一个括号里的字段为tmp_max的值:

Forecast  forecast = forecastList.get(0);
String value = forecast.MaxT;

扩展

一.有时候服务器放回的JSON数据并不一定跟和风天气返回的JSON数据一样,但其实都大同小异:

1.没有数据头的JSON数据:

[
    {"id":"5","version":"5.5","name":"Clash of Clans"},
    {"id":"6","version":"7.0","name":"Boom Beach"},
    {"id":"7","version":"3.5","name":"Clash Royale"}
]

解析时,我们就可以这样:

JSONArray jsonArray = new JSONArray(responseData); 
//可以看到json数据有三个括号,所以此处的0指的就是第一个括号
JSONObject jsonObject = jsonArray.getJSONObject(0); 
String id = jsonObject.getString("id");

这样的解析方式属于JSONObject,而不是GSON了,用GSON:

public class App {
    public String id;
    public String name;
    public String version;
}
----------------------------------
Gson gson = new Gson();
List<App> appList = gson.fromJson(responseData , new TypeToken<List<App>>(){}.getType());
String id = appList.get(0).id;

或者:

public class App {
    public String id;
    public String name;
    public String version;
}
-----------------------------
JsonParser parser = new JsonParser();
JsonArray jsonArray = parser.parse(responseData).getAsJsonArray();

Gson gson = new Gson();
ArrayList<App> appList = new ArrayList<>();

for (JsonElement user : jsonArray) {
        App app = gson.fromJson(user, App.class);
        appList.add(app);
}

注意

由于连接网络连接耗时,稳定性问题,为了避免堵塞主线程,以上的代码需要在子线程中进行,而且要注意子线程不可更新Ui问题.

JSON知识补充

一.JSON即对象表示法(JavaScript Object Notation),JSON文本格式在语法上与创建 JavaScript 对象的代码相同,如一个JSON文本和一个JavaScript 对象对比:

{
    "employees": [
        { "firstName":"John" , "lastName":"Doe" },
        { "firstName":"Anna" , "lastName":"Smith" },
        { "firstName":"Peter" , "lastName":"Jones" }
    ]
}

var employees = [
{ "firstName":"Bill" , "lastName":"Gates" },
{ "firstName":"George" , "lastName":"Bush" },
{ "firstName":"Thomas" , "lastName": "Carter" }
];

所以在上面例子中,不难看出JSON中的employees是一个数组的变量名.

二.数组,对象,数据

1.在JSON中,方括号[ ]保存数组,花括号{ }保存对象.

2.数组可包含多个对象：{"employees": [ {...} , {...} , {...} ]} , 对象 "employees" 是包含三个对象的数组.

3.JSON对象在花括号中书写,即一个{ }代表一个JSON对象,JSON对象可以包含多个名称/值对:

{ "firstName":"John" , "lastName":"Doe" }

4.类似 "firstName":"John" 这样的名称:值对称为一条JSON 数据.

三.JavaScript 语法

var employees = [
{ "firstName":"Bill" , "lastName":"Gates" },
{ "firstName":"George" , "lastName":"Bush" },
{ "firstName":"Thomas" , "lastName": "Carter" }
];

1.访问 JavaScript 对象数组中的第一项:

第一种: employees[0].lastName;

第二种: employees[0]["lastName"];

2.修改数据: employees[0].lastName = "Jobs";

四.有了以上知识不妨回头看看和风天气返回的数据:

{
"HeWeather6": [{
	"basic": {...},
	"update": {...},
	"status": "ok",
	"daily_forecast": [{...},{...},{...}]
}]
}

我们知道{}代表一个保存的是对象,而和风天气返回的JSON数据最外一层的也是一个{},代表这段JSON是一个JSON对象,所以我们利用系统提供的JSONObject来保存这个JSON对象:

JSONObject jsonObject = new JSONObject(responseData);

再看看这个JSON对象里面包含了一个HeWeather6数组,因此,同样的我们利用系统提供的JSONArray来保存这个HeWeather6数组:

JSONArray jsonArray = jsonObject.getJSONArray("HeWeather6");

再接下去,我们又发现了HeWeather6数组里面含有一个{ }(即对象),并且这个对象里面又含有了两个对象(basic,update),一条数据(status),一个数组(daily_forecast),所以根据以往,首先,我们需要获取HeWeather6数组里含有的对象:

JSONObject jsonObject1 = jsonArray.getJSONObject(0);

然后再去获取这个对象中的对象:

JSONObject jsonObject2 = jsonArray.getJSONObject("basic");

然后最终得到JSON数据变量名为basic的数据:

Log.d(TAG, "onCreate: " + jsonObject1.getString("cid"));

所以你会发现用纯JSONObject的方法来解析JSON数据挺繁琐的,不如使用上面GSON的方式直接将JSON数据映射到实体类,然后通过实体类来获得相应的数据来的方便.

四.实际开发遇到的错误

1.以下代码粗看是一个JSONObject包含了两个JSONArray，但是这段JSON字符串转为JSONObject会报错

{
    "xx" : "[{"aaa":"axx","b":"b"},{"a":"a","b":"b"}]",
    "yy" : "[{"a":"a","b":"b"},{"a":"a","b":"b"}]"
}

正确写法，要把JSONArray字符串左右两边的 “ 去掉：

{
    "xx" : [{"aaa":"axx","b":"b"},{"a":"a","b":"b"}],
    "yy" : [{"a":"a","b":"b"},{"a":"a","b":"b"}]
}

2.假如我们在数据库直接用一个字段存储一段JSON字符串数据：

[{"职业规划":"25","计算机与科学":"85"},{"体育":"25","计算机与科学":"85"}]

客户端发起对php(或者其他类型的后台)的请求,用字符串data接收返回到的数据:

String data = response.body().string;

打印出来,可以看到多出来了些转移符 \ ，还有左右两边也多出了 “

如果这些我们没处理掉的话，直接把这个原始字符串转换为JSONArray会报错，怎么处理掉看下面java代码：

String data =  response.body().string().replace("\\", "");      //接受并处理掉转义符\
String data2 = data.substring(1,data.length() - 1);    //处理掉前后"符号