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，如下：

所以我选择了第二种方式配置，在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查看是否创建成功了。如图：

可以看到刚刚成功创建的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(*)，就能成功保存数据库，

删除所有数据时候调用：SearchHistroyDao.cleanChanels()即可。好了，LitePal数据讲解完成。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持我们。

您可能感兴趣的文章:

• Android利用LitePal操作数据库存取图片