android开发学习之路——天气预报之技术分析与数据库（一）

    学习了郭霖老师的《第一行代码》，其中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格式返回给我们。由于返回数据较复杂，精简处理后，如下所示：

｛
    “HeWeather":[
    {
        "status":"ok",
        "basic":{},
        "api":{},
        "now"{},
        "suggestion":{}
        "daily_forecast":[]
        }
    ]
}

    返回数据的格式大体上就是这样，其中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闭包中添加如下内容：

dependencies｛
    compile fileTree(dir:'libs',include:['*.jar'])
    compile 'com.android.support:appcompat-v7:24.2.1'
    testCompile 'junit:junit:4.12'
    compile 'org.litepal.android:core:1.3.2'
    compile 'com.squareup.okhttp3:okhttp:3.4.1'
    compile 'com.google.code.gson:gson:2.7'
    compile 'com.github.bumptech.glide:glide:3.7.0'
}

    LitePal用于对数据库进行操作，OkHttp用于进行网络,GSON用于解析JSON数据，Glide用于加载和展示图片。

    然后我们来设计一下数据库的表结构。这里准备建立3张表：province、city、county，分别用于存放省、市、县的数据信息。对应到实体类中的话，就应该建立Province、City、County这3个类。

    在db包下新建Province类，代码如下：

public class Province extends DataSupport {

    private int id;

    private String provinceName;

    private int provinceCode;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getProvinceName() {
        return provinceName;
    }

    public void setProvinceName(String provinceName) {
        this.provinceName = provinceName;
    }

    public int getProvinceCode() {
        return provinceCode;
    }

    public void setProvinceCode(int provinceCode) {
        this.provinceCode = provinceCode;
    }
}

    其中，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类，代码如下：

public class County extends DataSupport {

    private int id;

    private String countyName;

    private String weatherId;

    private int cityId;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getCountyName() {
        return countyName;
    }

    public void setCountyName(String countyName) {
        this.countyName = countyName;
    }

    public String getWeatherId() {
        return weatherId;
    }

    public void setWeatherId(String weatherId) {
        this.weatherId = weatherId;
    }

    public int getCityId() {
        return cityId;
    }

    public void setCityId(int cityId) {
        this.cityId = cityId;
    }

}

    其中，countyName记录县的名字，weatherId记录县所对应的天气id，cityId记录当前县所属市的id值。

    接下来需要配置litepalxml文件。右击app/src/main目录-New-Directory，创建一个assets目录，然后在assets目录下再新建一个litepal.xml文件，接着编辑litepal.xml文件，接着编辑litepal.xml文件中的内容，如下所示：

<litepal>
     <dbname value="cool_weather"/>
     <version value="1"/> 
     <list> 
        <mapping class="com.coolweather.android.db.Province"/> 
        <mapping class="com.coolweather.android.db.City"/>        
        <mapping class="com.coolweather.android.db.County"/> 
      </list>
</litepal>

    我们将数据库名指定为cool_weather ，数据库版本指定成1，并将Province、City、和County这3个实体类添加到映射列表当中。

    最后再配置一下LitePalApplication，修改AndroidManifest.xml中的代码，如下所示：

<manifest package="com.coolweather.android"   
    xmlns:android="http://schemas.android.com/apk/res/android">
    <application 
        android:name="org.litepal.LitePalApplication"  
        android:theme="@style/AppTheme"  
        android:supportsRtl="true" 
        android:label="@string/app_name"
        android:icon="@mipmap/logo"       
        android:allowBackup="true">
        
    .....
  
    </application>
</manifest>

    这样我们就将所有的配置都完成了，数据库和表会在首次执行任意数据库操作的时候自动创建。

    下一章节开发遍历省市县数据的功能。

 

具体实现步骤连接：

android开发学习之路——天气预报之技术分析与数据库（一）

android开发学习之路——天气预报之遍历省市县数据（二）

android开发学习之路——天气预报之显示天气信息（三）

android开发学习之路——天气预报之手动更新天气和切换城市（四）

android开发学习之路——天气预报之后台自动更新天气（五）