LitePal是一款开源的Android数据库框架,它采用对象关系映射(ORM)的模式,并将平时开发常用的一些数据库功能进行了封装,使得不用编写一行SQL语句就可以完成建表和增删改查操作。
对象关系映射(ORM):Java使用的编程语言是面向对象的语言,而使用的数据库则是关系型数据库,那么面向对象的语言与面向关系的数据库之间建立一种映射关系,这就是对象关系映射。
一、配置LitePal
1、该项目已经提交到jcenter上,所以只需在app/build.gradle文件中,dependencies闭包中添加。
compile 'org.litepal.android:core:1.4.1'
2、右击main目录→New→Directory,创建一个assets目录,然后在assets目录中新建litepal.xml文件,并配置litepal.xml文件。
标签用于指定所有映射模型。
3、修改AndroidManifest.xml中代码,配置将项目application 配置为org.litepal.LitePalApplication。
二、创建数据库
Litepal采用对象映射关系(ORM)模式,使得我们可以用面向对象的思维操作数据库,而不用再和SQL语句打交道。
1、添加activity_main.xm代码。
2、定义一个Book类对应数据库中的Book表。
public class Book {
//这是一个典型的Java bean,它定义了一些字段并提供了相应的getter()与setter()方法。
private int id;
private String author;
private double price;
private int pages;
private String name;
public String getAuthor() {
return author;
}
public void setAuthor(String author) {
this.author = author;
}
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getPages() {
return pages;
}
public void setPages(int pages) {
this.pages = pages;
}
public double getPrice() {
return price;
}
public void setPrice(double price) {
this.price = price;
}
}
3、将Book类添加到映射模型列表中,修改litepal.xml。
其中
4、修改MainActivity中代码,此时只要进行任意一次数据库操作,BookStore.db数据库就会自动创建出来。
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 view) {
LitePal.getDatabase();
}
});
}
}
三、升级数据库
只需修改任何想改的内容,再将版本号加1即可。
1、修改Book类添加press字段。
public class Book {
……
private String press;
……
public String getPress() {
return press;
}
public void setPress(String press) {
this.press = press;
}
}
2、再添加一张Category表,新建Category类。
public class Category {
private int id;
private String categoryName;
private int categotyCode;
public void setCategoryName(String categoryName) {
this.categoryName = categoryName;
}
public void setCategotyCode(int categotyCode) {
this.categotyCode = categotyCode;
}
public void setId(int id) {
this.id = id;
}
}
3、修改litepal.xml文件,版本号加1,添加Category模型到映射模型列表。
四、使用LitePal添加数据
只需创建出模型类的实例,再将要储存的数据设置好,最后调用一下save()方法即可。此时的模型类必须要继承DataSupport类才行。
1、修改Book类代码,使其继承自DataSupport类。
public class Book extends DataSupport{
……
}
2、修改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 view) {
//创建Book实例并添加数据
Book book = new Book();
book.setName("The Da Vinci Code");
book.setAuthor("Dan Brown");
book.setPages(454);
book.setPrice(16.96);
book.setPress("Unknow");
//DataSupport类中的方法
book.save();
}
});
}
}
五、使用LitePal更新数据。
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 view) {
Book book = new Book();
book.setPrice(14.95);
book.setPress("Anchor");
// updateAll()方法执行更新操作,该方法可以指定条件约束,如果不指定则表示更新所有数据。
book.updateAll("name = ? and author = ?", "The Lost Symbol","Dan Brown");
}
});
}
}
注意当想把一个字段设置成默认值时不能使用用setXxx()方法,对于所有想要将为数据更新成默认值的操作需使用setToDefault()方法。
六、使用LitePal删除数据
方法一:直接调用已储存对象的delete()方法。
方法二:调用DataSupport的deleteAll()方法删除数据。
第一个参数:指定删除哪张表的数据。
第二、三个参数:指定约束条件。如果不指定则删除所有。
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
……
Button deleteData = (Button) findViewById(R.id.delete_data);
deleteData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
DataSupport.deleteAll(Book.class,"price < ?","15");
}
});
}
}
七、使用LitePal查询数据。
只需调用findAll()方法,自动完成赋值,返回一个模型类的List集合。
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
……..
Button queryData = (Button) findViewById(R.id.query_data);
queryData.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
List books = DataSupport.findAll(Book.class);
//遍历模型类的List集合
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:
1)查询表中第一条数据。
Book firstBook = DataSupport.findFirst(Book.class);
2)查询表中最后一条数据。
Book lastBook = DataSupport.findLast(Book.class);
3)select()方法指定查询哪几列,对应于SQL的select关键字。
List books = DataSupport.select("name","author").find(Book.class);
4)where()方法指定查询约束条件,对应于SQL的where关键字。
List books = DataSupport.where("page > ?","400").find(Book.class);
5)order()方法用于指定结果的排序方式
List books = DataSupport.order("price desc").find(Book.class);
6)limit()方法指定查询结果的数量。
List books = DataSupport.limit(3).find(Book.class);
7)offset()方法指定查询结果的偏移量。
List books = DataSupport.limit(3).offset(1).find(Book.class);
8)任意连缀组合复杂查询。
List books = DataSupport.select("name","author","pages")
.where("pages> ? ","400")
.order("pages")
.limit(10)
.offset(10)
.find(Book.class);
9)LitePal同样支持原生SQL查询。
Cursor cursor = DataSupport.findBySQL("select * from Book where pages > ? and price < ?","400","20");
其中第一个参数为SQL语句,后面的参数用于指定占位符的值,该方法返回Cursor对象作为查询结果。