学习了郭霖老师的《第一行代码》,其中14章是介绍天气预报软件的设计。从而学习了如何设计一个实用性的android小程序。
(一)功能需要及技术分析
设计之前,我们先需要分析,这个软件需要具备哪些功能。
·可以罗列出全国所有的省、市、县;
·可以查看全国任意城市的天气信息;
·可以自由地切换城市,去查看其他城市地天气;
·提供手动更新以及后台自动更新天气的功能。
这4个主要的功能点,如果要实现需要用到UI、网络、数据储存、服务等技术。比较需要综合应用的能力。如何获取到每个城市的天气信息,我们可以使用和风天气的接口,它的数据相对简单点。解决了天气问题,还需要解决全国省市县数据的问题。作者为了方便读者的学习,专门设了一台服务器,用于提供全国所有省市县的数据信息。
想罗列出中国所有的省份,只需要访问地址:http://guolin.tech/api/china。服务器会返回一段JSON格式的数据,包含中国所有省份名称以及省份id。如果想知道某个省份内有哪些城市,比如江苏的id是16,访问地址:http://guolin.tech/api/china/16。只需要把省份id添加到url地址的最后面即可。比如苏州的id是116,那么想知道苏州下有哪些县和区的时候,访问地址:http://guolin.tech/api/china/16/116。如此类推。但返回苏州下有哪些县和区的时候,会返回相应的weather_id,拿着这个id再去访问和风天气的接口,就可以获取到该地区具体的天气信息了。
和风天气的接口,使用方法也很简单。首先注册自己的账号,注册地址是http://guolin.tech/api/weather/register。注册好了之后,就能看到自己的APIKey,以及每天剩余的访问次数。有了APIKey,再配合weather_id,我们就可以获取到任意城市的天气信息。比如说苏州的weather_id是CN101190401,那么访问如下接口即可查看苏州的天气信息:
http://guolin.tech/api/weather?cityid=CN101190401&key=bc0418b57b2d4918819d3974ac1285d9。
其中,cityid部分填入的是待查看城市的weather_id,key部分就是注册的APIKey。这样服务器就会把苏州详细的天气信息以JSON格式返回给我们。由于返回数据较复杂,精简处理后,如下所示:
1 {
2 “HeWeather":[
3 {
4 "status":"ok",
5 "basic":{},
6 "api":{},
7 "now"{},
8 "suggestion":{}
9 "daily_forecast":[]
10 }
11 ]
12 }
返回数据的格式大体上就是这样,其中status代表请求状态,ok表示成功。basic中会包含城市的一些基本信息,api中会包含当前空气质量的情况,now中会包含当前的天气信息,suggestion中会包含一些天气相关的生活建议,daily_forecast中会包含未来几天的天气信息。
数据都能获取到了之后,接下来就是JSON解析的工作了。
(二)创建数据库和表
在Android Srudio中新建一个Android项目,项目名叫作CoolWeather,包名叫作com.coolweather.android。在com.coolweather.android包下再新建几个包,db包用于存放数据库模型相关代码,gson包用于存放GSON模型相关代码,service包用于存放服务相关的代码,util包用于存放工具相关的代码。
为了简化数据库的操作,这里使用LitePal来管理酷欧天气的数据库。
先将项目需要的各种依赖库进行声明,编辑app/build.gradle文件,在dependencies闭包中添加如下内容:
1 dependencies{
2 compile fileTree(dir:'libs',include:['*.jar'])
3 compile 'com.android.support:appcompat-v7:24.2.1'
4 testCompile 'junit:junit:4.12'
5 compile 'org.litepal.android:core:1.3.2'
6 compile 'com.squareup.okhttp3:okhttp:3.4.1'
7 compile 'com.google.code.gson:gson:2.7'
8 compile 'com.github.bumptech.glide:glide:3.7.0'
9 }
LitePal用于对数据库进行操作,OkHttp用于进行网络,GSON用于解析JSON数据,Glide用于加载和展示图片。
然后我们来设计一下数据库的表结构。这里准备建立3张表:province、city、county,分别用于存放省、市、县的数据信息。对应到实体类中的话,就应该建立Province、City、County这3个类。
在db包下新建Province类,代码如下:
1 public class Province extends DataSupport {
2
3 private int id;
4
5 private String provinceName;
6
7 private int provinceCode;
8
9 public int getId() {
10 return id;
11 }
12
13 public void setId(int id) {
14 this.id = id;
15 }
16
17 public String getProvinceName() {
18 return provinceName;
19 }
20
21 public void setProvinceName(String provinceName) {
22 this.provinceName = provinceName;
23 }
24
25 public int getProvinceCode() {
26 return provinceCode;
27 }
28
29 public void setProvinceCode(int provinceCode) {
30 this.provinceCode = provinceCode;
31 }
32 }
其中,id是每个实体类db都应该有的字段,provinceName记录省的名字,provinceCode记录省的代号。另外、LitePal中的每一个实体类都必须要继承自DataSupport类的。
接着在db包下新建一个City类,代码如下:
public class City extends DataSupport {
private int id;
private String cityName;
private int cityCode;
private int provinceId;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getCityName() {
return cityName;
}
public void setCityName(String cityName) {
this.cityName = cityName;
}
public int getCityCode() {
return cityCode;
}
public void setCityCode(int cityCode) {
this.cityCode = cityCode;
}
public int getProvinceId() {
return provinceId;
}
public void setProvinceId(int provinceId) {
this.provinceId = provinceId;
}
}
其中,cityName记录市的名字,cityCode记录市的代号,provinceId记录当前市所属省的id值。
然后在db包下新建一个County类,代码如下:
1 public class County extends DataSupport {
2
3 private int id;
4
5 private String countyName;
6
7 private String weatherId;
8
9 private int cityId;
10
11 public int getId() {
12 return id;
13 }
14
15 public void setId(int id) {
16 this.id = id;
17 }
18
19 public String getCountyName() {
20 return countyName;
21 }
22
23 public void setCountyName(String countyName) {
24 this.countyName = countyName;
25 }
26
27 public String getWeatherId() {
28 return weatherId;
29 }
30
31 public void setWeatherId(String weatherId) {
32 this.weatherId = weatherId;
33 }
34
35 public int getCityId() {
36 return cityId;
37 }
38
39 public void setCityId(int cityId) {
40 this.cityId = cityId;
41 }
42
43 }
其中,countyName记录县的名字,weatherId记录县所对应的天气id,cityId记录当前县所属市的id值。
接下来需要配置litepalxml文件。右击app/src/main目录-New-Directory,创建一个assets目录,然后在assets目录下再新建一个litepal.xml文件,接着编辑litepal.xml文件,接着编辑litepal.xml文件中的内容,如下所示:
1 <litepal>
2 <dbname value="cool_weather"/>
3 <version value="1"/>
4 <list>
5 <mapping class="com.coolweather.android.db.Province"/>
6 <mapping class="com.coolweather.android.db.City"/>
7 <mapping class="com.coolweather.android.db.County"/>
8 </list>
9 </litepal>
我们将数据库名指定为cool_weather ,数据库版本指定成1,并将Province、City、和County这3个实体类添加到映射列表当中。
最后再配置一下LitePalApplication,修改AndroidManifest.xml中的代码,如下所示:
1 <manifest package="com.coolweather.android"
2 xmlns:android="http://schemas.android.com/apk/res/android">
3 <application
4 android:name="org.litepal.LitePalApplication"
5 android:theme="@style/AppTheme"
6 android:supportsRtl="true"
7 android:label="@string/app_name"
8 android:icon="@mipmap/logo"
9 android:allowBackup="true">
10
11 .....
12
13 </application>
14 </manifest>
这样我们就将所有的配置都完成了,数据库和表会在首次执行任意数据库操作的时候自动创建。
下一章节开发遍历省市县数据的功能。
具体实现步骤连接:
android开发学习之路——天气预报之技术分析与数据库(一)
android开发学习之路——天气预报之遍历省市县数据(二)
android开发学习之路——天气预报之手动更新天气和切换城市(四)
android开发学习之路——天气预报之后台自动更新天气(五)