開源數據庫 LitePal 學習，強大好使的 CRUD

denckom 7年前發布 | 8K 次閱讀 開源 數據庫 安卓開發 Android開發 移動開發

LitePal 簡介

LitePal 是一款開源的 Android 數據庫框架，它采用了對象關系映射（ORM）的模式，將我們平時使用的一些數據庫（比如 Sqlite）功能進行了封裝。

配置

第一步

和我們平時使用開源庫一樣，在項目的 build.gradle 文件下的 dependencies 閉包中添加依賴：

compile 'org.litepal.android:core:1.4.1'

第二步

需要配置 litepal.xml 文件，在 app/src/main 目錄右鍵 -> New -> Directory , 創建一個 assets 目錄，在該目錄下新建一個 litepal.xml 文件，編輯內容如下：

<?xml version="1.0" encoding="utf-8" ?>
<litepal>



<dbname value="AndroidDevelop"></dbname>

<version value="1"></version>

<list>
</list>



</litepal></code></pre> 
  
說明： 這里的 <dbname> 標簽用于指定數據庫名， <version> 標簽用于指定數據庫版本號，<list> 標簽用于指定所有的映射模型。
 
  
第三步
 
  
配置 LitePalApplication
 
  
<application
    android:name="org.litepal.LitePalApplication"
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/AppTheme">
    <activity android:name=".MainActivity">
        <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>
 
  
驗證、創建以及升級數據庫
 
  
經過上面的步驟已經將 LitePal 配置完成，那么現在就通過創建表來驗證一下。
 
  
驗證和創建
 
  
新建一個 AndDev 類：
 
  
package com.example.mu_16jj.litepaldemo.bean;


/**


    

  • Description：AndDev其實就是一張表
    • 

  • <p>
    • 

  • WeChat：mu-16jj
    • 

  • <p>
    • 

  • Created by mu-16jj on 2017/3/29.
*/
    • 



public class AndDev {



private String name;
private int age;
private String sex;
private int workedTime;

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;
}

public String getSex() {
    return sex;
}

public void setSex(String sex) {
    this.sex = sex;
}

public int getWorkedTime() {
    return workedTime;
}

public void setWorkedTime(int workedTime) {
    this.workedTime = workedTime;
}



}</code></pre> 
  
說明： 大家肯定都很熟悉，這就是一個 JavaBean ,定義了幾個屬性，也就是我們的表 AndDev 中有這些字段。
 
  
建好了表之后，接下來還需要將它添加到我們的模型列表中：
 
  
<?xml version="1.0" encoding="utf-8" ?>
<litepal>


<dbname value="AndroidDevelop"></dbname>


<version value="1"></version>


<list>
<mapping class="com.example.mu_16jj.litepaldemo.bean.AndDev"></mapping>
</list>
</litepal></code></pre> 
  
現在我們就可以測試了，啟動一個 Activity ,我這里只添加了一個按鈕，在其點擊事件下寫下面一句代碼：
 
  
LitePal.getDatabase();
 
  
運行程序，點擊按鈕，然后打開 Android Device Monitor 查看結果如下：
 
  
 
  
Android Device Monitor
 
  
可見我們的數據庫確實創建成功了，接下來我們查看表是否創建成功，點擊上圖中的導出圖標
 
  
 
  
從手機導出文件
 
  
，然后利用 SQLite 打開數據庫（也可以通過命令行方式查看），如下圖：
 
  
 
  
AndDev表
 
  
這就證明我們的數據庫和表都創建成功了。
 
  
升級
 
  
就在我們剛剛創建的 AndDev 表里面再增加一個 city（城市）列，只需在 AndDev 中添加 city 字段，設置 getter 和 setter 方法即可（代碼自己添加）；索性我們再添加一張表，名為 Category ，代碼如下：
 
  
package com.example.mu_16jj.litepaldemo.bean;


