LitePal 的基本用法

2017-04-29 本文已影响372人 SkyRiN

快速配置

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 这条数据的 author 为 Keigo，name 为 《白夜行》。

使用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");

LitePal 的基本用法

快速配置

创建和升级数据库

添加数据

更新数据

删除数据

查询数据

猜你喜欢

热点阅读