当前位置: 首页 > 工具软件 > LitePal > 使用案例 >

android litepal可以指定存储目录吗,Android LitePal第三方库使用详解

陈允晨
2023-12-01

Android LitePal第三方库使用详解

LitePal的Github项目地址

引入LitePal库依赖

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

配置litepal.xml文件

在项目的assets文件夹中创建一个文件,并将其命名为litepal.xml。然后将以下代码复制到其中。

dbname 数据库名称

定义应用程序的数据库名称。

默认情况下,每个数据库名称都应该以.db结尾。

如果你没有将你的数据库命名为.db,例如:

LitePal会自动为你加上后缀。(指数据库文件)

(效果一样)

version 数据库版本号

定义数据库的版本。

每一次你想要升级数据库,version版本标记会有帮助。

修改您在mapping标记中定义的模型。

使version版本值加1,数据库升级将被自动处理。

list 列表标签统一管理映射的实体类

使用mapping映射标签在列表中定义您的模型,LitePal会这样做:

为每个映射类创建表的支持字段。

在模型中定义的将被映射到列(字段)中。

通俗来讲,list标签相当于数据库容器,里面可以有一张表或多张表

mapping 实体类映射全路径

配置映射的实体类。

该实体类需继承LitePalSupport。

storage 数据库存储位置

定义.db文件的位置。

“internal”指的是.db文件将存储在数据库文件夹(databases)的内部存储。

那里没有人可以访问,需要root权限才行。

“external”表示.db文件将存储在到主外部存储设备上的目录的路径。

应用程序将放置任何人都可以操作的数据库文件。

storage标签可省略,“internal”将作为默认值。

配置LitePalApplication

您不希望总是传递上下文参数。为了简化api,只需在AndroidManifest.xml中配置LitePalApplication,如下所示:

android:name="org.litepal.LitePalApplication"

...

>

...

当然,您可能有自己的应用程序,并已在这里配置,如:

android:name="com.example.MyOwnApplication"

...

>

...

没关系。LitePal仍然可以接受。在你自己的应用程序中调用LitePal.initialize(context),如:

public class MyOwnApplication extends Application {

@Override

public void onCreate() {

super.onCreate();

LitePal.initialize(this);

}

...

}

确保尽早调用此方法。在应用程序的onCreate()方法中是可以的。

并始终记住将应用程序上下文用作参数。

不要将Activity或Service的任何实例用作参数,否则可能会发生内存泄漏。

开始演示

配置完成后,您就可以体验这些强大的功能了。

创建表

首先定义模型。例如,您有两个模型,Album和Song。模型定义如下:

public class Album extends LitePalSupport {

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

private String name;

private float price;

private byte[] cover;

private List songs = new ArrayList();

// 生成的getter和setter。

...

}

public class Song extends LitePalSupport {

@Column(nullable = false)

private String name;

private int duration;

@Column(ignore = true)

private String uselessField;

private Album album;

// 生成的getter和setter。

...

}

然后将这些模型添加到litepal.xml的映射列表中:

好的!这些表将在下次操作数据库时生成。例如,获取带有以下代码的SQLiteDatabase:

SQLiteDatabase db = LitePal.getDatabase();

现在表将自动生成的SQLs语句像这样的:

CREATE TABLE album (

id integer primary key autoincrement,

name text unique default 'unknown',

price real,

cover blob

);

CREATE TABLE song (

id integer primary key autoincrement,

name text not null,

duration integer,

album_id integer

);

升级表

在LitePal中升级表是非常容易的。只要修改您的模型,只要您想:

public class Album extends LitePalSupport {

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

private String name;

@Column(ignore = true)

private float price;

private byte[] cover;

private Date releaseDate;

private List songs = new ArrayList();

// 生成的getter和setter。

...

}

添加了releaseDate字段,并将price字段注释为忽略。然后在litepal.xml中增加版本号:

这些表将在下次操作数据库时更新。releaseDate列将被添加到 album表中,而原来的price列将被删除。除了删除的列之外,album表中的所有数据都将保留。

但有一些升级条件LitePal无法处理,升级表中的所有数据将被清理:

添加一个注释为unique = true的字段。

将字段的注释更改为unique = true。

将字段的注释更改为nullable = false。

请注意以上可能导致数据丢失的情况。

这是因为unique约束不能为空,nullable = false也不能为空,添加了该字段无法一一赋值,所以会清空表。

数据存档