/**


    

  • Description：技術等級表
    • 

  • <p>
    • 

  • WeChat：mu-16jj
    • 

  • <p>
    • 

  • Created by mu-16jj on 2017/3/29.
*/
    • 



public class Level {



private String primaryLevel;
private String middleLevel;
private String soniorLevel;

public String getPrimaryLevel() {
    return primaryLevel;
}

public void setPrimaryLevel(String primaryLevel) {
    this.primaryLevel = primaryLevel;
}

public String getMiddleLevel() {
    return middleLevel;
}

public void setMiddleLevel(String middleLevel) {
    this.middleLevel = middleLevel;
}

public String getSoniorLevel() {
    return soniorLevel;
}

public void setSoniorLevel(String soniorLevel) {
    this.soniorLevel = soniorLevel;
}




}</code></pre> 
  
我們還需要做最后一步操作，需要將我們的對象和關系型數據庫建立關系：
 
  
 
  
添加表到映射模型
 
  
說明： 可以看到這段代碼相比之前修改了兩個地方，數據庫版本號修改為 2 ，增加了一個 <mapping> 標簽；好了，現在運行程序，點擊按鈕，查看結果：
 
  
 
  
新增加列
 
  
 
  
升級結果
 
  
可以看到，AndDev 表中增加了一個 city 列，level 表也創建成功了。
 
  
添加數據
 
  
前面已經配置好環境，冰成功創建了兩張表，下面我們就針對這兩張表進行CRUD操作，先來給 AndDev 表添加一組數據，在我們的 Activity 上再添加一個按鈕，其點擊事件代碼如下：
 
  
AndDev andDev = new AndDev();
andDev.setAge(25);
andDev.setCity("北京");
andDev.setName("code小生");
andDev.setSex("man");
andDev.setWorkedTime(2);
andDev.save();
 
  
仔細看看上面的代碼，對于最后一行是不是有些疑惑了，這里需要說明的是，litepal 對表的 CRUD 操作依賴一個類 DataSupport ，所以如果我們需要對表進行操作，那么這個實體類就需要繼承 DataSupport 類才可以。
 
  
運行程序，點擊添加按鈕，查看結果：
 
  
 
  
添加數據
 
  
可以看到，一組數據成功添加進了我們的 AndDev 表。
 
  
更新數據
 
  
我們一般的更新就是針對已存儲的對象進行重新設值，那么，LitePal 是怎么判斷某個對象是已存儲的呢？當然提供了方法，通過 model.isSaved() 方法返回結果來判斷，true 表示已存儲，false 表示未存儲，那就需要知道一個概念 [ 什么是已存儲 ]？兩種情況，一種是已經調用過 model.save() 方法去添加數據了；另一種是 model 對象是通過 LitePal 查詢 API 查出來的，那么這兩種情況都會被認為是已存儲的對象。
 
  
第一種更新方式
 
  
AndDev andDev1 = new AndDev();
andDev1.setWorkedTime(3);
andDev1.setSex("woman");
andDev1.setName("codexiaosheng");
andDev1.setAge(26);
andDev1.setCity("杭州");
andDev1.save();
andDev1.setWorkedTime(5);
andDev1.save();
 
  
運行查看結果：
 
  
 
  
對已保存對象更新
 
  
可以看到，新的一條數據被成功插入，而且新插入的對象的 workedtime 值并不是 3 ，而是 5，那么就證明更新確實生效了。但是這種方式太死板，再來看一個比較靈活的方式：
 
  
修改更新按鈕事件代碼如下：
 
  
AndDev andDev1 = new AndDev();
andDev1.setCity("甘肅");
andDev1.setWorkedTime(3);
andDev1.updateAll("age = ? and sex = ?", "26", "woman");
 
  
運行結果：
 
  
 
  
updateAll
 
  
可以看到，將 age = 26 sex = woman 的這條數據的 workedtime 更新為 3 , city 為甘肅。
 
  
注意：
 
  
如果想把某個字段的值置為默認，那么通過對象的 setXXX() 方法是不起作用的（因為根據就不會調用），LitePal 提供了更新默認的方法，比如下面的示例：
 
  
AndDev andDev2 = new AndDev();
andDev2.setToDefault("age");
andDev2.updateAll();
 
  
執行這段代碼，就會將所有年齡置為 0 ，updateAll()方法接收一個可變參數變量，不寫默認就對所有列生效。
 
  
刪除
 
  
我們還是先來看一段代碼執行后的結果，刪除按鈕監聽代碼：
 
  
DataSupport.deleteAll(AndDev.class, "city = ?", "北京");
 
  
結果：
 
  
 
  
deleteAll
 
  
可以看到，刪除了 city 字段值為 “北京”的一條數據。deleteAll() 方法和 updateAll() 方法類似，如果不傳參數，默認刪除表中所有數據。
 
  
查詢
 
  
LitePal 的查詢 API 就更人性化，使用起來挺方便，下面就看例子。在界面添加刪除按鈕，點擊事件執行下面代碼：
 
  
List<AndDev> andDevs = DataSupport.findAll(AndDev.class);
                for (AndDev andDev1 : andDevs) {
                    Log.e("MainActivity", "age: " + andDev1.getAge());
                    Log.e("MainActivity", "name: " + andDev1.getName());
                    Log.e("MainActivity", "sex: " + andDev1.getSex());
                    Log.e("MainActivity", "workedtime: " + andDev1.getWorkedTime());
                    Log.e("MainActivity", "city: " + andDev1.getCity());
                }
 
  
