Android LitePal第三方库使用详解
作者:互联网
Android LitePal第三方库使用详解
LitePal的Github项目地址
引入LitePal库依赖
implementation 'org.litepal.android:java:3.0.0'
配置litepal.xml文件
在项目的assets文件夹中创建一个文件,并将其命名为
litepal.xml
。然后将以下代码复制到其中。
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="demo" />
<version value="1" />
<list>
<mapping class="com.test.model.Reader" />
<mapping class="com.test.model.Magazine" />
<list>
<!--
<storage value="external" />
-->
</litepal>
dbname 数据库名称
定义应用程序的数据库名称。
默认情况下,每个数据库名称都应该以.db结尾。
如果你没有将你的数据库命名为.db,例如:
<dbname value="demo" />
LitePal会自动为你加上后缀。(指数据库文件)
<dbname value="demo.db" />
(效果一样)
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,如下所示:
<manifest>
<application
android:name="org.litepal.LitePalApplication"
...
>
...
</application>
</manifest>
当然,您可能有自己的应用程序,并已在这里配置,如:
<manifest>
<application
android:name="com.example.MyOwnApplication"
...
>
...
</application>
</manifest>
没关系。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<Song> songs = new ArrayList<Song>();
// 生成的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的映射列表中:
<list>
<mapping class="org.litepal.litepalsample.model.Album" />
<mapping class="org.litepal.litepalsample.model.Song" />
</list>
好的!这些表将在下次操作数据库时生成。例如,获取带有以下代码的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<Song> songs = new ArrayList<Song>();
// 生成的getter和setter。
...
}
添加了releaseDate字段,并将price字段注释为忽略。然后在litepal.xml中增加版本号:
<!--
<version value="1" />
-->
<version value="2" />
这些表将在下次操作数据库时更新。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<Song> allSongs = LitePal.findAll(Song.class);
用流畅查询构造复杂查询。
List<Song> 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<Song>() {
@Override
public void onFinish(List<Song> 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