Android LitePal的使用詳解
前言
數(shù)據(jù)庫(kù)操作一直都是比較繁瑣而且單一的東西,平時(shí)開(kāi)發(fā)中數(shù)據(jù)庫(kù)也很常見(jiàn)。有學(xué)過(guò)mysql的讀者可能會(huì)覺(jué)得sql語(yǔ)句確實(shí)讓人很難受。同樣android中,雖然有內(nèi)置數(shù)據(jù)庫(kù)SQLite,但是操作起來(lái)還是非常的不方便。跟網(wǎng)絡(luò)請(qǐng)求類似,當(dāng)我們用原生的HttpURLConnection請(qǐng)求數(shù)據(jù)再用json解析,過(guò)程很繁瑣,所以我們一般是封裝成一個(gè)工具類,但是retrofit出現(xiàn)了,他幫我們解決了網(wǎng)絡(luò)請(qǐng)求和解析數(shù)據(jù)的封裝,同時(shí)還支持RxJava的異步,十分強(qiáng)大。不了解retrofit的讀者也建議你們?nèi)W(xué)習(xí)一下retrofit確實(shí)非常好用。LitePal也是同樣的道理,把創(chuàng)建數(shù)據(jù)庫(kù)和增刪查改等等操作都封裝起來(lái),所以我們用起來(lái)會(huì)非常的方便。同時(shí)還支持異步操作,不需要我們自己去開(kāi)啟子線程,代碼非常的整潔,簡(jiǎn)單。那接下來(lái)就來(lái)看看這個(gè)神奇的框架LitePal。
簡(jiǎn)述映射
LitePal是采用映射的方式來(lái)把數(shù)據(jù)存儲(chǔ)在數(shù)據(jù)庫(kù)中的,和GSON的道理是一樣的。例如我們現(xiàn)在有一個(gè)類,這個(gè)類必須是javaBean類:
public class Student extends LitePalSupport { private String name; private int age; public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } }
那么他在數(shù)據(jù)庫(kù)中就會(huì)有一個(gè)表,這個(gè)表有三列:id,name和age,id是自動(dòng)生成的,這樣就可以理解映射了吧。所以我們使用LitePal的時(shí)候不用去指定每一列是什么,只需要給他一個(gè)Bean類,自動(dòng)就會(huì)生成了。
配置LitePal
LitePal使用之前需要先配置一下,一共分為兩步:
- 添加依賴庫(kù):在app/build.gradle中添加如下內(nèi)容:
dependencies { implementation 'org.litepal.android:java:3.0.0' }
其中3.0.0是版本號(hào),寫這個(gè)文章的時(shí)候是3.0,他更新也是很快的,讀者可以自行到文末進(jìn)入官網(wǎng)查詢最新的版本號(hào)。添加完之后sync一下就行了。
- 修改AndroidManifest中的代碼:添加一句android:name=”org.litepal.LitePalApplication”:
<application android:name="org.litepal.LitePalApplication" ... <application
添加這句的意思是讓啟動(dòng)app的時(shí)候會(huì)自動(dòng)實(shí)例化LitePalApplication這個(gè)類供給LitePal這個(gè)框架使用。如果有自己寫了一個(gè)android:name的,那么只需要添加這一句LitePal.initialize(context);就可以了。其中的context參數(shù)為全局app的context。例如: ```java public class myApplication extends Application { private static Context context; @Override public void onCreate() { super.onCreate(); context = getApplicationContext(); LitePal.initialize(context); } }
- 在main目錄下創(chuàng)建一個(gè)Directory:assets。然后再assets目錄下再創(chuàng)建一個(gè)litepal.xml,如下圖:
- 編輯litepal.xml中的內(nèi)容:
<?xml version="1.0" encoding="utf-8"?> <litepal> <dbname value="bookStore"/> <version value="1"/> <list> </list>
``` dbname就是數(shù)據(jù)庫(kù)的名字,version是數(shù)據(jù)庫(kù)的版本,list中是數(shù)據(jù)庫(kù)中的表,可以在這里添加,怎么添加后面會(huì)講到。
CRUD操作
常規(guī)增刪查改操作,但是在這個(gè)框架下都顯得特別的簡(jiǎn)單。
增加表和數(shù)據(jù)
例如我們現(xiàn)在要在數(shù)據(jù)庫(kù)中創(chuàng)建一個(gè)學(xué)生的表,首先要?jiǎng)?chuàng)建一個(gè)學(xué)生的類,再讓他繼承LitePalSupport類,至于為什么下面會(huì)講到:
public class Student extends LitePalSupport { private String name; private int age; public String getName() { return name; } public void setName(String name) { this.name = name; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } }
然后在剛才的litepal.xml中添加表:
<list> <mapping class="com.example.myapplication.Student"/> </list>
這里的class要是你的類的真實(shí)目錄,視具體情況而定。 添加其他的表也是同樣的道理。 調(diào)用student對(duì)象的save()方法: ```java Student student = new Student(); student.setAge(12); student.setName("hha"); student.save();
這里的save方法就是繼承前面的LitePalSuppport類的,調(diào)用這個(gè)方法后就會(huì)自動(dòng)添加到庫(kù)中對(duì)應(yīng)的表中的一行。
添加其他行數(shù)據(jù)也是同樣的道理
更改表結(jié)構(gòu)
更新表的列。例如前面的學(xué)生類是name和age,但是如果你想要增加一個(gè)studentId,可以很簡(jiǎn)單地實(shí)現(xiàn)。具體操作如下:
首先更改你的bean類,想怎么改就怎么改
在litepal.xml中更改版本號(hào)增加1.例如:
<?xml version="1.0" encoding="utf-8"?> <litepal> <dbname value="bookStore"/> <version value="2"/> <list> <mapping class="com.example.myapplication.Student"/> </list>
``` 把他改成2就行了。 ## 刪除數(shù)據(jù) 刪除數(shù)據(jù)也很簡(jiǎn)單,有兩種刪除方法,一種是指定行刪除,一種給個(gè)約束條件刪除。 1. 刪除單行: LitePal.delete(Student.class , id); 2. 約束條件: LitePal.deleteAll(Student.class, "age > ?" , "12"); 指定約束條件刪除,?是占位符會(huì)把后面的12放進(jìn)去。 如果只傳入一個(gè)Student.class,那么就會(huì)把整個(gè)表的數(shù)據(jù)都刪除了
查詢數(shù)據(jù)
查詢數(shù)據(jù)的接口都會(huì)返回一個(gè)List,每一行對(duì)應(yīng)一個(gè)對(duì)象。所以是LitePal把數(shù)據(jù)解析都給我們做好了,我們直接拿對(duì)象使用就ok了。這里有幾種方法接口都看一下:
LitePal.findAll(Student.class,id);查詢對(duì)應(yīng)表的對(duì)應(yīng)行,如果沒(méi)有傳入id參數(shù),就返回這個(gè)表的所有內(nèi)容。同樣findFirst是返回第一行,findLast是返回最后一行。
查詢的內(nèi)容還可以進(jìn)行篩選,這里就用到幾個(gè)方法:
- select()對(duì)應(yīng)查哪幾列的內(nèi)容
- where()查詢的約束條件
- order()排序方式
- limit()指定查詢的數(shù)量
- offset()指定結(jié)果的偏移量。這個(gè)可能比較難理解,舉個(gè)例子:假設(shè)你查的id是1,但是你設(shè)置了偏移量是1,那么返回的就是第二行的數(shù)據(jù)。
最后舉一個(gè)綜合例子演示一下:
List<Song> songs = LitePal.where("name like ? and duration < ?", "song%", "200") .order("duration") .select("name") .limit(3) .offset(3) .find(Song.class);
這樣就可以查詢到對(duì)應(yīng)的數(shù)據(jù)了。 # 異步操作 有時(shí)候如果我們的數(shù)據(jù)庫(kù)中的內(nèi)容很多,涉及到重量級(jí)的數(shù)據(jù)庫(kù)操作往往是比較費(fèi)時(shí)的,那么這個(gè)時(shí)候肯定時(shí)不能放在主線程去進(jìn)行操作的,這樣會(huì)造成系統(tǒng)卡死。那么我們就需要去把這個(gè)操作放在子線程中。LitePal早就為我們考慮到這個(gè)問(wèn)題了,所以也增加了異步操作,輕松實(shí)現(xiàn),來(lái)看看怎么用吧。 先看個(gè)例子: ```java LitePal.findAllAsync(Song.class).listen(new FindMultiCallback<Song>() { @Override public void onFinish(List<Song> allSongs) { } });
這是在官網(wǎng)中的例子,要注意的兩個(gè)點(diǎn)
用findAllAsync代替findAll方法
添加listen方法,并新建匿名類FindMultiCallback<>()作為參數(shù),重寫里面的onFinish方法即可
這樣獲取完數(shù)據(jù)后就會(huì)執(zhí)行onFinish方法了
輕松實(shí)現(xiàn)異步操作。同樣這個(gè)可以結(jié)合上面的數(shù)據(jù)篩選。
創(chuàng)建多個(gè)數(shù)據(jù)庫(kù)
如果你一個(gè)數(shù)據(jù)庫(kù)不夠用,想要?jiǎng)?chuàng)建多個(gè)數(shù)據(jù)庫(kù),當(dāng)然也是可以的,看代碼:
LitePalDB litePalDB = new LitePalDB("demo2", 1); litePalDB.addClassName(Singer.class.getName()); LitePal.use(litePalDB);
這里就創(chuàng)建了一個(gè)庫(kù)叫做demo2,并增加了一個(gè)表:Singer。最后執(zhí)行LitePal.use方法來(lái)啟用這個(gè)庫(kù)。這樣的話就默認(rèn)使用這個(gè)庫(kù)了。對(duì)象的save方法都會(huì)執(zhí)行到這個(gè)庫(kù)中
如果想切回到litepal.xml中的那個(gè)庫(kù),可以用下面的方法:
LitePal.useDefault();
如果想刪除一個(gè)庫(kù)(刪庫(kù)跑路可能會(huì)被亂棒打死)
LitePal.deleteDatabase(“demo2”);
是不是很簡(jiǎn)單?
監(jiān)聽(tīng)數(shù)據(jù)庫(kù)創(chuàng)建或者升級(jí)
當(dāng)數(shù)據(jù)庫(kù)創(chuàng)建或者升級(jí)的時(shí)候都會(huì)調(diào)用下面的兩個(gè)方法:
LitePal.registerDatabaseListener(new DatabaseListener() { @Override public void onCreate() { // fill some initial data } @Override public void onUpgrade(int oldVersion, int newVersion) { // upgrade data in db } });
可以在里面寫要執(zhí)行的邏輯。
總結(jié)
LitePal這個(gè)庫(kù)確實(shí)是非常的強(qiáng)大,把很復(fù)雜的數(shù)據(jù)庫(kù)操作都簡(jiǎn)化成了一個(gè)個(gè)的方法。但是更新很快,需要時(shí)刻看著他更新的內(nèi)容,有可能會(huì)換API,所以建議大家多去官網(wǎng)學(xué)習(xí)。
以上就是Android LitePal的使用詳解的詳細(xì)內(nèi)容,更多關(guān)于Android LitePal的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
Kotlin中?和!!的區(qū)別詳細(xì)對(duì)比
這篇文章主要給大家介紹了關(guān)于Kotlin中?和!!區(qū)別的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2021-05-05在Android中 獲取正在運(yùn)行的Service 實(shí)例
本篇文章小編為大家介紹,在Android中 獲取正在運(yùn)行的Service 實(shí)例。需要的朋友參考下2013-04-04通過(guò)源碼角度看看AccessibilityService
這篇文章主要給大家介紹了關(guān)于通過(guò)源碼角度看看AccessibilityService的相關(guān)資料,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2018-06-06Android如何通過(guò)Retrofit提交Json格式數(shù)據(jù)
本篇文章主要介紹了Android如何通過(guò)Retrofit提交Json格式數(shù)據(jù),具有一定的參考價(jià)值,有興趣的可以了解一下2017-08-08Android開(kāi)發(fā)中數(shù)據(jù)庫(kù)升級(jí)且表添加新列的方法
這篇文章主要介紹了Android開(kāi)發(fā)中數(shù)據(jù)庫(kù)升級(jí)且表添加新列的方法,結(jié)合具體實(shí)例形式分析了Android數(shù)據(jù)庫(kù)升級(jí)開(kāi)發(fā)過(guò)程中常見(jiàn)問(wèn)題與相關(guān)操作技巧,需要的朋友可以參考下2017-09-09Android實(shí)現(xiàn)簡(jiǎn)單音樂(lè)播放控件
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)簡(jiǎn)單音樂(lè)播放控件,提供一個(gè)類似網(wǎng)易播放控件的默認(rèn)界面,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-04-04Android使用AudioRecord實(shí)現(xiàn)暫停錄音功能實(shí)例代碼
本篇文章主要介紹了Android使用AudioRecord實(shí)現(xiàn)暫停錄音功能實(shí)例代碼,具有一定的參考價(jià)值,有興趣的可以了解一下2017-06-06android 自定義view實(shí)現(xiàn)彩虹進(jìn)度條功能
實(shí)現(xiàn)一個(gè)彩虹色進(jìn)度條功能,不說(shuō)明具體用途大家應(yīng)該能猜到,想找別人造的輪子,但是沒(méi)有合適的,所以決定自己實(shí)現(xiàn)一個(gè),下面小編通過(guò)實(shí)例代碼給大家分享android 自定義view實(shí)現(xiàn)彩虹進(jìn)度條功能,感興趣的朋友一起看看吧2024-06-06Android使用Scroller實(shí)現(xiàn)彈性滑動(dòng)效果
這篇文章主要介紹了Android使用Scroller實(shí)現(xiàn)彈性滑動(dòng)效果,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-12-12