配置LitePal的第一步就是要在app/build.gradle文件中添加下面内容:
implementation 'org.litepal.android:java:3.0.0'
然后在我们的app/src/main目录中新建一个文件夹assets,并在里面assets中建一个litepal.xml文件,并将内容编辑为下面所示:
最后就是在AndroidManifest.xml的application中添加下面代码:
android:name="org.litepal.LitePalApplication"
“ ”中的是我们项目的包名
数据库中一般都有表,我们建立一个Book类,并为它里面定义的一些字段生成相应的getter和setter方法,然后将Book类添加到映射模型列表中,修改litepal.xml中的代码:
做完上面的工作之后,我们只要进行任意一次数据库的操作,BookStore.db数据库就会自动创建出来,我在这里设置了一个按钮,并用它的点击事件调用LitePal.getDatabase()方法就完成了数据库的创建。
而数据库的升级就更简单了,直接修改litepal.xml中的版本号就行了:将我们的version value="1"修改为比“1”高的数即可。
LitePal进行添加数据需要将Book类继承LitePalSupport类,接着我又添加了一个按钮,并设置它的点击事件:
Button addData=(Button) findViewById(R.id.add_data);
addData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Book book=new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknow");
book.save();
}
});
这里我们先创建了一个Book的实例,然后调用Book类中的set方法进行数据设置,最后调用book.save()方法就完成了数据的添加操作。
操作完成后,我们可以用命令行进行查看:
这里是先打开cmd命令行,然后输入adb shell进入设备控制台,再cd+项目的数据存放地址进入数据存放目录,再sqlite3+数据库名打开数据库,最后输入查询语句就行了。(查询语句记得最后加“;”)
数据更新可以调用updataAll( )方法,它可以指定一个条件约束,更新我们指定的数据,如果不加条件约束就会更新所有数据:
Button updateData=(Button) findViewById(R.id.update_data);
updateData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Book book=new Book();
book.setPrice(14.95);
book.setPress("Anchor");
book.updateAll("name=? and author=?","The Lost Symbol","Dan Brown");
}
});
这里还是先new出一个Book 的实例,然后调用setter方法设置更新的数据,最后调用updateAll( )方法完成更新。
在我们为Book类中字段设置默认值时,可以用LitePal的setToDefault()方法,传入需要设置的列名就行:
Book book=new Book();
book.setToDefault("price");
book.updateAll();
删除数据的使用方法与更新数据类似,是调用LitePal.deleteAll( )方法,这里的deleteAll( )也可指定约束条件,不指定的话就会删除所有数据,代码如下:
Button deleteButton=(Button) findViewById(R.id.delete_data);
deleteButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
LitePal.deleteAll(Book.class,"price","15");
}
});
deleteAll( )中第一个参数就是指定删除哪一张表中的数据,后面就是限定条件,具体到哪一项哪一列。
LitePal查询某一张表的数据非常简单,只需要调用一下findAll( )方法,然后通过Book.class指定我们需要查询的表就行了,可以这样写:
Button queryButton=(Button) findViewById(R.id.query_data);
queryButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
List books=LitePal.findAll(Book.class);
for(Book book:books){
Log.d("MainActivity", "book name is " + book.getName());
Log.d("MainActivity", "book author is " + book.getAuthor());
Log.d("MainActivity", "book pages is " + book.getPages());
Log.d("MainActivity", "book price is " + book.getPrice());
Log.d("MainActivity", "book press is "+ book.getPress());
}
}
});
除了findAll( )方法外,LitePal还有很多有用的查询API:
findFirst( )查询表中第一条数据:
Book firstBook=LitePal.findFirst(Book.class);
findLast( )查询表中最后一条数据:
Book lastBook=LitePal.findLast(Book.class);
select( )指定查询哪几列数据(只查询name和author这两列数据):
List books=LitePal.select("name","author").find(Book.class);
where( )指定查询的约束条件(只查询页数大于400的数据):
List books=LitePal.where("pages>?","400").find(Book.class);
order( )指定结果的排序方式(desc是降序,asc是升序):
List books=LitePal.order("price desc").find(Book.class);
limit( )指定查询结果的数量(只查询表中前3条数据):
List books=LitePal.limit(3).find(Book.class);
offset( )指定查询结果的偏移量(查询表中第2条、第3条、第4条数据):
List books=LitePal.limit(3).offset(1).find(Book.class);