上一篇文章中我們學習了一些Android數據庫相關的基礎知識,和幾個頗爲有用的SQLite命令,都是直接在命令行操作的。但是我們都知道,數據庫是要和程序結合在一起使用的,單獨對一個數據庫去進行増刪改查操作並沒有什麼意義,因此今天我們就來學習一下如何在Android程序當中去操作SQLite數據庫。
操作數據庫的第一步當然是創建表了,傳統創建表的方法相信大多數人都知道,那麼今天我除了會展示傳統的建表方法之外,還會講解LitePal這個框架的基本用法,並使用它來完成同樣的建表操作,讓大家體會到使用框架來操作數據庫的魅力。
那麼先來簡單介紹一下吧,LitePal是一款開源的Android數據庫框架,它採用了對象關係映射(ORM)的模式,並將我們平時開發時最常用到的一些數據庫功能進行了封裝,使得不用編寫一行SQL語句就可以完成各種建表、増刪改查的操作。並且LitePal很“輕”,jar包只有100k不到,而且近乎零配置,這一點和Hibernate這類的框架有很大區別。目前LitePal的源碼已經託管到了GitHub上,地址是 https://github.com/LitePalFramework/LitePal 。
OK,簡單介紹完了LitePal,我們還是先來看一下,在傳統的Android開發中,需要怎麼去創建表。
傳統的建表方式
其實爲了方便我們對數據庫表進行管理,Android本身就提供了一個幫助類:SQLiteOpenHelper。這個類集創建和升級數據庫於一身,並且自動管理了數據庫版本,算是一個非常好用的工具。
那我們現在就來試試SQLiteOpenHelper的用法吧。首先你要知道SQLiteOpenHelper是一個抽象類,這意味着如果我們想要使用它的話,就需要創建一個自己的幫助類去繼承它。SQLiteOpenHelper中有兩個抽象方法,分別是onCreate()和onUpgrade(),我們必須在自己的幫助類裏面重寫這兩個方法,然後分別在這兩個方法中去實現創建、升級數據庫的邏輯。本篇文章只需要把注意力放在創建數據庫這裏就行了,升級數據庫我們會在下一篇文章中去討論。
新建一個MySQLiteHelper類並讓它繼承SQLiteOpenHelper,這樣一個最基本的數據庫幫助類的代碼如下所示:
- public class MySQLiteHelper extends SQLiteOpenHelper {
- public MySQLiteHelper(Context context, String name, CursorFactory factory,
- int version) {
- super(context, name, factory, version);
- }
- @Override
- public void onCreate(SQLiteDatabase db) {
- }
- @Override
- public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
- }
- }
- public class MySQLiteHelper extends SQLiteOpenHelper {
- public static final String CREATE_NEWS = "create table news ("
- + "id integer primary key autoincrement, "
- + "title text, "
- + "content text, "
- + "publishdate integer,"
- + "commentcount integer)";
- public MySQLiteHelper(Context context, String name, CursorFactory factory,
- int version) {
- super(context, name, factory, version);
- }
- @Override
- public void onCreate(SQLiteDatabase db) {
- db.execSQL(CREATE_NEWS);
- }
- ...
- }
現在,我們只需要獲取到SQLiteDatabase的實例,數據庫表就會自動創建了,如下所示:
- SQLiteOpenHelper dbHelper = new MySQLiteHelper(this, "demo.db", null, 1);
- SQLiteDatabase db = dbHelper.getWritableDatabase();
感覺很簡單很方便是嗎?那你就太容易滿足了,下面我們就來學習一下LitePal的基本用法,看一看使用這個框架是如何實現同樣的功能的。
LitePal的基本用法
雖說LitePal宣稱是近乎零配置,但也只是“近乎”而已,它還是需要進行一些簡單配置纔可以使用的,那麼我們第一步就先快速學習一下LitePal的配置方法。
快速配置
1. 引入Jar包或源碼
首先我們需要將LitePal的jar包引入到項目當中,可以點擊這裏查看LitePal的最新版本,選擇你需要的下載即可。下載好了jar包之後,把它複製到項目的libs目錄中就算是引入成功了,如下圖所示:
如果你不想用jar包的話,也可以把LitePal的源碼下載下來,然後作爲一個library庫導入到Eclipse當中,再讓我們的項目去引用這個library庫就可以了。
2. 配置litepal.xml
接着在項目的assets目錄下面新建一個litepal.xml文件,並將以下代碼拷貝進去:
- <?xml version="1.0" encoding="utf-8"?>
- <litepal>
- <dbname value="demo" ></dbname>
- <version value="1" ></version>
- <list>
- </list>
- </litepal>
3. 配置LitePalApplication
由於操作數據庫時需要用到Context,而我們顯然不希望在每個接口中都去傳一遍這個參數,那樣操作數據庫就顯得太繁瑣了。因此,LitePal使用了一個方法來簡化掉Context這個參數,只需要在AndroidManifest.xml中配置一下LitePalApplication,所有的數據庫操作就都不用再傳Context了,如下所示:
- <manifest>
- <application
- android:name="org.litepal.LitePalApplication"
- ...
- >
- ...
- </application>
- </manifest>
- <manifest>
- <application
- android:name="com.example.MyApplication"
- ...
- >
- ...
- </application>
- </manifest>
- public class MyApplication extends LitePalApplication {
- ...
- }
但是,有些程序可能會遇到一些更加極端的情況,比如說MyApplication需要繼承另外一個AnotherApplication,並且這個AnotherApplication還是在jar包當中的,不能修改它的代碼。這種情況應該算是比較少見了,但是如果你遇到了的話也不用急,仍然是有解釋方案的。你可以把LitePal的源碼下載下來,然後把src目錄下的所有代碼直接拷貝到你項目的src目錄下面,接着打開LitePalApplication類,將它的繼承結構改成繼承自AnotherApplication,再讓MyApplication繼承自LitePalApplication,這樣所有的Application就都可以在一起正常工作了。
僅僅三步,我們就將所有的配置工作全部完成了,並且這是一件一本萬利的事情,自此以後,你就可以開心地體驗LitePal提供的各種便利了,就讓我們從建表開始吧。
開始建表
前面在介紹的時候已經說了,LitePal採取的是對象關係映射(ORM)的模式,那麼什麼是對象關係映射呢?簡單點說,我們使用的編程語言是面嚮對象語言,而我們使用的數據庫則是關係型數據庫,那麼將面向對象的語言和麪向關係的數據庫之間建立一種映射關係,這就是對象關係映射了。
但是我們爲什麼要使用對象關係映射模式呢?這主要是因爲大多數的程序員都很擅長面向對象編程,但其中只有少部分的人才比較精通關係型數據庫。而且數據庫的SQL語言晦澀難懂,就算你很精通它,恐怕也不喜歡經常在代碼中去寫它吧?而對象關係映射模式則很好地解決了這個問題,它允許我們使用面向對象的方式來操作數據庫,從而可以從晦澀難懂的SQL語言中解脫出來。
那麼接下來我們就看一看LitePal中是如何建表的吧。根據對象關係映射模式的理念,每一張表都應該對應一個模型(Model),也就是說,如果我們想要建一張news表,就應該有一個對應的News模型類。新建一個News類,如下所示:
- package com.example.databasetest.model;
- public class News {
- }
- public class News {
- private int id;
- private String title;
- private String content;
- private Date publishDate;
- private int commentCount;
- // 自動生成get、set方法
- ...
- }
這裏我要特別說明一下,LitePal的映射規則是非常輕量級的,不像一些其它的數據庫框架,需要爲每個模型類單獨配置一個映射關係的XML,LitePal的所有映射都是自動完成的。根據LitePal的數據類型支持,可以進行對象關係映射的數據類型一共有8種,int、short、long、float、double、boolean、String和Date。只要是聲明成這8種數據類型的字段都會被自動映射到數據庫表中,並不需要進行任何額外的配置。
那麼有的朋友可能會問了,既然是自動映射的話,如果News類中有一個字符串字段我並不想讓它映射到數據庫表中,這該怎麼辦呢?對此,LitePal同樣採用了一種極爲輕量的解決方案,只有聲明成private修飾符的字段纔會被映射到數據庫表中,如果你有某一個字段不想映射的話,只需要將它改成public、protected或default修飾符就可以了。
現在模型類已經建好了,我們還差最後一步,就是將它配置到映射列表當中。編輯assets目錄下的litepal.xml文件,在<list>標籤中加入News模型類的聲明:
- <?xml version="1.0" encoding="utf-8"?>
- <litepal>
- <dbname value="demo" ></dbname>
- <version value="1" ></version>
- <list>
- <mapping class="com.example.databasetest.model.News"></mapping>
- </list>
- </litepal>
OK,這樣所有的工作就都已經完成了,現在只要你對數據庫有任何的操作,news表就會被自動創建出來。比如說LitePal提供了一個便捷的方法來獲取到SQLiteDatabase的實例,如下所示:
- SQLiteDatabase db = Connector.getDatabase();
可以看到,news表已經存在了。另外兩張android_metadata和table_schema表是自動生成的,我們不用理。接下來我們還可以再查詢一下news表的建表語句,如下圖所示:
這就是LitePal根據News類中的字段自動幫我們生成的建表語句,由此也說明,建表操作已經成功完成了。