Android学习笔记——LitePal

最新推荐文章于 2024-05-15 00:12:12 发布

JOJO_小丫

最新推荐文章于 2024-05-15 00:12:12 发布

阅读量1.3k

点赞数

分类专栏： Android学习笔记文章标签： android 数据库开源项目框架

本文链接：https://blog.csdn.net/lanjingling09/article/details/76704624

版权

Android学习笔记专栏收录该内容

17 篇文章 1 订阅

订阅专栏

参考书籍：Android第一行代码（第二版）.郭霖著

LitePal是一款开源的Android数据库框架，采用对象关系映射（ORM）模式，将开发常用的数据库功能进行封装，不用编写SQL语句就可完成各种建表增删查改操作。项目主页上有详细使用文档：https://github.com/LitePalFramework/LitePal

1、配置LitePal（Android Studio）
现在大多数的开源项目都会提交到jcenter上，所以只需在app/build.gradle文件中声明该开源库的引用就可以了：
compile ‘org.litepal.android:core:1.5.1’
前面部分固定，1.5.1为版本号（最新的去LitePal项目主页上查看）。
接下来需配置litepal.xml文件。右键app/src/main目录->New->Directory,创建一个assets目录，在其中新建一个litepal.xml文件，编辑其中内容：

<?xml version="1.0" encoding="utf-8"?>
<litepal>

    <dbname value="BookStore" />

    <version value="1" />

    <list>
    </list>

</litepal>

指定数据库名、数据库版本号，指定所有映射模型。
最后需配置LitePalApplication,修改AndroidManifest.xml：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.jojo.litepaltest">

    <application
        **android:name="org.litepal.LitePalApplication"**
        android:allowBackup="true"
        。。。

将项目的application配置为org.litepal.LitePalApplication，才能让LitePal的所有功能正常工作。

2、创建升级数据库

实现与DatabaseTest同样的功能。先将activity_main.xml文件从DatabaseTest项目复制过来。
对象关系映射：将面向对象的语言（我们使用的编程语言）和面向关系的数据库（关系型数据库）之间建立一种映射关系。此模式可以让我们用面向对象的思维操作数据库，不用和SQL语句打交道。
定义一个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 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 getAuthor() {
        return author;
    }

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

    public String getName() {
        return name;
    }

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

典型的JavaBean（一段特殊的Java类：有无参构造方法，只有get、set方法的Java类对象）。Book类对应Book表，类中每个字段对应表中每个列（对象关系映射）。
需将Book类添加到映射模型列表中，修改litepal.xml:

<litepal>

    <dbname value="BookStore" />

    <version value="1" />

    <list>
        <mapping class="com.example.jojo.litepaltest.Book"/>
    </list>

</litepal>

声明配置的映射模型类，使用完整类名。
所有工作完成，只要进行任意一次数据库操作，BookStore.db数据库就会自动创建出来。修改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();
            }
        });
    }
}

运行程序，点击创建按钮，通过adb shell查看情况。
这里写图片描述
打开数据库，通过.schema查看建表语句，有三张表的建表语句，前两张都是内部表不用管。
之前使用SQLiteOpenHelper升级数据库，需要把之前的表drop掉再重新创建（造成数据丢失，升级一次，之前表中数据全丢），可通过复杂逻辑控制避免此问题但维护成本很高。使用LitePal只需修改想改的内容，将版本号加1即可。
如向Book中添加press（出版社）心裂，直接修改该Book类，添加press字段及相应get\set方法即可。同时添加一张Category表，只需创建此类即可：

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

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

    public int getId() {
        return id;
    }

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

    public int getCategoryCode() {
        return categoryCode;
    }

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

    public String getCategoryName() {
        return categoryName;
    }
}

将其添加到映射模型列表中，将版本号加1：

<litepal>

    <dbname value="BookStore" />

    <version value="2" />

    <list>
        <mapping class="com.example.jojo.litepaltest.Book"/>
        <mapping class="com.example.jojo.litepaltest.Category"/>
    </list>

</litepal>

重新运行程序，点击创建按钮，查看建表语句：
这里写图片描述

LitePal会自动保留之前表中的所有数据。

3、添加数据

只需创建出模型类实例，将所有要存储的数据设置好，最后调用一下save()方法就可以了。
现有模型类都没有继承结构（LitePal进行表管理操作时不需要模型类有任何继承结构），但进行CRUD操作必须要继承自DataSupport类才行，所以需给现有类加上此继承：

