Android中数据库操作框架Realm介绍与使用

Realm 是一个全新的移动数据库引擎，它既不是基于ios平台的Core Data，也不是基于SQLite,它拥有自己的数据库存储引擎，并实现了高效快速的数据库构建操作，相比Core Data和SQLite,Realm操作要快很多，跟ORM框架相比就更不用说了。

数据库Realm，是用来替代sqlite的一种解决方案，它有一套自己的数据库存储引擎，比sqlite更轻量级，拥有更快的速度，并且具有很多现代数据库的特性，比如支持JSON，流式api，数据变更通知，自动数据同步,简单身份验证，访问控制，事件处理，最重要的是跨平台，目前已有Java，Objective C，Swift，React-Native，Xamarin这五种实现。

开发者应该尝试使用Realm的理由如下：

• 跨平台：Android和ios已经是事实上的两大移动互联网操作系统，绝大部分应用都会支持这两个平台。使用Realm，Android和ios无需考虑内部数据的架构，调用Realm的Api即可轻松完成数据的交互，实现“一个数据库，两个平台之间的无缝衔接”
• 用法简单：相比Core Data和SQLite所需要的入门知识，Relam可以极大降低开发者的学习成本，快速实现数据库存贮功能。
• 可视化操作：Relam为开发者提供了一个轻量级的数据库可视化操作工具，开发者可以轻松查看数据库里的内容，并实现简单的插入和删除操作。

环境搭建：
参考 GITHUB

buildscript {
    repositories {
        jcenter()
        google()
        maven {
            url 'http://oss.jfrog.org/artifactory/oss-snapshot-local'
        }
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:<version>-SNAPSHOT"
    }
}

allprojects {
    repositories {
        jcenter()
        google()
        maven {
            url 'http://oss.jfrog.org/artifactory/oss-snapshot-local'
        }
    }
}

使用默认配置

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    // The Realm file will be located in Context.getFilesDir() with name "default.realm"
    Realm.init(this);
    RealmConfiguration config = new RealmConfiguration.Builder().build();
    Realm.setDefaultConfiguration(config);
  }
}

使用自定义配置

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Realm.init(this);
    RealmConfiguration config = new  RealmConfiguration.Builder()
                                         .name("myRealm.realm")
                                         .deleteRealmIfMigrationNeeded()
                                         .build();
    Realm.setDefaultConfiguration(config);
  }
}

在AndroidManifest.xml配置自定义的Application

<application
  android:name=".MyApplication"
  ...
/>

创建实体

新建一个类继承RealmObject

public class User extends RealmObject {
    public String userName;
    public String addr;
    public int age;
    @PrimaryKey
    public long userId;

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public String getAddr() {
        return addr;
    }

    public void setAddr(String addr) {
        this.addr = addr;
    }

    public int getAge() {
        return age;
    }

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

    public long getUserId() {
        return userId;
    }

    public void setUserId(long userId) {
        this.userId = userId;
    }

    @Override
    public String toString() {
        return "User{" +
                "userName='" + userName + '\'' +
                ", addr='" + addr + '\'' +
                ", age=" + age +
                ", userId=" + userId +
                '}';
    }
}

（2）其他相关说明

1、支持的数据类型：
boolean, byte, short, int, long, float, double, String, Date and byte[]
在Realm中byte, short, int, long最终都被映射成long类型

2、注解说明

@PrimaryKey
①字段必须是String、 integer、byte、short、 int、long 以及它们的封装类Byte, Short, Integer, and Long

②使用了该注解之后可以使用copyToRealmOrUpdate()方法，通过主键查询它的对象，如果查询到了，则更新它，否则新建一个对象来代替。

③使用了该注解将默认设置@index注解

④使用了该注解之后，创建和更新数据将会慢一点，查询数据会快一点。

@Required
数据不能为null

@Ignore
忽略，即该字段不被存储到本地

@Index
为这个字段添加一个搜索引擎，这将使插入数据变慢、数据增大，但是查询会变快。建议在需要优化读取性能的情况下使用。

增

（1）实现方法一：事务操作

