谢谢大家对该系列博文的支持与关注,我们现在趁热打铁正式开始我们的Android天气软件的开发吧!没有阅读过之前关于该软件的功能需求的同学可以先看一下 一起来开发Android的天气软件(一),可以先去快速浏览一下,清楚我们的概要体系。今天我们要做的是搭建Sqlite数据库,那这个数据库要存储哪些信息呢!该数据库是用来存储全国的省市县的一些信息,全国共有34个省比如浙江旗下又有好多的市如杭州、温州、湖州,杭州下面又有很多区县,我们要做的就是把这些结构化的数据存储到我们的数据库中。
那么我们现在就开始吧!我们这次使用的是LitePal的开源框架,它采用了对象关系映射(ORM)的模式,并将我们平时开发时最常用到的一些数据库功能进行了封装,使得不用编写一行SQL语句就可以完成各种建表、増删改查的操作。用起来总之非常的方便,从郭霖大神的博文中学会了解该框架后,我就快速学以致用用到这个天气软件的编程中来,Pratiece makes preferct,我们下面就来见识下LitePal的威力!
首先我们先要建立Province,City,County三张表。
1、Province
2、City
3、County
好的,以上这是我们表的结构的庐山真面目,我们会发现每一张表都会有一个id,然后会有相应的province_code,province_name属性,除此之外呢,city还有一个province_id列,这是一个外键列,是为了实现省份表与城市表的一个关联关系,一个city表里面存放一个具体的省份id,并且允许多个城市都存放同一个省份id,这样一个城市就只能对应一个省份,但一个省份却可以有多个城市,也就实现多对一的关系了!以此类推,county也有一个city_id来实现市与县的一对多的关系,不知道大家看到这里都理清楚了没有我们三张表的关系呢!
知道了以上的表结构,我们可以正式进入建表操作了,这边我在重新简述一下使用LitePal的使用流程,如果还没有下载这个Jar包的同学,LitePal开源项目地址:https://github.com/LitePalFramework/LitePal下载一下,首先在自己的程序导入Jar包,在在该项目的assets目录下面新建一个litepal.xml文件,第三步再在AndroidManifest.xml中配置一下LitePalApplication了,三步就完成了该包的导入过程!
使用LitePal后呢,我们就不用"create table province (" + "id integer primary key autoincrement, " + "province_name varchar, " + "province_code varchar " )";这样的建表语句了,一切变得很简单。根据对象关系映射模式的理念,每一张表都应该对应一个模型(Model),也就是说,如果我们需要先建一张Provinces表,就应该有一个对应的Province模型类。需要什么表建立一个相应的类,里头有什么列就在模型类里对应怎样的字段,让我们看一下!Provinces类!
package com.melhc.model; import java.util.ArrayList; import java.util.List; import org.litepal.crud.DataSupport; public class Province extends DataSupport { private int id; private String province_name; private String province_code; private List<City> cities = new ArrayList<City>(); public String getProvince_code() { return province_code; } public void setProvince_code(String province_code) { this.province_code = province_code; } public List<City> getCities() { return cities; } public void setCities(List<City> cities) { this.cities = cities; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getProvince_name() { return province_name; } public void setProvince_name(String province_name) { this.province_name = province_name; } }
以上就是我们的Provinces类,我们可以看到该模型类中有id,province_name,provice_code以及cities字段,并且都实现了其中的get set方法,这边要注意一定要实现getset方法的,要不然建表会失败的!此外,id属性可写可不写,LitePal都会和人性化的自动生成的,重点在我们这边有一个CITY的集合,这个是干什么的呢,就是用来描述一个province对应着多个city,所以建立了一个list集合,那么在city表又怎么表示多对一的关系呢!
package com.melhc.model; import java.util.ArrayList; import java.util.List; import org.litepal.crud.DataSupport; public class City extends DataSupport { private int id; private String city_name; private String city_code; private Province province; private List<County> counties = new ArrayList<County>(); public List<County> getCounties() { return counties; } public void setCounties(List<County> counties) { this.counties = counties; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getCity_name() { return city_name; } public void setCity_name(String city_name) { this.city_name = city_name; } public String getCity_code() { return city_code; } public void setCity_code(String city_code) { this.city_code = city_code; } public Province getProvince() { return province; } public void setProvince(Province province) { this.province = province; } }
从以上看出,我们只要在city表建立一个Province类就好了,表示每一个city都对应着一个Province归属,好的说到这里大家都应该明白怎么实现了吧!细心的朋友还会发现我们每一个类还继承了一个DateSupport,这个类是为了实现LitePal数据库的增删改查操作的哈!
同上County表如下就好了!
package com.melhc.model; import org.litepal.crud.DataSupport; public class County extends DataSupport { private int id; private String county_name; private String county_code; private City city; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getCounty_name() { return county_name; } public void setCounty_name(String county_name) { this.county_name = county_name; } public String getCounty_code() { return county_code; } public void setCounty_code(String county_code) { this.county_code = county_code; } public City getCity() { return city; } public void setCity(City city) { this.city = city; } }
好的,通过以上操作我们就完成了三张表的建立,别忘了一件事在assets文件的litepal.xml文件修改
<?xml version="1.0" encoding="utf-8"?> <litepal> <dbname value="weather" > </dbname> <version value="2" > </version> <list> <mapping class="com.melhc.model.Province" > </mapping> <mapping class="com.melhc.model.City" > </mapping> <mapping class="com.melhc.model.County" > </mapping> </list> </litepal>
OK,下面为了方便我们的数据库操作,我们在封装一个 WeatherDB类,实现对数据库的正式生成和增删改查操作!
/** * 将provice实例存储到数据库 */ public void saveProvice(Province province) { if (province != null) { province.save(); } }
我们可以看到在存储province的信息时,该方法只要传入一个province类,然后调用province.save方法就可以实现数据库的插入,那么怎么插入数据库这些字段的呢,我们只要先新建一个province类,然后再把网络读取的信息通过province.setProvice_name()等set方法传入即可了,是不是非常简单呢!Province province = new Province();province.setProvince_code(array[0]); province.setProvince_name(array[1]);
那么下面问题又来了我们怎么实现city与Province的表与表之间的关联关系呢,其实也非常简单,只要将city对应的province得到,并用set方法构造进入就好了!我们来看一下
City city = new City(); city.setCity_code(array[0]); city.setCity_name(array[1]); city.setProvince(province); weatherDB.saveCity(city);
是不是非常简单呢!那么如何读取呢,这个就更简单了,建立一个Province类的list集合,调用DateSupport的findAll()方法即可得到,查询的方式还有很多,我这边就不一一列举了,你还可以增加很多查询的删选条件等等。
/** * 从数据库读取全国所有的省份信息 */ public List<Province> loadProvices() { List<Province> list = DataSupport.findAll(Province.class); return list; }
那么如何查询city表的数据呢?我们知道每一个城市都对应着一个省province,那么我们先通过与之关联的province_id找到它对应的province类,问题就解决一大半了,然后再通过这个province类的getCities()方法即可返回该省下面的所有城市列表!
/** * 从数据库读取某省下的所有的城市信息 */ public List<City> loadCities(int provinceId) { Province provice = DataSupport.find(Province.class, provinceId,true); List<City> list = provice.getCities(); return list; }
好的关键点都解释完了,我们来看一下这个类的全貌吧!
package com.melhc.db; import java.util.List; import org.litepal.crud.DataSupport; import org.litepal.tablemanager.Connector; import com.melhc.model.City; import com.melhc.model.County; import com.melhc.model.Province; import android.database.sqlite.SQLiteDatabase; public class WeatherDB { /** * 一些基本的数据库方法封装 */ private SQLiteDatabase db; private static WeatherDB weatherDB; public WeatherDB() { // TODO Auto-generated constructor stub db = Connector.getDatabase();//正式生成数据库 } public synchronized static WeatherDB getInstance() { if (weatherDB == null) { weatherDB = new WeatherDB(); } return weatherDB; } /** * 将provice实例存储到数据库 */ public void saveProvice(Province province) { if (province != null) { province.save(); } } /** * 从数据库读取全国所有的省份信息 */ public List<Province> loadProvices() { List<Province> list = DataSupport.findAll(Province.class); return list; } /** * 将city实例存储到数据库 */ public void saveCity(City city) { if (city != null) { city.save(); } } /** * 从数据库读取某省下的所有的城市信息 */ public List<City> loadCities(int provinceId) { Province provice = DataSupport.find(Province.class, provinceId,true); List<City> list = provice.getCities(); return list; } /** * 将county实例存储到数据库 */ public void saveCounty(County county) { if (county != null) { county.save(); } } /** * 从数据库读取某城市下的所有的县信息 */ public List<County> loadCounties(int cityId) { City city = DataSupport.find(City.class, cityId,true); List<County> list = city.getCounties(); return list; } /** * 关闭数据库 */ public void destroyDB() { if (db != null) { db.close(); } } }
好的,这一节课的内容就讲到这里,第一次博文码那么多字,感觉萌萌哒啊,希望大家通过这篇博文能对LitePaL框架有一个更好的认识,也希望大家能继续支持该系列的博文,你们的支持是我写下去的最大动力!今天的数据库设计就到此结束,下一篇博文也会很快跟大家见面的。
下面是该应用的Git开源地址,https://github.com/melhc/SimpleWeather