public class Book extends DataSupport{

向Book中添加数据，修改主程序：

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();//从DataSupport类中继承的方法，其中提供了丰富的CRUD方法
            }
        });

运行程序，点击添加按钮，查看数据库：
这里写图片描述

4、更新数据

几种常用更新方式。

最简单的一种：对已存储的对象重新设值，重新调用save()即可。对象是否已存储根据model.isSaved()方法结果判断（两种情况下返回true:已经调用model.save()添加数据了；model对象是通过LitePal提供的查询API查出来的）。先通过第一种情况验证，修改主程序：

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();//从DataSupport类中继承的方法，其中提供了丰富的CRUD方法
                book.setPrice(10.99);
                book.save();
            }
        });

先存后改。运行程序，点击更新按钮，查看结果。
这里写图片描述
改动生效。这种更新方式只能对已储存的对象进行操作，限制性比较大。另一种更灵巧的方式，修改主程序：

Button updateData = (Button) findViewById(R.id.update_data);
        updateData.setOnClickListener(new View.OnClickListener() {
            @Override
            public 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");
                // 如不指定条件语句，则更新所有数据
            }
        });

重新运行程序。
这里写图片描述
在使用updateAll()时，当想把字段的值更新成默认值时不可使用上面的方式来set数据的（Java中任何一种数据类型字段都会有默认值，new出一个Book对象时，所有字段已被初始化成默认值）。LitePal同意提供了setToDefault()方法，传入相应列名即可实现。如：
Book book = new Book();
book.setToDefault(“pages”);
book.updateAll();

5、删除数据
主要有两种方法：第一种也是直接调用已存储对象的delete()方法（与更新中的第一种方法类似）。
另一种，修改主程序：

Button deleteData = (Button) findViewById(R.id.delete_data);
        deleteData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                DataSupport.deleteAll(Book.class, "price < ?", "15");//不指定约束条件，则删除所有数据
            }
        });

运行程序，点击删除按钮，查看结果：

这里写图片描述

价格低于设置值的那本书已被删除。

6、查询数据

如果希望查询这张表的所有数据。使用LitePal只需这样写：
List books = DataSupport.findAll(Book.class);
findAll()方法返回的是Book类型的List集合，自动完成了赋值操作。
修改主程序：

Button queryData = (Button) findViewById(R.id.query_data);
        queryData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                List<Book> books = DataSupport.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());
                }
            }
        });

运行程序，点击查询按钮。

其他查询API：
查询Book表中第一条数据：
Book firstBook = DataSupport.findFirst(Book.class);
最后一条：
Book lastBook = DataSupport.findLast(Book.class);
通过连缀查询定制更多功能：
select(）方法指定查询那几列数据，如：
List books = DataSupport.select(“name”, “author”).find(Book.class);
where()指定查询约束条件，如：
List books = DataSupport.where(“pages > ?”, “400”).find(Book.class);
order()指定结果的排序方式(默认asc升序)，如：
List books = DataSupport.order(“price desc”).find(Book.class);
limit()指定查询结果数量(行)：
List books = DataSupport.limit(3).find(Book.class);
offset()指定查询结果偏移量，如查询第2、3、4条数据：
List books = DataSupport.limit(3).offset(1).find(Book.class);
还可以对着5个方法进行任意连缀组合，形成复杂查询操作：
List books = DataSupport.select(“name”, “author”, “pages”).where(“pages > ?”, “400”).order(“pages”).limit(10).offset(10).find(Book.class);

LitePal仍然支持使用原生的SQL进行查询：
Cursor c = DataSupport.findBySQL(“select * from Book where pages > ? and price < ?”, “400”, “20”);
findBySQL返回的是cursor对象，需将数据一一取出。

JOJO_小丫

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Android学习笔记——LitePal

LitePal是一款开源的Android数据库框架，采用对象关系映射（ORM）模式，将开发常用的数据库功能进行封装，不用编写SQL语句就可完成各种建表增删查改操作。项目主页上有详细使用文档：https://github.com/LitePalFramework/LitePal1、配置LitePal（Android Studio）现在大多数的开源项目都会提交到jcenter上，所以只需在app/b
复制链接

扫一扫