Android 使用LitePal操作数据库

1.LitePal简介

LitePal是一款开源的Android数据库框架,它采用了对象关系映射(ORM)的模式,并将我们平时开发最常用到的一些数据库功能进行了封装,使得不用编写一行SQL语句就可以完成各种建表和增删改查的操作,LitePal的项目主页上也有详细的使用文档,地址是:http://github.com/LitePalFramework/LitePal

2.配置LitePal

要使用LitePal,第一步就是编辑app/build.gradle文件,在dependencies闭包中添加如下内容:

dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:25.3.1'
testCompile 'junit:junit:4.12'
compile 'org.litepal.android:core:1.3.2'
}

添加的这一行声明中,前面的部分是固定的,最后的1.3.2是版本号的意思,最新的版本号可以到LitePal的项目主页上去查看

这样我们就把LitePal成功引入到当前的项目中了,然后配置litepal.xml文件,右击app/src/main目录–New–Directory,创建一个assets目录,然后在assets目录下再新建一个litepal.xml文件,然后编辑

<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>

<version value="1" ></version>
<list>
</list>
</litepal>

其中dbname标签用于指定数据库名,version标签用于指定数据库版本号,list标签用于指定所有的映射模型

最后还需要在配置一下LitePalApplication,修改AndroidManifest.xml中的代码

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.litepaltest">
<application
android:name="org.litepal.LitePalApplication"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
...
</application>
</manifest>

这里将项目的application配置为org.litepal.LitePalApplication,这样才能让LitePal的所有功能都可以正常工作.

现在LitePal的配置工作已经全部结束,下面就是如何使用

3.创建和升级数据库

LitePal采用的是对象关系映射(ORM)的模式,那么什么是关系映射,简单的说,我们使用的编程语言是面向对象语言,而使用的数据库则是关系型数据库,那么将面向对象的语言和面向关系的数据库之间建立一种映射关系,这就是对象关系映射了.

对象关系映射模式,就是可以用面向对象的思维来操作数据库,而不用再和SQL语句打交道,比如,为了创建一张Book表,需要先分析表中应该包含那些列,然后再编写出一条建表语句,最后在自定义SQLiteOpenHelper中执行这条建表语句,但是使用LitePa
4000
l,你就可以用面向对象的思维来实现同样的功能,定义一个Book类,代码如下:

public class Book {
private int id;
private String author;
private double price;
private int pages;
private String name;

public int getId() {
return id;
}

public void setId(int id) {
this.id = id;
}

public String getAuthor() {
return author;
}

public void setAuthor(String author) {
this.author = author;
}

public double getPrice() {
return price;
}

public void setPrice(double price) {
this.price = price;
}

public int getPages() {
return pages;
}

public void setPages(int pages) {
this.pages = pages;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}
}

这是一个典型的Java bean,在Book类中我们定义了id,author,price,pages,name这几个字段,并生成了相应的getter和setter方法,Book类就会对应数据库中的Book表,而类中的每一个字段分别对应了表中的每一个列,这就是对象关系映射最直接的体验

接下来我们还需要把Book类添加到映射模型列表当中,修改litepal.xml中的代码

<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>

<version value="1" ></version>
<list>
<mapping class="com.example.litepaltest.Book"></mapping>
</list>
</litepal>

这里使用mapping标签来声明我们要配置的映射模型类,注意一定要使用完整的类名.不管有多少模型类需要映射,都使用同样的方式配置在list标签下

修改MainActivity代码

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button createDatabase = (Button)findViewById(R.id.create_database);
createDatabase.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v){
Connector.getDatabase();
}
});
}
}

其中,调用Connector.getDatabase()方法就是一次简单的数据库操作,只要点击一下按钮,数据库就会自动创建完成.

