LitePal使用詳解

一.配置環境

LitePal源碼地址：https://github.com/LitePalFramework/LitePal

參考網址：https://blog.csdn.net/guolin_blog/article/details/82714414

https://www.cnblogs.com/whycxb/p/9388040.html

1.1引入庫

在moudle級別的build.gradle添加以下代碼，根據開發語言環境的不同設置不同語言

如果你使用的是Java，那麼就在build.gradle中引入如下配置：

implementation 'org.litepal.android:java:3.0.0'

而如果你使用的是Kotlin，那麼就在build.gradle中引入如下配置：

implementation 'org.litepal.android:kotlin:3.0.0'

1.2創建配置litepal.xml

1.2.1：new->directory->新建一個assets目錄

1.2.2：new->file->命名爲litepal.xml(目標是配置xml文件)

 1.2.3.參數定義說明

<?xml version="1.0" encoding="utf-8"?>
<litepal>
    <dbname value="任意" ></dbname> //數據庫名稱

    <version value="任意" ></version>  //數據庫版本號

    <list>
        <mapping class="定義信息類的路徑"></mapping> //用於設定所有的映射模型,即你定義數據庫表的類名路徑

    </list>
</litepal>

 1.2.4.參考格式

1.3初始化配置

1.3.1在baseApplication初始化litePal

       /*=================litepal數據庫=====================*/
        LitePal.initialize(this);
        //獲取到SQLiteDatabase的實例，創建數據庫表
        SQLiteDatabase db = LitePal.getDatabase();

1.3.2監聽數據庫的創建和升級

LitePal.registerDatabaseListener(new DatabaseListener() {
    @Override
    public void onCreate() {
    }

    @Override
    public void onUpgrade(int oldVersion, int newVersion) {
    }
});
需要注意的是，registerDatabaseListener()方法一定要確保在任何其他數據庫操作之前調用，然後當數據庫創建的時候，onCreate()方法就會得到回調，當數據庫升級的時候onUpgrade()方法就會得到回調，並且告訴通過參數告訴你之前的老版本號，以及升級之後的新版本號。

二.Litepal使用

2.1創建表

新建bean類並繼承LitePalSupport（擁有了進行CRUD操作的能力）

@cloum解釋

//運用註解來爲字段添加index標籤

//name是唯一的不可重複，且默認值爲unknown

@Column(unique = true, defaultValue = "unknown")

//忽略即是不在數據庫中創建該屬性對應的字段

@Column(ignore = true)

//不爲空

@Column(nullable = false)

源碼：

 

將該bean類配置到映射列表(litepal.xml)當中

2.2升級表

如果已有的表bean類中新增、減少、修改字段或者新建表的bean類，都需要升級表。

• 新建bean類並繼承LitePalSupport

　　如果升級的是已有表，則添加、刪除、修改已有表的字段。

• 在映射列表litepal.xml中新增bean類，並將版本號+1【如果升級的是已有表，則只將版本號+1】

<!-- <version>用於設定數據庫的版本號 -->
    <version value="2" ></version>

• 執行SQLiteDatabase db = Connector.getDatabase();

2.3命令解釋

2.3.1存儲數據

2.3.2修改數據

2.3.3查詢數據

2.3.4刪除數據