2020-4-8 seo達(dá)人
文章目錄
1.簡(jiǎn)介
2.特性
3.演示
3.1 集成
3.2 配置
3.3 創(chuàng)建數(shù)據(jù)庫(kù)
3.4 升級(jí)數(shù)據(jù)庫(kù)
3.5 插入數(shù)據(jù)
3.6 查詢數(shù)據(jù)
3.7 更新數(shù)據(jù)
3.8 刪除數(shù)據(jù)
4.版本異同
5.源碼地址
1.簡(jiǎn)介
Litepal——作為帶我入行的第一本教學(xué)書(shū)籍《Android第一行代碼》的作者郭霖老師所寫(xiě)出來(lái)的持久化框架，幾乎算是我接觸Android世界之后第一個(gè)遇到的框架，故將該框架列為一系列學(xué)習(xí)框架博客的首位。
根據(jù)Litepal的GitHub主頁(yè)：Litepal，可以看到該框架的一些簡(jiǎn)介：
LitePal is an open source Android library that allows developers to use SQLite database extremely easy. You can finish most of the database operations without writing even a SQL statement, including create or upgrade tables, crud operations, aggregate functions, etc. The setup of LitePal is quite simple as well, you can integrate it into your project in less than 5 minutes.
事實(shí)上，正如這段簡(jiǎn)介所說(shuō)，集成Litepal相當(dāng)簡(jiǎn)單，不需要超過(guò)五分鐘時(shí)間。使用Litepal，也適合對(duì)sql語(yǔ)言還不熟悉的開(kāi)發(fā)者快速上手。
2.特性
讓我們繼續(xù)瀏覽Litepal的GitHub主頁(yè)，可以發(fā)掘Litepal的一些特性：
Using object-relational mapping (ORM) pattern.
Almost zero-configuration(only one configuration file with few properties).
Maintains all tables automatically(e.g. create, alter or drop tables).
Multi databases supported.
Encapsulated APIs for avoiding writing SQL statements.
Awesome fluent query API.
Alternative choice to use SQL still, but easier and better APIs than the originals.
More for you to explore.
用大白話來(lái)描述的話，可以列舉如下：
Litepal使用了ORM（對(duì)象關(guān)系映射）模型
Litepal幾乎是無(wú)配置的，僅需極少的配置文件
Litepal幾乎包括所有的CRUD操作，也支持多張表格的操作
Litepal可以僅調(diào)用api進(jìn)行CRUD操作而避免編寫(xiě)sql語(yǔ)句
總之，看到Litepal具有這么多良好的特性，讀者是否心動(dòng)了呢。理論的話不多說(shuō)，我們現(xiàn)在就開(kāi)始正式地使用Litepal進(jìn)行數(shù)據(jù)庫(kù)的相關(guān)操作
PS：如果有曾經(jīng)學(xué)習(xí)過(guò)Java的ORM框架——Mybatis的讀者，應(yīng)該不會(huì)對(duì)Litepal的使用太陌生，因?yàn)樗鼈兌际褂昧藊ml文件進(jìn)行相應(yīng)的配置
3.演示
3.1 集成
現(xiàn)在Android框架的集成相比于IDE還為ADT的時(shí)代，要方便了許多。原因是現(xiàn)在的主流IDE是Android Studio，而AS默認(rèn)使用了Gradle進(jìn)行版本的配置管理，這讓集成框架變得簡(jiǎn)單了許多。
在build.gradle下，添加以下語(yǔ)句，然后重新sync，即可將Litepal集成到你的項(xiàng)目中：
implementation 'org.litepal.android:java:3.0.0'
1
當(dāng)然，目前Android的主流開(kāi)發(fā)語(yǔ)言，除了Java之外，還有Kotlin，Litepal同樣具有Kotlin版本的（這里的演示僅針對(duì)Java，Kotlin版本的異曲同工）依賴：
implementation 'org.litepal.android:kotlin:3.0.0'
1
可以根據(jù)個(gè)人需求進(jìn)行配置。
3.2 配置
集成了Litepal之后，要想正式使用它還需要進(jìn)行一些配置
在assets目錄下新建litepal.xml，作為L(zhǎng)itepal的全局配置文件，相應(yīng)的條目信息已作出注釋，代碼如下：
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<!-- 數(shù)據(jù)庫(kù)名 -->
<dbname value="androidframelearn"/>
<!-- 數(shù)據(jù)庫(kù)版本號(hào) -->
<version value="1"/>
<!-- 指定映射模型 -->
<list>
</list>
<!-- 指定文件的存儲(chǔ)方式 -->
<!-- <storage value="external" />-->
</litepal>
在你的應(yīng)用下配置Litepal，有兩種方式可以實(shí)現(xiàn)：
修改清單文件，將你的應(yīng)用名修改為：android:name="org.litepal.LitePalApplication"
新建一個(gè)自己寫(xiě)的MyOwnApplication類，然后將清單文件中的應(yīng)用名定位到該類，即：android:name="com.example.MyOwnApplication"，然后再編寫(xiě)MyOwnApplication類，代碼如下：
public class MyOwnApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
LitePal.initialize(this);
}
...
}
兩種方式亦可，Litepal的作者建議若使用第二種方式，需要盡快地調(diào)用LitePal.initialize(this);所以將其放在onCreate()方法是最好的。
3.3 創(chuàng)建數(shù)據(jù)庫(kù)
剛才在介紹的時(shí)候已經(jīng)說(shuō)過(guò)，Litepal采取的是對(duì)象關(guān)系映射(ORM)的模式，那么什么是對(duì)象關(guān)系映射呢？簡(jiǎn)單點(diǎn)說(shuō)，我們使用的編程語(yǔ)言是面向?qū)ο笳Z(yǔ)言，而使用的數(shù)據(jù)庫(kù)則是關(guān)系型數(shù)據(jù)庫(kù),那么將面向?qū)ο蟮恼Z(yǔ)言和面向關(guān)系的數(shù)據(jù)庫(kù)之間建立一種映射關(guān)系，這就是對(duì)象關(guān)系映射了。
不過(guò)你可千萬(wàn)不要小看對(duì)象關(guān)系映射模式，它賦予了我們一個(gè)強(qiáng)大的功能，就是可以用面向?qū)ο蟮乃季S來(lái)操作數(shù)據(jù)庫(kù)，而不用再和SQL語(yǔ)句打交道了，不信的話我們現(xiàn)在就來(lái)體驗(yàn)一下。像往常使用SQLiteOpenHelper類，為了創(chuàng)建一張Book表需要先分析表中應(yīng)該包含哪些列，然后再編寫(xiě)出一條建表語(yǔ)句，最后在自定義的SQLiteOpenHelper中去執(zhí)行這條建表語(yǔ)句。但是使用LitePal，你就可以用面向?qū)ο蟮乃季S來(lái)實(shí)現(xiàn)同樣的功能了，定義一個(gè)Book類，代碼如下所示：
package com.androidframelearn.dao_litapal;
import org.litepal.crud.LitePalSupport;
public class Book extends LitePalSupport {
private int id;
private String author;
private double price;
private int pages;
private String name;
public int getId(){
return id;
}
public void setId(int id){
this.id = id;
}
public String getAuthor(){
return author;
}
public void setauthor(String author){
this.author = author;
}
public double getPrice(){
return price;
}
public void setPrice(double price){
this.price = price;
}
public int getPages(){
return pages;
}
public void setPages(int pages){
this.pages = pages;
}
public String getName(){
return name;
}
public void setName(String name){
this.name = name;
}
}
這里使用標(biāo)簽來(lái)聲明我們要配置的映射模型類，注意一定要使用完整的類名。不管有多少模型類需要映射，都使用同樣的方式配置在標(biāo)簽下即可。
沒(méi)錯(cuò)，這樣就已經(jīng)把所有工作都完成了，現(xiàn)在只要進(jìn)行任意一次數(shù)據(jù)庫(kù)的操作，BookStore.db數(shù)據(jù)庫(kù)應(yīng)該就會(huì)自動(dòng)創(chuàng)建出來(lái)。為了更好地演示代碼，我們將布局文件所需要的功能一次性編寫(xiě)好，activity_main.xml代碼如下：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity"
android:orientation="vertical">
<Button
android:id="@+id/btn_db_create"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="創(chuàng)建數(shù)據(jù)庫(kù)"/>
<Button
android:id="@+id/btn_db_query"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="查詢數(shù)據(jù)"/>
<Button
android:id="@+id/btn_db_insert"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="插入數(shù)據(jù)"/>
<Button
android:id="@+id/btn_db_update"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="更新數(shù)據(jù)"/>
<Button
android:id="@+id/btn_db_delete"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="刪除數(shù)據(jù)"/>
</LinearLayout>
接下來(lái)，修改MainActivity，除了給按鈕注冊(cè)點(diǎn)擊事件，還需要編寫(xiě)不同的方法代表不同的邏輯，其中，創(chuàng)建數(shù)據(jù)庫(kù)的方法代碼如下：
private void createDBbyLitePal() {
btn_db_create.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Log.i(TAG,"創(chuàng)建數(shù)據(jù)庫(kù)成功");
LitePal.getDatabase();
}
});
}
僅僅通過(guò)點(diǎn)擊按鈕，調(diào)用LitePal.getDatabase();這句api，就可以創(chuàng)建出數(shù)據(jù)庫(kù)，讓我們實(shí)際進(jìn)入項(xiàng)目中嘗試一下吧！點(diǎn)擊該按鈕，然后查看控制臺(tái)，如圖所示：
出現(xiàn)該句日記，說(shuō)明數(shù)據(jù)庫(kù)創(chuàng)建成功，接下來(lái)我們看看這個(gè)數(shù)據(jù)庫(kù)是否按照我們所設(shè)置好的格式創(chuàng)建出來(lái)了，進(jìn)入data/data/你的項(xiàng)目包名/databases，即可查看到該數(shù)據(jù)庫(kù)已經(jīng)放置到該目錄下，如圖所示：
3.4 升級(jí)數(shù)據(jù)庫(kù)
事實(shí)上，若想對(duì)現(xiàn)有數(shù)據(jù)庫(kù)進(jìn)行升級(jí)，也是可以實(shí)現(xiàn)的。以前我們使用SQLiteOpenHelper來(lái)升級(jí)數(shù)據(jù)庫(kù)的方式，雖說(shuō)功能是實(shí)現(xiàn)了，但你有沒(méi)有發(fā)現(xiàn)一個(gè)問(wèn)題,，就是升級(jí)數(shù)據(jù)庫(kù)的時(shí)候我們需要先把之前的表drop掉，然后再重新創(chuàng)建才行。這其實(shí)是一個(gè)非常嚴(yán)重的問(wèn)題，因?yàn)檫@樣會(huì)造成數(shù)據(jù)丟失，每當(dāng)升級(jí)一次數(shù)據(jù)庫(kù)，之前表中的數(shù)據(jù)就全沒(méi)了。
而使用Litepal，就可以很好地避免這個(gè)問(wèn)題。假設(shè)我們現(xiàn)在有一張新的表Category要加進(jìn)去，同樣編寫(xiě)它的實(shí)體類，代碼如下：
package com.androidframelearn.dao_litapal;
public class Category {
private int id;
private String categoryName;
private int categoryCode;
public int getId(){
return id;
}
public void setId(int id){
this.id = id;
}
public String getCategoryName(){
return categoryName;
}
public void setCategoryName(String categoryName){
this.categoryName = categoryName;
}
public int getCategoryCode(){
return categoryCode;
}
public void setCategoryCode(int categoryCode){
this.categoryCode = categoryCode;
}
}
改完了所有我們想改的東西，只需要記得在litepal.xml將版本號(hào)加1就行了。當(dāng)然由于這里還添加了一個(gè)新的模型類，因此也需要將它添加到映射模型列表中。修改litepal.xml中的代碼，如下所示：
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<!-- 數(shù)據(jù)庫(kù)名 -->
<dbname value="androidframelearn"/>
<!-- 數(shù)據(jù)庫(kù)版本號(hào) -->
<version value="2"/>
<!-- 指定映射模型 -->
<list>
<mapping class="com.androidframelearn.dao_litapal.Book"/>
<mapping class="com.androidframelearn.dao_litapal.Category"/>
</list>
<!-- 指定文件的存儲(chǔ)方式 -->
<!-- <storage value="external" />-->
</litepal>
重新運(yùn)行一下程序，再次創(chuàng)建數(shù)據(jù)庫(kù)，就可以完美地完成數(shù)據(jù)庫(kù)的升級(jí)了。這里的調(diào)試可以使用sqlite工具，這里不再贅述。
3.5 插入數(shù)據(jù)
在講述本節(jié)時(shí)，首先回顧一下之前添加數(shù)據(jù)的方法，我們需要?jiǎng)?chuàng)建出一個(gè)Contentvalues對(duì)象，然后將所有要添加的數(shù)據(jù)put到這個(gè)Contentvalues對(duì)象當(dāng)中，最后再調(diào)用SQLiteDatabase的insert() 方法將數(shù)據(jù)添加到數(shù)據(jù)庫(kù)表當(dāng)中，步驟相當(dāng)繁瑣。
而使用LitePal來(lái)添加數(shù)據(jù)，這些操作可以簡(jiǎn)單到讓你驚嘆！我們只需要?jiǎng)?chuàng)建出模型類的實(shí)例，再將所有要存儲(chǔ)的數(shù)據(jù)設(shè)置好，最后調(diào)用一下save()方法就可以了。
同樣地，修改MainActivity，增加插入數(shù)據(jù)的事件方法，代碼如下：
private void insertDatabyLitePal() {
btn_db_insert.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Book book = new Book();
book.setName("The Da Vinci Code");
book.setauthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.save();
Log.i(TAG,"插入數(shù)據(jù)成功");
}
});
}
同樣運(yùn)行程序，查看控制臺(tái)，如圖所示：
當(dāng)點(diǎn)擊查詢數(shù)據(jù)（下一節(jié)將介紹該邏輯）時(shí)，控制臺(tái)打印剛剛插入的數(shù)據(jù)，如圖所示：
3.6 查詢數(shù)據(jù)
使用Litepal同樣可以很輕易地查詢數(shù)據(jù)，當(dāng)然了，由于篇幅限制，這里僅僅貼出最簡(jiǎn)單的查詢方式，至于關(guān)聯(lián)查詢等稍復(fù)雜的查詢方式，可以去GItHub上參考Litepal的官方文檔進(jìn)行相關(guān)調(diào)用即可。
同樣地，修改MainActivity，增加查看數(shù)據(jù)的事件方法，代碼如下：
private void queryDatabyLitePal() {
btn_db_query.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
List<Book> books = LitePal.findAll(Book.class);
for (Book book : books){
Log.i(TAG,"查詢數(shù)據(jù)成功");
Log.d("MainActivity","書(shū)名是"+book.getName());
Log.d("MainActivity","書(shū)的作者是"+book.getAuthor());
Log.d("MainActivity","書(shū)的頁(yè)數(shù)是"+book.getPages());
Log.d("MainActivity","書(shū)的價(jià)格是"+book.getPrice());
}
}
});
}
相關(guān)的運(yùn)行結(jié)果上一小節(jié)以貼出，這里不再重復(fù)。
3.7 更新數(shù)據(jù)
更新數(shù)據(jù)要比添加數(shù)據(jù)稍微復(fù)雜一點(diǎn)，因?yàn)樗腁PI接口比較多，這里我們只介紹最常用的幾種更新方式。
首先，最簡(jiǎn)單的一種更新方式就是對(duì)已存儲(chǔ)的對(duì)象重新設(shè)值，然后重新調(diào)用save()方法即可。那么這里我們就要了解一個(gè)概念，什么是已存儲(chǔ)的對(duì)象？
對(duì)于LitePal來(lái)說(shuō)，對(duì)象是否已存儲(chǔ)就是根據(jù)調(diào)用model.isSaved()方法的結(jié)果來(lái)判斷的， 返回true就表示已存儲(chǔ)，返回false就表示未存儲(chǔ)。那么接下來(lái)的問(wèn)題就是，什么情況下會(huì)返回true，什么情況下會(huì)返回false呢？
實(shí)際上只有在兩種情況下model.isSave()方法才會(huì)返回true, 一種情況是已經(jīng)調(diào)用過(guò)model. save()方法去添加數(shù)據(jù)了，此時(shí)model會(huì)被認(rèn)為是已存儲(chǔ)的對(duì)象。另一種情況是model對(duì)象是通過(guò)LitePal提供的查詢API查岀來(lái)的，由于是從數(shù)據(jù)庫(kù)中查到的對(duì)象，因此也會(huì)被認(rèn)為是已存儲(chǔ)的對(duì)象。
由于查詢API相對(duì)復(fù)雜，因此只能先通過(guò)第一種情況來(lái)進(jìn)行驗(yàn)證。修改MainActivity中的代碼，如下所示：
private void updateDatabyLitePal() {
btn_db_update.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Book book = new Book();
book.setName("The Lost Symbol");
book.setauthor("Dan Brown");
book.setPages(510);
book.setPrice(19.95); // 第一次設(shè)置商品價(jià)格
book.save();
book.setPrice(10.99); // 第二次設(shè)置商品價(jià)格
book.save();
Log.i(TAG,"更新數(shù)據(jù)成功");
}
});
}
可以看到，我們做了跟插入數(shù)據(jù)類似的事情，但是我們對(duì)數(shù)據(jù)的價(jià)格進(jìn)行了設(shè)置，運(yùn)行程序，如圖所示：
可以看到，除了剛剛插入的數(shù)據(jù)，還有第二條剛剛更新過(guò)后的數(shù)據(jù)。然而這種更新方式只能對(duì)已存儲(chǔ)的對(duì)象進(jìn)行操作，限制性比較大，接下來(lái)我們學(xué)習(xí)另外一種更加靈巧的更新方式，可以調(diào)用以下api：
book.updateAll("name = ? and author = ?","The Lost Symbol","Dan Brown");
1
這里僅貼出其中一條api，其他的可以參考官方文檔，這里不再贅述。
3.8 刪除數(shù)據(jù)
使用Litepal刪除數(shù)據(jù)的方式主要有兩種，第一種比較簡(jiǎn)單，就是直接調(diào)用已存儲(chǔ)對(duì)象的delete()方法就可以了，對(duì)于已存儲(chǔ)對(duì)象的概念，我們?cè)谥耙呀?jīng)學(xué)習(xí)過(guò)了。也就是說(shuō)，調(diào)用過(guò)save()方法的對(duì)象，或者是通過(guò)LitePal提供的查詢API查出來(lái)的對(duì)象，都是可以直接使用delete()方法來(lái)刪除數(shù)據(jù)的。這種方式比較簡(jiǎn)單，我們就不進(jìn)行代碼演示了，下面直接來(lái)看另外一種刪除數(shù)據(jù)的方式。
代碼如下：
private void deleteDatabyLitePal() {
btn_db_delete.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
LitePal.deleteAll(Book.class,"price < ?","15");
Log.i(TAG,"刪除成功");
}
});
}
運(yùn)行程序，刪除過(guò)后，按照代碼邏輯，已經(jīng)刪除掉了所有price小于15的條目，如圖所示：
4.版本異同
之前閱讀了郭霖老師所著《Android第一行代碼 第二版》時(shí)，所記載的Litepal版本為：
compile 'org.litepal.android:core:1.4.1'
1
而的Litepal版本（Java版本，另有Kotlin版本，導(dǎo)入的依賴稍有不同）為：
implementation 'org.litepal.android:java:3.0.0'
1
新舊版本的主要區(qū)別是一些類名的劃分，例如老板本的DataSupport變成了LitePalSupport，除此之外，一些api的名稱也稍有變動(dòng)，讀者在使用時(shí)最好可以參考GitHub上的官方文檔，及時(shí)更新代碼，做到與時(shí)俱進(jìn)。
5.源碼地址
AFL——Android框架學(xué)習(xí)
藍(lán)藍(lán)設(shè)計(jì)的小編 http://www.gyxygd.cn