Android数据库 —— LitePal的基本用法

前言
正好项目用了这种数据存储方式，特地写一篇加深印象，在我看来，LitePal是使用最简单，集成最方便的数据库，没有之一。

LitePal 简介
LitePal 是一款开源的 Android 数据库框架，它采用了对象关系映射（ORM）的模式，将我们平时使用的一些数据库（比如 Sqlite）功能进行了封装。

配置

第一步
gradle注入：

 compile 'org.litepal.android:core:1.6.1'

这里我的版本是1.6.1的，如果想获得最新版本，请看这里：https://github.com/LitePalFramework/LitePal

第二步
接着需要配置 litepal.xml 文件，在 app/src/main 目录右键 -> New -> Directory , 创建一个 assets 目录，在该目录下新建一个 litepal.xml 文件，编辑内容如下：

 <?xml version="1.0" encoding="utf-8"?>
 <litepal>
      <dbname value="hskj_user" />
      <version value="1" />
      <list></list>
 </litepal>

说明： <dbname>用于设定数据库的名字，可以随便起名，我这里是hskj_user，<version>用于设定数据库的版本号，<list>用于设定所有的映射模型，我们稍后就会用到。

第三步
配置 LitePalApplication，这里有2种方法：
①如果项目的Application没有继承其他的Application，可以按照下面方式写：

 public class MyApplication extends LitePalApplication {  
        ...  
 }  

②由于我的项目集成了MultiDexApplication，如下： 截图.png

所以我选择了第二种方式配置，在application中的onCreate()配置

@Override
public void onCreate() {
   super.onCreate();
   LitePal.initialize(this);
}

经过上面的步骤已经将 LitePal 配置完成，接下里开始建表：

import org.litepal.crud.DataSupport;
/**
  * Created by zjp on 2018/1/16 16:22.
  */           
public class TestEntity  extends DataSupport {

    private int id; 
    private int age;

    public int getId() {
        return id;
    }

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

    public int getAge() {
       return age;
    }

    public void setAge(int age) {
       this.age = age;
    }
}

其实这就是一个 JavaBean ,定义了两个简单的属性，其中id这个字段可写可不写，因为即使不写这个字段，LitePal也会在表中自动生成一个id列，毕竟每张表都一定要有主键的。

建好了表之后，接下来还需要将它添加到我们的模型列表中：

 <?xml version="1.0" encoding="utf-8"?>
 <litepal>
      <dbname value="hskj_user" />
      <version value="1" />
      <list>
            <mapping class="com.example.zjp.litepaldemo.bean.TestEntity"></mapping>
      </list>
 </litepal>

现在我们就可以测试了，启动一个 Activity ,我这里只添加了一个按钮，在其点击事件下写下面一句代码：

  LitePal.getDatabase();  

等运行成功之后，可以打开Android Device Monitor查看是否创建成功了。如图： 截图.png

可以看到刚刚成功创建的hskj_user数据库了。

这里我暂时只演示下数据存储和删除吧，可以在自己工程中新建一个类，来对LitePal数据库操作，我是这样写的：

/**
  * Created by zjp on 2018/1/12 10:01.
  */
 public class SearchHistroyDao {
     /**
       * 获取所有频道
       *
       * @return
       */
       public static List<TestEntity> getChannels() {
            return DataSupport.findAll(TestEntity.class);
       }
     
      /**
        * 保存年龄关键字
        */
        public static void saveHistoryKeyword(int ageVal) {
             if (ageVal == 0) return;
             TestEntity testEntity = new TestEntity();
             testEntity.age = ageVal;
             testEntity.save();
        }

        /**
          * 清空所有频道
          */
         public static void cleanChanels() {
              DataSupport.deleteAll(TestEntity.class);
         }
 }

增
调用SearchHistroyDao.saveHistoryKeyword()可以成功保存数据
不过还有另一种方法（不推荐）

//ContentValues cv = new ContentValues();
//cv.put("age", 25);
//db.insert("TestEntity", null, cv);

然后在你要保存数据的时候，调用SearchHistroyDao.saveHistoryKeyword(*)，就能成功保存数据库
删除所有数据时候调用：SearchHistroyDao.cleanChanels()即可。好了，LitePal数据讲解完成。