使用SQLiteOpenHelper来升级数据库,有一个问题就是升级数据库的时候我们需要先把之前的表drop掉,然后再重新创建才行,这其实是一个非常严重的问题,因为这样会造成数据丢失,每当升级一次数据库,之前表中的数据就全没了.当使用LitePal时,这些都不再是问题了.使用LitePal来升级数据库非常非常简单,你完全不用考虑任何的逻辑,只需要改你想改的内容,然后版本号加1就可以了

比如我们想要向Book表中添加一个press(出版社)列,直接修改Book类中的代码,添加一个press字段

public class Book {
...
private String press;
...

public String getPress() {
return press;
}

public void setPress(String press) {
this.press = press;
}
}

于此同时,我们还想再添加一张Category表,那么只需要新建一个Category类就可以了

public class Category {
private int id;
private String categoryName;
private int categoryCode;

public int getId() {
return id;
}

public void setId(int id) {
this.id = id;
}

public String getCategoryName() {
return categoryName;
}

public void setCategoryName(String categoryName) {
this.categoryName = categoryName;
}

public int getCategoryCode() {
return categoryCode;
}

public void setCategoryCode(int categoryCode) {
this.categoryCode = categoryCode;
}
}

改完了所有我们想改的东西,只需要记得将版本号加1就行了.这里添加一个新的模型类,因此也需要将它添加到映射模型列表中.修改litepal.xml中的代码

<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>

<version value="2" ></version>
<list>
<mapping class="com.example.litepaltest.Book"></mapping>
<mapping class="com.example.litepaltest.Category"></mapping>
</list>
</litepal>

4.使用LitePal添加数据

使用LitePal添加数据,只需要创建出模型类的实例,然后将所有的要存储的数据设置好,最后调用一下save()方法就可以了

模型类必须继承DataSupport类,修改Book类

public class Book extends DataSupport{
...
}

修改MainActivity代码

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
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()方法就能完成数据添加操作.这个save()方法是从DataSupport类中继承来的.除了save()方法,还有一些其他方法.

5.使用LitePal更新数据

首先,最简单的一种更新方式就是对已存储的对象重新设值,然后 重新调用save()方法.什么是已存储的对象,对于LitePal来说,对象是否已存储就是根据调用model.isSaved()方法的结果来判断的,返回true就表示已存储,返回false就表示未存储.实际上只有两种情况下model.isSaved()方法才会返回true,一种情况是已经调用过model.save()方法去添加数据,此时model会被认为是已存储的对象,另一种情况是model对象是通过LitePal提供的查询API查出来的,由于是从数据库中查到的对象,因此也会被认为是已存储的对象.

第一种情况的代码,修改MainActivity代码

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
Button updateData = (Button)findViewById(R.id.update_data);
updateData.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v){
Book book = new Book();
book.setName("The Lost Symbol");
book.setAuthor("Dan Brown");
book.setPages(510);
book.setPrice(19.95);
book.setPress("Unknow");
book.save();
book.setPrice("10.99");
book.save();
}
});
}
}

在更新数据按钮的点击事件里面,首先添加一条Book数据,然后调用setPrice()方法将这本书的价格进行修改,之后再调用了save()方法.此时LitePal会发现当前的Book对象是已存储的,因此不会再向数据库中去添加一条新的数据,而是会直接更新当前的数据.

