快速配置

  • 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;
    }
}

创建和升级数据库

  • 先创建一个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>
  • 然后在进行任意一次数据库操作则数据库会被创建出来
findViewById(R.id.button).setOnClickListener(new View.OnClickListener() {  
    @Override                                                              
    public void onClick(View v) {                                          
        Connector.getDatabase();                                           
    }                                                                      
});                                                                        
  • 如果要升级数据库也无需做备份相关的复杂逻辑,例如增加新表后要升级数据库,如下修改即可
<?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>

添加数据

  • 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 这条数据的 authorKeigoname《白夜行》
  • 使用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<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表中第一条数据
Book firstBook = DataSupport.findFirst(Book.class);
  • 查询Book表中最后一条数据
Book lastBook = DataSupport.findLast(Book.class);
  • select()方法用于指定查询哪几列数据,例如只获取 name and author 两列数据
List<Book> Books = DataSupport.select("name","author").find(Book.class);
  • where()方法用于指定查询的约束条件,比如查询 author 是 skyrin 的数据
List<Book> Books = DataSupport.where("author=?","skyrin").find(Book.class);
  • order()方法用于对指定结果排序,例如按照 price 升序排列 Book 中的数据
List<Book> Books = DataSupport.order("price ASC").find(Book.class);
  • limit()方法用于指定查询结果的数量,比如只查询表中前3条数据
List<Book> Books = DataSupport.limit(3).find(Book.class);
  • offset()用于指定查询结果的偏移量,比如从第二条开始往后获取3条数据
List<Book> Books = DataSupport.limit(3).offset(1).find(Book.class);
  • 最后你可以使用以上5条规则进行组合,来完成一项复杂查询
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 的数据,结果按 pages 降序排列
  • 最后的最后当以上所有方式都无法满足你变态的查询需求时,LitePal 还支持了原生 SQL 语法查询
Cursor c = DataSupport.findBySQL("select * from Book where author=? and pages>?","skyrin","300");