快速配置
- AS添加依賴如下
dependencies {
compile 'org.litepal.android:core:1.4.1'
}
- 接著在項目的assets目錄下面新建一個litepal.xml文件，并將以下代碼拷貝進去：
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>
<version value="1" ></version>
<list>
</list>
</litepal>
- 在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;
}
}
創(chuàng)建和升級數(shù)據(jù)庫
- 先創(chuàng)建一個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類添加到模型映射表中
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>
<version value="1" ></version>
<list>
<mapping class="com.example.admin.turingts.Book"></mapping>
</list>
</litepal>
- 然后在進行任意一次數(shù)據(jù)庫操作則數(shù)據(jù)庫會被創(chuàng)建出來
findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Connector.getDatabase();
}
});
- 如果要升級數(shù)據(jù)庫也無需做備份相關(guān)的復(fù)雜邏輯，例如增加新表后要升級數(shù)據(jù)庫，如下修改即可
<?xml version="1.0" encoding="utf-8"?>
<litepal>
<dbname value="BookStore" ></dbname>
<version value="2" ></version>
<list>
<mapping class="com.example.admin.turingts.Book"></mapping>
<mapping class="com.example.admin.turingts.Category"></mapping>
</list>
</litepal>
添加數(shù)據(jù)
- LitePal要求進行CRUD的模型表必須繼承自DataSupport類，所以將Book類進行如下修改
public class Book extends DataSupport{
private int id;
private int pages;
...
- 接著我們向Book表中插入數(shù)據(jù)，如下
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();
}
}
});
更新數(shù)據(jù)
- 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實例，然后調(diào)用對應(yīng)方法來設(shè)置需要更新的數(shù)據(jù)，最后調(diào)用updateAll()來更新表，這里updateAll()我們傳入了一個類似于 sqlite 中 where 語句的條件約束來指明我們要更新的是哪條數(shù)據(jù)，如果這里不增加約束的話，整張表的數(shù)據(jù)都將被更新。上面的示例表示我要更新name字段為《湖畔》且price字段為99.6這條數(shù)據(jù)的author為Keigo，name為《白夜行》。
- 使用
updateAll()還有一點需要注意，就是當(dāng)你想要更新某個字段的值為默認(rèn)值時，不能再使用set()。比如更新 pages 為 0，直接調(diào)用book.setPages(0)是無效的，因為在 java 中 int 的默認(rèn)值就是 0 ，所以此時LitePal將不會對此更新，對于要更新的數(shù)據(jù)，LitePal為我們提供了一個setToDefault()方法，我們傳入相應(yīng)字段名就可以了，如下寫法
Book book = new Book();
book.setToDefault("pages");
book.updateAll();
上面代碼的意思就是，將所有書的頁數(shù)都更新為 0 ，因為
updateAll()方法中沒有條件約束，操作對所有數(shù)據(jù)都生效了。
刪除數(shù)據(jù)
- LitePal刪除數(shù)據(jù)的方式有兩種，一種直接通過已存儲對象的
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()來刪除數(shù)據(jù)，第一個參數(shù)為指定表，第二個參數(shù)為約束條件，不指定約束則刪除所有數(shù)據(jù)，同updateAll()原理相似。
查詢數(shù)據(jù)
- LitePal查詢數(shù)據(jù)的方式相當(dāng)人性化，例如查詢一張表中的數(shù)據(jù)，它會自動為我們賦值
findViewById(R.id.query).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
List<Book> 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表中第一條數(shù)據(jù)
Book firstBook = DataSupport.findFirst(Book.class);
- 查詢Book表中最后一條數(shù)據(jù)
Book lastBook = DataSupport.findLast(Book.class);
-
select()方法用于指定查詢哪幾列數(shù)據(jù)，例如只獲取 name and author 兩列數(shù)據(jù)
List<Book> Books = DataSupport.select("name","author").find(Book.class);
-
where()方法用于指定查詢的約束條件，比如查詢 author 是 skyrin 的數(shù)據(jù)
List<Book> Books = DataSupport.where("author=?","skyrin").find(Book.class);
-
order()方法用于對指定結(jié)果排序，例如按照 price 升序排列 Book 中的數(shù)據(jù)
List<Book> Books = DataSupport.order("price ASC").find(Book.class);
-
limit()方法用于指定查詢結(jié)果的數(shù)量，比如只查詢表中前3條數(shù)據(jù)
List<Book> Books = DataSupport.limit(3).find(Book.class);
-
offset()用于指定查詢結(jié)果的偏移量，比如從第二條開始往后獲取3條數(shù)據(jù)
List<Book> Books = DataSupport.limit(3).offset(1).find(Book.class);
- 最后你可以使用以上5條規(guī)則進行組合，來完成一項復(fù)雜查詢
List<Book> 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 的數(shù)據(jù)，結(jié)果按 pages 降序排列
- 最后的最后當(dāng)以上所有方式都無法滿足你變態(tài)的查詢需求時，LitePal 還支持了原生 SQL 語法查詢
Cursor c = DataSupport.findBySQL("select * from Book where author=? and pages>?","skyrin","300");