另外一种更新方法,修改MainActivity代码

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
Button updateData = (Button)findViewById(R.id.update_data);
updateData.setOnClickListener(new View.OnClickListener(){
@Override
public
b92e
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实例,然后直接调用setPrice()方法和setPress()方法来设置要更新的数据,最后再调用updateAll()方法去执行更新操作.

注意:updateAll()方法中可以指定一个约束条件,和SQLiteDatabase中的update()方法的where参数部分有点类似,如果不指定条件约束的话,就表示更新所有数据.

注意:在使用updateAll()方法时,当你想把一个字段的值更新成默认值时,是不可以使用上面的方式来set数据的,在java中任何一种数据类型的字段都有一个默认值,例如int类型的默认值为0,boolean类型的默认值为false,String类型的默认值为null,因此,如果当new出一个Book对象时,其实所有字段都已经被初始化为默认值.比如说pages字段的值为0,因此,想把数据表中的pages更新为0,直接调用book.setPages(0)是不可以的,因为即使不调用这段代码,pages字段本身也是0,LitePal不会对这个列进行更新,对于所有想要将为数据更新成默认值的操作,LitePal提供了一个setToDefault()方法,然后传入相应的列名就可以了实现了.例如:

Book book = new Book();
book.setToDefault("pages);
book.updateAll();

6.使用LitePal删除数据

有两种方式,第一种比较简单,就是直接调用已存储对象的delete()方法就可以了.调用过save()方法的对象,或是通过LitePal提供的查询API查出来的对象,都是可以直接使用delete()方式来删除数据的.

另一种删除方式的代码如下:

修改MainActivity代码:

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
Button deleteButton = (Button)findViewById(R.id.delete_data);
deleteButton.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v){
DataSupport.deleteAll(Book.class,"price < ?","15");
}
});
}
}

这里调用DataSupport.deleteAll()方法来删除数据,其中deleteAll()方法的第一个参数用于指定删除哪张表中的数据,Book.class表示删除Book表中的数据,后面的参数用于指定约束条件,这里的代码表示,删除Book表中的价格低于15的书.

deleteAll()方法不指定约束条件,就是要删除表中的所有数据

7.使用LitePal查询数据

LitePal查询表中的所有数据:

List<Book> books = DataSuppport.findAll(Book.class);

findAll()方法返回一个Book类型的List集合,我们不用像之前那样通过Cursor对象一行行去取值,LitePal已经自动帮助我们完成了赋值操作.

修改MainActivity代码:

public class MainActivity extends AppCompatActivity{
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
...
Button queryButton = (Button)findViewById(R.id.query_data);
queryButton.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View v){
List<Book> books = DataSuppport.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());
}
}
});
}
}

查询Book表中的第一条数据可以这样写:

Book firstBook = DataSuppport.findFirst(Book.class);

查询Book表中的最后一条数据可以这样写

Book lastBook = DataSuppport.findLast(Book.class);

我们可以通过连缀查询来定制更多的查询功能

select()方法用于指定查询那几列的数据,对应了SQL当中的select关键字,比如只查询name和author这两列的数据

List<Book> books = DataSuppport.select("name", "author").find(Book.class);

where()方法用于指定查询的约束条件,对应了SQL当中的关键字where,比如只查询页数大于400的数据,

List<Book> books = DataSuppport.where("pages > ?", "400").find(Book.class);

order()方法用于指定结果的排序方式,对应了SQL当中的order by 关键字,比如将查询结果按照书价格从高到低排序

desc表示降序排列,asc或者不写表示升序排列

List<Book> books = DataSuppport.order("price desc").find(Book.class);

limit()方法用于指定查询结果的数量,比如只查询表中的前3条数据

List<Book> books = DataSuppport.limit(3).find(Book.class);

offset()方法用于指定查询结果的偏移量,比如查询表中的第2条,第3条,第4条数据

List<Book> books = DataSuppport.limit(3).offset(1).find(Book.class);

还可以对这5个方法进行任意组合的连缀,来完成一个比较复杂的查询操作

查询Book表中第11–20条满足页数大于400这个条件的name,author和pages这3列数据,并将查询结果按照页数升序排列

List<Book> books = DataSuppport.select("name", "author", "pages")
.where("pages > ?", "400")
.order("pages")
.limit(20)
.offset(10)
.find(Book.class);

LitePal也支持使用原生的SQL来查询:

Cursor c = DataSupport.findBySQL("select * from Book where pages > ? and price < ?", "400", "20");

调用DataSupport.findBySQL()方法来进行原生查询,其中第一个参数用于指定SQL语句,后面的参数用于指定占位符的值,注意findBySQL()方法返回的是一个Cursor对象,需要将数据一一取出才行.