类型一 ：新建一个对象，并进行存储

Realm realm=Realm.getDefaultInstance();

realm.beginTransaction();
User user = realm.createObject(User.class); // Create a new object
user.setUserName("John");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
realm.commitTransaction();

类型二：复制一个对象到Realm数据库

Realm realm=Realm.getDefaultInstance();
User user = new User();
user.setUserName("john");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
// Copy the object to Realm. Any further changes must happen on realmUser
realm.beginTransaction();
realm.copyToRealm(user);
realm.commitTransaction();

（2）实现方法二：使用事务块

Realm  mRealm=Realm.getDefaultInstance();
final User user = new User();
user.setUserName("john");
user.setAge(18);
user.setAddr("asd");
user.setuserId(1);
mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {

            realm.copyToRealm(user);

            }
        });

删

  Realm  mRealm=Realm.getDefaultInstance();

    final RealmResults<User> users=  mRealm.where(User.class).findAll();

        mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {

                User user=users.get(5);
                user.deleteFromRealm();
                //删除第一个数据
                users.deleteFirstFromRealm();
                //删除最后一个数据
                users.deleteLastFromRealm();
                //删除位置为1的数据
                users.deleteFromRealm(1);
                //删除所有数据
                users.deleteAllFromRealm();
            }
        });

同样也可以使用同上的beginTransaction和commitTransaction方法进行删除

改

Realm  mRealm=Realm.getDefaultInstance();
Dog dog = mRealm.where(User.class).equalTo("userId", 2).findFirst();
mRealm.beginTransaction();
dog.setName("asd");
mRealm.commitTransaction();

同样也可以用事物块来更新数据

查

（1）查询全部

查询结果为RealmResults，可以使用mRealm.copyFromRealm(users)方法将它转为List

   public List<User> queryAllUser() {
        Realm  mRealm=Realm.getDefaultInstance();
        RealmResults<User> usres = mRealm.where(User.class).findAll();
        return mRealm.copyFromRealm(usres);
    }

（2）条件查询

    public User queryUserById(int id) {
        Realm  mRealm=Realm.getDefaultInstance();
        User user = mRealm.where(User.class).equalTo("userId", id).findFirst();
        return user;
    }

常见的条件如下（详细资料请查官方文档）：

between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()

equalTo() & notEqualTo()

contains(), beginsWith() & endsWith()

isNull() & isNotNull()

isEmpty() & isNotEmpty()

（3）对查询结果进行排序

   /**
     * query （查询所有）
     */
    public List<User> queryAllUser() {
        RealmResults<User> users = mRealm.where(User.class).findAll();
        /**
         * 对查询结果，按Id进行排序，只能对查询结果进行排序
         */
        //增序排列
        users=users.sort("userId");
        //降序排列
        users=users.sort("userId", Sort.DESCENDING);
        return mRealm.copyFromRealm(users);
    }

（4）其他查询

sum，min，max，average只支持整型数据字段

 /**
     *  查询平均年龄
     */
    private void getAverageAge() {
         double avgAge=  mRealm.where(User.class).findAll().average("age");
    }

    /**
     *  查询总年龄
     */
    private void getSumAge() {
      Number sum=  mRealm.where(User.class).findAll().sum("age");
        int sumAge=sum.intValue();
    }

    /**
     *  查询最大年龄
     */
    private void getMaxId(){
      Number max=  mRealm.where(User.class).findAll().max("age");
        int maxAge=max.intValue();
    }

这里就介绍到这里，对于Realm的异步操作，以及数据库的数据迁移（版本升级）可以参考这篇博客

原来不同的CPU架构平台的.so文件增加了整个包的大小，由于arm平台的so在其他平台上面使能够以兼容模式运行的，虽然会损失性能，但是这样可以极大的减少函数库占用的空间。因此，可以选择只保留armeabi-v7a和x86两个平台的.so文件，直接删除无用的.so文件，或者通过在工程的build.gradle文件增加ndk abi过滤 语法如下：

android{
    defaultConfig{
        ndk{
            abiFilters "armeabi-v7a","x86"
        }
    }

}

代码