保存API是面向对象的。从LitePalSupport继承的每个模型都可以免费使用save()方法。

Album album = new Album();

album.setName("album");

album.setPrice(10.99f);

album.setCover(getCoverImageBytes());

album.save();

Song song1 = new Song();

song1.setName("song1");

song1.setDuration(320);

song1.setAlbum(album);

song1.save();

Song song2 = new Song();

song2.setName("song2");

song2.setDuration(356);

song2.setAlbum(album);

song2.save();

这将插入album,song1和song2到数据库相关联的表。

修改数据

最简单的方法是使用save()方法来更新由find()找到的记录。

Album albumToUpdate = LitePal.find(Album.class, 1);

albumToUpdate.setPrice(20.99f); // raise the price

albumToUpdate.save();

从LitePalSupport继承的每个模型还具有update()和updateAll()方法。您可以使用指定的id更新单个记录。

Album albumToUpdate = new Album();

albumToUpdate.setPrice(20.99f); // raise the price

albumToUpdate.update(id);

或者您可以使用where条件更新多条记录。

Album albumToUpdate = new Album();

albumToUpdate.setPrice(20.99f); // raise the price

albumToUpdate.updateAll("name = ?", "album");

删除数据

您可以使用LitePal中的静态delete()方法删除单个记录。

LitePal.delete(Song.class, id);

或者使用LitePal中的静态deleteAll()方法删除多个记录。

LitePal.deleteAll(Song.class, "duration > ?" , "350");

查询数据

从指定id的song表中查找单个记录。

Song song = LitePal.find(Song.class, id);

从song表中查找所有记录。

List allSongs = LitePal.findAll(Song.class);

用流畅查询构造复杂查询。

List songs = LitePal.where("name like ? and duration < ?", "song%", "200").order("duration").find(Song.class);

当然也可以使用SQL语句来查询:

Cursor cursor = LitePal.findBySQL("select * from song");

异步操作

默认情况下,每个数据库操作都在主线程上。如果您的操作可能花费了很长的时间,例如保存或查询大量的记录。您可能需要使用异步操作。

LitePal.findAllAsync(Song.class).listen(new FindMultiCallback() {

@Override

public void onFinish(List allSongs) {

}

});

只需使用findAllAsync()而不是findAll(),并附加一个listen()方法,一旦完成,查找结果将回调到onFinish()方法。

Abd异步保存也是一样的。

Album album = new Album();

album.setName("album");

album.setPrice(10.99f);

album.setCover(getCoverImageBytes());

album.saveAsync().listen(new SaveCallback() {

@Override

public void onFinish(boolean success) {

}

});

只需使用saveAsync()而不是save()。它将相册保存到后台的数据库中,保存的结果是回调到onFinish()方法。

多个数据库

如果你的应用需要多个数据库,LitePal完全支持它。您可以在运行时创建任意多的数据库。例如:

LitePalDB litePalDB = new LitePalDB("demo2", 1);

litePalDB.addClassName(Singer.class.getName());

litePalDB.addClassName(Album.class.getName());

litePalDB.addClassName(Song.class.getName());

LitePal.use(litePalDB);

这将创建一个带有singer、album和song表的demo2数据库。

如果您只想创建一个与litepal配置(litepal.xml)相同的新数据库。您可以用:

LitePalDB litePalDB = LitePalDB.fromDefault("newdb");

LitePal.use(litePalDB);

你可以随时切换回默认数据库,如:

LitePal.useDefault();

并且可以通过指定的数据库名称删除任何数据库,如:

LitePal.deleteDatabase("newdb");

监听数据库创建或升级

如果你需要监听数据库创建或升级事件,并在回调中填充一些初始数据,你可以这样做:

LitePal.registerDatabaseListener(new DatabaseListener() {

@Override

public void onCreate() {

// fill some initial data

}

@Override

public void onUpgrade(int oldVersion, int newVersion) {

// upgrade data in db

}

});

代码混淆

如果您使用代码混淆,您可能需要添加以下选项:

-keep class org.litepal.** {

*;

}

-keep class * extends org.litepal.crud.DataSupport {

*;

}

-keep class * extends org.litepal.crud.LitePalSupport {

*;

}

结语

以上是我翻译的LitePal教程,如有错误请留言指出,对您有帮助麻烦点个赞呗,谢谢!

标签:album,Album,Song,数据库,LitePal,详解,Android,class

来源: https://blog.csdn.net/weixin_42895893/article/details/106294948

 类似资料: