快速配置
- AS添加依赖如下
dependencies {
compile 'org.litepal.android:core:1.4.1'
}
- 接着在项目的assets目录下面新建一个litepal.xml文件，并将以下代码拷贝进去：
- 在Application中初始化LitePal
public class MyApplication extends Application {
private static Context context;
@Override
public void onCreate() {
super.onCreate();
context = getApplicationContext();
LitePal.initialize(context);
}
public static Context getContext(){
return context;
}
}
创建和升级数据库
- 先创建一个tableBean
public class Book {
private int id;
private int pages;
private String author;
private String name;
private double price;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public int getPages() {
return pages;
}
...
}
- 将Book类添加到模型映射表中
- 然后在进行任意一次数据库操作则数据库会被创建出来
findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Connector.getDatabase();
}
});
- 如果要升级数据库也无需做备份相关的复杂逻辑，例如增加新表后要升级数据库，如下修改即可
添加数据
- LitePal要求进行CRUD的模型表必须继承自DataSupport类，所以将Book类进行如下修改
public class Book extends DataSupport{
private int id;
private int pages;
...
- 接着我们向Book表中插入数据，如下
findViewById(R.id.btn_add).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
for (int i = 0; i < 10; i++) {
Book book = new Book();
book.setAuthor("Keigo");
book.setName("《湖畔》");
book.setPages(10 * i);
book.setPrice(99.6);
book.setPress("E.T.O");
book.save();
}
}
});
更新数据
- LitePal提供了
updateAll()方法来更新表，操作如下
findViewById(R.id.update).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Book book = new Book();
book.setAuthor("Keigo");
book.setName("《白夜行》");
book.updateAll("name=? and price=?", "《湖畔》", "99.6");
}
});
可以看到我们先
new出了一个Book实例，然后调用对应方法来设置需要更新的数据，最后调用updateAll()来更新表，这里updateAll()我们传入了一个类似于 sqlite 中 where 语句的条件约束来指明我们要更新的是哪条数据，如果这里不增加约束的话，整张表的数据都将被更新。上面的示例表示我要更新name字段为《湖畔》且price字段为99.6这条数据的author为Keigo，name为《白夜行》。
- 使用
updateAll()还有一点需要注意，就是当你想要更新某个字段的值为默认值时，不能再使用set()。比如更新 pages 为 0，直接调用book.setPages(0)是无效的，因为在 java 中 int 的默认值就是 0 ，所以此时LitePal将不会对此更新，对于要更新的数据，LitePal为我们提供了一个setToDefault()方法，我们传入相应字段名就可以了，如下写法
Book book = new Book();
book.setToDefault("pages");
book.updateAll();
上面代码的意思就是，将所有书的页数都更新为 0 ，因为
updateAll()方法中没有条件约束，操作对所有数据都生效了。
删除数据
- LitePal删除数据的方式有两种，一种直接通过已存储对象的
delete()方法删除，另一种方式如下
findViewById(R.id.delete).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
//通过delete()删除
Book book = new Book();
if (book.isSaved()){
book.delete();
}
//通过DataSupport.deleteAll()删除
DataSupport.deleteAll(Book.class, "pages>?", "80");
}
});
这里使用了
DataSupport.deleteAll()来删除数据，第一个参数为指定表，第二个参数为约束条件，不指定约束则删除所有数据，同updateAll()原理相似。
查询数据
- LitePal查询数据的方式相当人性化，例如查询一张表中的数据，它会自动为我们赋值
findViewById(R.id.query).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
List Books = DataSupport.findAll(Book.class);
for (Book book : Books) {
Log.d(MainActivity.this.TAG,"name:"+book.getName());
Log.d(MainActivity.this.TAG,"pages:"+book.getPages());
Log.d(MainActivity.this.TAG,"author:"+book.getAuthor());
Log.d(MainActivity.this.TAG,"price:"+book.getPrice());
}
}
});
- 除了
findAll()之外 LitePal 还提供了其它便捷的 API，例如查询Book表中第一条数据
Book firstBook = DataSupport.findFirst(Book.class);
- 查询Book表中最后一条数据
Book lastBook = DataSupport.findLast(Book.class);
-
select()方法用于指定查询哪几列数据，例如只获取 name and author 两列数据
List Books = DataSupport.select("name","author").find(Book.class);
-
where()方法用于指定查询的约束条件，比如查询 author 是 skyrin 的数据
List Books = DataSupport.where("author=?","skyrin").find(Book.class);
-
order()方法用于对指定结果排序，例如按照 price 升序排列 Book 中的数据
List Books = DataSupport.order("price ASC").find(Book.class);
-
limit()方法用于指定查询结果的数量，比如只查询表中前3条数据
List Books = DataSupport.limit(3).find(Book.class);
-
offset()用于指定查询结果的偏移量，比如从第二条开始往后获取3条数据
List Books = DataSupport.limit(3).offset(1).find(Book.class);
- 最后你可以使用以上5条规则进行组合，来完成一项复杂查询
List Books = DataSupport.select("name", "pages")
.where("pages>?", "300")
.order("pages desc")
.limit(10)
.offset(5)
.find(Book.class);
以上代码表示查询 Book 表中 从 6 ~ 15 条字段为 name 和 pages 且 pages 大于 300 的数据，结果按 pages 降序排列
- 最后的最后当以上所有方式都无法满足你变态的查询需求时，LitePal 还支持了原生 SQL 语法查询
Cursor c = DataSupport.findBySQL("select * from Book where author=? and pages>?","skyrin","300");