運行查看結果如下：
 
  
 
  
finaAll
 
  
可以看到，表中的所有數據都已查到，這個方法使用起來方便多了。當然了，LitePal 還給我們提供了其他的查詢方法，這里列舉如下：
 
  
findFirst(xxx.class); 查詢表中第一條數據；返回一個實體類對象。
 
  
findLast(xxx.class); 查詢表中最后一條數據；返回一個實體類對象。
 
  
select() 方法用于指定查詢那幾列；返回一個 List 集合；
 
  
DataSupport.select("列名1","列名2").find(實體類.class);
 
  
where() 方法用于指定查詢約束條件；返回一個 List 集合；
 
  
DataSupport.where("age > >", "20").find(實體類.class);
 
  
order() 方法用于指定結果的排序方式；返回一個 List 集合；
 
  
DataSupport.order("age desc").find(實體類.class);
 
  
limit() 方法用于指定查詢結果的數量；返回一個 List 集合；比如只查表中前 2 條數據，寫法如下：
 
  
DataSupport.limit(3).find(實體類.class);
 
  
offset() 方法用于指定查詢數據的偏移量；返回一個 List 集合；比如查表中第 2 條、第 3 條數據，寫法如下：
 
  
DataSupport.limit(2).offset(1).find(實體類.class);
 
  
當然了我們可以將上面的方法組合起來進行復雜查詢：
 
  
// 復雜查詢
List<AndDev> andDevs = DataSupport.select("name", "sex", "age")
                .where("city = ?", "甘肅")
                .order("workedTime")
                .limit(5)
                .offset(2)
                .find(AndDev.class);
 
  
這段代碼表示，查詢 AndDev 表中第 3- 7 條滿足 city 為甘肅這個條件的 name、sex、age 這三列數據，并將查詢結果按照 workedTime 升序排列。
 
  
當然了， LitePal 任然支持原生的 SQL 查詢：
 
  
Cursor cursor = DataSupport.findBySQL("select * from AndDev where age > ? and workedTime < 2", "22", "2");
 
  
 
 
  
 
 
  
來自：http://www.jianshu.com/p/95f2338abe0a
 
  
 
 本文由用戶 denckom 自行上傳分享，僅供網友學習交流。所有權歸原作者，若您的權利被侵害，請聯系管理員。
 轉載本站原創文章，請注明出處，并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺，歡迎各類分享！