实战LitePal（Android_Persistent Technology）

LitePal是GitHub上一款开源的Android数据库框架。LitePal是一款开源的Android数据库框架，采用了对象关系映射(ORM)的模式，将平时开发时最常用的一些数据库功能进行了封装，使得开发者不用编写一行SQL语句就可以完成各种建表、増删改查的操作。并且LitePal很"轻"，jar包大小不到100k，而且近乎零配置，这一点和Hibernate这类的框架有很大区别。目前LitePal的源码已经托管到了GitHub上。   

主要内容：

---

0.准备工作（布局）

1.配置LitePal

2.创建和升级数据库

3.使用LitePal添加数据

4.使用LitePal更新数据

5.使用LitePal删除数据

6.使用LitePal查询数据

参考文献：《第一行代码（第2版）》！！！

相关Debug参考文章：

1.Debugexperience about SQLite & LitePal:创建数据库闪退？注意小括号

2.Android Device Monitor--File Explorer 中的/data/data/..无法访问的问题

步骤概要：

---

0.准备工作

        布局这边，准备好几个Button：

1.配置LitePal

1.1.编辑app/build.gradle文件

即添加依赖：compile'org.litepal.android:core:1.4.1'

1.2.右击main目录，创建assets目录，在下面新建一个litepal.xml文件

编辑litepal.xml文件的内容：

<dbname>标签用于指定数据库名；

<version>标签用于指定数据库版本号（初始设置为1）；

<list>标签用于制定所有的映射模型（将class映射成为SQL数据库）；

1.3.在AndroidManifest.xml 中将application配置为"org.litepal.LitePalApplication"，这样才能让LitePal所有功能都可以正常工作：

---

2.创建和升级数据库

2.1.新建一个Book类（面向对象的Java类将会被映射成一个关系型数据库表）：

生成Getter 和Setter的技巧 ：

        先写好“id”“author”“price”等属性字段，然后按下Alt+Insert键，

        在弹出的菜单中选择Getter and Setter，接着使用shift键将所有字段都选中，最后点击OK；

2.2在litepal.xml中用<mapping>标签生命我们要配置的映射模型类

2.3进行任意一次数据库的操作，BookStore.db就会自动创建出来：

        onClick()方法  中的  LitePal.getDatabase()方法  就是一次最简单的数据库操作：

这个时候：

        a.创建数据库：我们先运行一下程序，然后点击 Create database 按钮；

        b.检查数据库创建情况： 接着打开cmd，输入adb shell，回车，cd进入数据库目录（  数据库文件会存放在/data/data/<package name>/databases/目录下  ），使用 ls 指令，可以看到数据库文件已经创建成功了；

这里可能会出现Android Device Monitor--File Explorer 中的/data/data/..无法访问的问题，那么我已经将自己的调试过程在这里记录下来了，可以的话方便参考一下；

        c.接下来我们使用sqlite3命令打开BookStore.db文件（  sqlite3+空格+数据库名称.db即可  ），然后再使用.schema命令查看建表语句：

            book表就是根据我们定义的Book类以及类中的字段来自动生成的；

2.4.升级数据库：只要改你想改的内容，然后将版本号加1就行了；

        a.比如在Book表中添加一个press（出版社）列，直接修改Book类中的代码，添加一个press字段即可：

        b.再添加一个Category表，这时候只需要新建一个Category类就可以了：

        c.随后，在litepal.xml中做两件事：修改version（value加一），在<list>中添加映射模型类；即可：

        d.这时候运行一下程序，然后再点击 Create database 按钮，随后去sqlite查看建表语句即可查证；

---

3.使用LitePal添加数据

3.1.LitePal进行表管理操作时不需要模型类（如Book类）有任何的继承架构，但是进行CRUD操作时就不行了，必须要继承自DataSupport类才行：

3.2.添加数据：

        a.创建一个Book类的实例；

        b.调用Book类中的各种（我们一开始写好的）set方法  对数据进行设置；

        c.调用  save()方法  就能完成数据添加工作了：

        d.运行一下程序，然后再点击 ADD DATA 按钮，随后去sqlite查看建表语句即可查证；打开BookStore.db，输入SQL查询语句select * from Book：

        可以看到，各种数据都被准确无误的添加成功了；

---

4.使用LitePal更新数据

4.1.如下图，第二次调用  save()方法  的时候（对照下图第47--50行），LitePal会发现当前的Book对象是已存储的，因此不会再向数据库中去添加一条新数据，而是会直接更新当前的数据：

4.2.现在重新运行一下程序，然后点击 Update data 按钮，我们再次输入查询语句查看表中的数据情况：

可以见到Book表新增了一条书的数据，但这本书的价格并不是一开始设置的19.95.而是10.99，说明我们的更新操作确实生效了；

4.3.但是这种更新方式只能对已存储的对象进行操作，限制性比较大，接下来学习另外一种更加灵巧的更新方式：

        a.new一个Book的实例；

        b.调用连个set方法来设置需要更新的数据；

        c.调用updateAll()方法去执行更新操作；

        注意：updateAll()方法中可以指定一个条件约束，和SQLiteDatabase中的update()方法中的where参数部分有点类似（  ？是占位符，由后续对应位置的参数进行填充  ），但更加简洁，！！！如果不指定条件语句的话，就表示更新所有数据！！！

        这里我们指定书名为The Lost Symbol并且作者是Dan Brown 的书价格更新为14.95，出版社更新为Anchor；

4.4.运行程序，然后点击 Update data 按钮，我们再次输入查询语句查看表中的数据情况：

拓展：了解setToDefault()方法

---

5.使用LitePal删除数据

5.1. 调用 DataSupport.deleteAll()  方法  来删除数据，第一个参数用于指定删除哪张表中的数据，Book.class就意味着删除Book表中的数据，后面的参数用于指定约束条件；

注意：同样的，类似于updateAll()，如果不指定约束条件如 —— DataSupport.deleteAll(Book.class) ;，意味着你要删除表中的所有数据；

5.2.运行程序，然后点击 Delete data 按钮，我们再次输入查询语句查看表中的数据情况：

---

6.使用LitePal查询数据

6.1.

        a.通过调用 findAll() 方法，然后通过Book.class参数指定查询Book表就可以；

        b.findAll()方法的返回值是一个Book类型的List集合，也就是说我们不用像Cursor对象一行行去取值了，LitePal已经自动帮我们完成了赋值操作；

        c.拓展  findFirst  和  findLast  方法：

6.2.

为了便于观察，我们增加成两行数据：

运行程序，然后点击 Query data 按钮，然后查看logcat的打印内容:

6.3.拓展：查看API或《第一行代码》，了解LitePal的  select()  ,  where()  ,  order()  ,  limit()  ，  offset()  等查询方法以及连缀使用。

---

总结：LitePal将面向对象的语言和面向关系的数据库之间建立了一种映射关系，使用了LitePal，我们就可以用面向对象的思维来实现同面向关系的数据库一样的功能了，十分魔法和痛快！

补充：

1.模型类映射为关系型表；类的属性变量即为表的列；

2.模型类中的属性变量可以在实例化之后用来暂时存储数据；

3.模型类的get和set方法则用来对模型类中的属性值进行操作。