深入解析Sqlite的完美替代者，android数据库新王者——Realm

写在前面：

又到一年一度七夕虐狗节，看着大家忍受着各种朋友圈和QQ空间还有现实生活中的轮番轰炸，我实在不忍心再在这里给大家补刀，所以我觉得今天不虐狗，继续给大家分享有用的。

如果你比较关心android开发的最新动态的话，我想你一定知道android数据库新王者，没错，就是这个东西——Realm。

在安卓开发中，我们有sharedPreference和文件操作，当然还有一直为之自豪的轻量级数据库sqlite。

SharedPreference其实是采用xml的方式，以键值对形式存储基本数据类型的数据，对于复杂的数据筛选查询操作，file和sharedpreference就显得鸡肋，这个时候sqlite便可以满足有大量复杂查询要求的缓存数据操作，但是它的使用一直被人诟病，是的，因为代码量太多了！

作为一个要为全世界做贡献的程序猿，怎么可以忍受这样多的代码实现一点小东西呢？No,No，我们绝对不能接受！！！

还好网上出现了很多优秀的ORM框架供我们参略，比如ORMite,greenDao等，而这些都是基于SQLite的。

额，还是不扯远了，直接给大家带来今天的主角，没错，就是它——realm！

对于初学Realm的小伙伴，肯定还是应该对比着我们熟悉不过的sqlite来说的。

相比sqlite，Realm具有别人不可比拟的神奇速度，哦，这不是重点，它还有强大先进的特性等着你，比如数据加密支持，对Json的支持，流畅的API，数据观察者变化，所有的一切都是为了让我们程序猿更加潇洒！什么？程序猿还可以潇洒？？有的小伙伴肯定怒火中烧了？楼主别装逗比。

额，好吧，只要你心潇洒，你人就潇洒啦~怎么跑题了呢？还是回归正题！！！

哦，对了，对于Realm，有一个非常强大的东西，就是它可以和当前最主流的网络框架Retrofit以及强大的异步框架Rxjava联用哦，对于Retrofit的介绍可以去直通车：

http://www.cnblogs.com/liushilin/p/5680135.html

等等，怎么总感觉少说了点什么，额，对，如标题一样，它还有一个很强大的特性，那就是它可以总能获取到最新的数据，是的，它是一个live db~~

额，还是说说怎么使用吧，更具体的可以看官方API频道：https://realm.io/docs/java/latest/

1）首先在你的project的gradle文件中添加这样一句，注意：是工程gradle，不是app的gradle，无法编译别怪楼主没提醒你哈！！

 classpath 'io.realm:realm-gradle-plugin:1.1.0'

2）然后再去app下的gradle头部添加：

 apply plugin: 'realm-android'

3）随便写一个Java实体类，例如我写了一个用户类User，只需要继承RealmObject即可，对于主键可以添加注解@PrimaryKey，对于@Required自然是必填项，@Ignore即是可忽略的。

 package com.example.nanchen.realmdemo;

 import io.realm.RealmObject;
 import io.realm.annotations.Ignore;
 import io.realm.annotations.PrimaryKey;
 import io.realm.annotations.Required;

 /**
  *
  * @author nanchen
  * @date  2016-08-08  17:21:15
  */
 public class User extends RealmObject {
     //主键必须添加注解
     @PrimaryKey
     private int id;//主键id
     @Required    //注解设为Required代表必须项
     private String name;//姓名

     private int age;//年龄

     @Ignore   //表示忽视项,数据库不会存储该字段
     private boolean hasGrilFriend;//是否有女朋友

     public User() {
     }

     public User(int id, String name, int age) {
         this.id = id;
         this.name = name;
         this.age = age;
     }

     public User(String name, int id, int age, boolean hasGrilFriend) {
         this.name = name;
         this.id = id;
         this.age = age;
         this.hasGrilFriend = hasGrilFriend;
     }

     public boolean isHasGrilFriend() {
         return hasGrilFriend;
     }

     public void setHasGrilFriend(boolean hasGrilFriend) {
         this.hasGrilFriend = hasGrilFriend;
     }

     public int getId() {
         return id;
     }

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

     public String getName() {
         return name;
     }

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

     public int getAge() {
         return age;
     }

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

     @Override
     public String toString() {
         return "User{" +
                 "id=" + id +
                 ", name='" + name + '\'' +
                 ", age=" + age +
                 ", hasGrilFriend=" + hasGrilFriend +
                 '}';
     }
 }

4）额，这个东西肯定也是需要初始化的嘛。额，楼主这里就单独写一个RealmUtils工具类了。

 package com.example.nanchen.realmdemo;

 import android.content.Context;

 import io.realm.Realm;
 import io.realm.RealmConfiguration;

 /**
  * @author nanchen
  * @date 16-8-8 下午5:51
  */
 public class RealmUtils {
     private Context context;
     private static RealmUtils mInstance;
     private String realName = "myRealm.realm";

     private RealmUtils(Context context){
         this.context = context;
     }

     public static RealmUtils getInstance(Context context){
         if (mInstance == null){
             synchronized (RealmUtils.class){
                 if (mInstance == null){
                     mInstance = new RealmUtils(context);
                 }
             }
         }
         return mInstance;
     }

     /**
      * 获得Realm对象
      * @return
      */
     public Realm getRealm(){
         return Realm.getInstance(new RealmConfiguration.Builder(context).name(realName).build());
     }
 }

5）然后在看看基本操作，楼主这里就使用比较流行的Dao模式吧

先写一个Dao接口，注释很清楚哈。

 package com.example.nanchen.realmdemo;

 import java.sql.SQLException;
 import java.util.List;

 /**
  * 操作数据库的接口Dao
  *
  * @author  nanchen
  * @date   2016-08-08  17:23:18
  *
  */
 public interface UserDao {

     /**
      * 插入一个用户
      * @param user    需要插入的用户对象
      * @throws SQLException
      */
     void insert(User user) throws SQLException;

     /**
      * 获得所有的用户列表
      * @return 用户列表
      * @throws SQLException
      */
     List<User> getAllUser() throws SQLException;

     /**
      * 更新一个用户
      * @param user 需要更新的用户类
      * @return      更新后的对象
      * @throws SQLException
      */
     User updateUser(User user) throws SQLException;

     /**
      * 根据姓名修改新姓名
      * @param name1 老名字
      * @param name2 新名字
      * @throws SQLException
      */
     void updateUser(String name1,String name2) throws SQLException;

     /**
      * 根据id删除用户
      * @param id 用户主键
      * @throws SQLException
      */
     void deleteUser(int id) throws SQLException;

     /**
      * 异步添加用户
      * @param user 需要添加的用户对象
      * @throws SQLException
      */
     void insertUserAsync(User user) throws SQLException;

     /**
      * 按名字或者年龄查找第一个User
      */
     User findByNameOrAge(String name1,int age1) throws SQLException;

     /**
      * 清楚所有
      * @throws SQLException
      */
     void deleteAll() throws SQLException;

     /**
      * 关闭事务
      */
     void closeRealm();
 }

然后是我们的Dao实现类，同样是满满的注释，看楼主对你们这么用心，很感动有木有，想以身相许了有木有，额，楼主，不搞基！！！

不过你既然这么心存感激，就在文章右下角给楼主点个赞吧~~嘿嘿。

 package com.example.nanchen.realmdemo;

 import android.content.Context;

 import java.sql.SQLException;
 import java.util.List;

 import io.realm.Realm;
 import io.realm.Realm.Transaction;
 import io.realm.RealmResults;
 import io.realm.Sort;

 /**
  * @author nanchen
  * @date 16-8-8 下午5:49
  */
 public class UserDaoImpl implements UserDao {

     private Context context;
     private Realm mRealm;

     public UserDaoImpl(Context context) {
         mRealm = RealmUtils.getInstance(context).getRealm();
     }

     /**
      * 同步插入
      * @param user    需要插入的用户对象
      * @throws SQLException
      */
     @Override
     public void insert(User user) throws SQLException {
         mRealm.beginTransaction();//必须先开启事务
         User user1 = mRealm.copyToRealm(user);//把User对象复制到Realm
         mRealm.commitTransaction();//提交事务
 //        mRealm.close();//必须关闭，不然会造成内存泄漏
     }

     /**
      * 返回所有的User对象,并按照名字首字母排序
      * @return  User对象表
      * @throws SQLException
      */
     @Override
     public List<User> getAllUser() throws SQLException {
         List<User> list = null;
         RealmResults<User> results = mRealm.where(User.class).findAll();
         results.sort("name", Sort.DESCENDING);//针对字符串的排序，但目前并不是支持所有字符集
         list = results;
 //        mRealm.close();
         return list;
     }

     /**
      * 更新一个User
      * @param user 需要更新的用户类
      * @return 返回更新后的User
      * @throws SQLException
      */
     @Override
     public User updateUser(User user) throws SQLException {
         mRealm.beginTransaction();//开启事务
         User user1 = mRealm.copyToRealmOrUpdate(user);
         mRealm.commitTransaction();//提交事务
 //        mRealm.close();//必须关闭事务
         return user1;
     }

     /**
      * @param name1 老名字
      * @param name2 新名字
      * @throws SQLException
      */
     @Override
     public void updateUser(String name1, String name2) throws SQLException {
         mRealm.beginTransaction();//开启事务
         mRealm.where(User.class)
                 .equalTo("name",name1)//查询出name为name1的User对象
                 .findFirst()
                 .setName(name2);//修改查询出的第一个对象的名字
         mRealm.commitTransaction();
 //        mRealm.close();
     }

     /**
      * 根据id删除一个User
      * @param id 用户主键
      * @throws SQLException
      */
     @Override
     public void deleteUser(int id) throws SQLException {
         User user = mRealm.where(User.class).equalTo("id",id).findFirst();//删除id列值为id的行
         mRealm.beginTransaction();
         user.deleteFromRealm();//从数据库删除
         mRealm.commitTransaction();
 //        mRealm.close();
     }

     /**
      * 异步插入User
      * @param user 需要添加的用户对象
      * @throws SQLException
      */
     @Override
     public void insertUserAsync(final User user) throws SQLException {
         //一个Realm只能在同一个线程访问，在子线程中进行数据库操作必须重新获取realm对象
         mRealm.executeTransaction(new Transaction() {
             @Override
             public void execute(Realm realm) {
                 realm.beginTransaction();//开启事务
                 User user1 = realm.copyToRealm(user);
                 realm.commitTransaction();
                 realm.close();//记得关闭事务
             }
         });
 //        mRealm.close();//外面也不能忘记关闭事务
     }

     /**
      * 返回第一个指定名字或者年龄的对象
      * @param name1 名字
      * @param age1  年龄
      */
     @Override
     public User findByNameOrAge(String name1,int age1) throws SQLException{
         User user = mRealm.where(User.class)
                 .equalTo("name",name1)//相当于where name = name1
                 .or()//或，连接查询条件，没有这个方式时会默认是&连接
                 .equalTo("age",age1)//相当于where age = age1
                 .findFirst();
         //整体相当于select * from (表名) where name = (传入的name) or age = （传入的age）limit 1;
 //        mRealm.close();
         return user;
     }

     @Override
     public void deleteAll() throws SQLException {
         mRealm.beginTransaction();
         mRealm.where(User.class).findAll().deleteAllFromRealm();
         mRealm.commitTransaction();
 //        mRealm.close();
     }

     @Override
     public void closeRealm() {
         mRealm.close();
     }
 }

6）实际上很多时候我们的close都是写在方法里面的，楼主只是为了测试Demo的好用，就单独写了一个关闭事务的方法来标新立异了哈，大家各自创新~~

额，对了，close你是必须必须调用的，不然你会内存泄漏！！

再简单看一下楼主的调用：

 package com.example.nanchen.realmdemo;

 import android.support.v7.app.AppCompatActivity;
 import android.os.Bundle;
 import android.util.Log;

 import java.sql.SQLException;

 public class MainActivity extends AppCompatActivity {
     private UserDao userDao;

     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_main);

         userDao = new UserDaoImpl(this);
         try {
             userDao.deleteAll();//先删除所有，以免demo出现主键已经存在的异常
             User user = new User();
             user.setId(10);
             user.setName("小刺猬");
             user.setAge(22);
             user.setHasGrilFriend(true);
             userDao.insert(user);

             Log.d("flag","插入小刺猬----"+userDao.getAllUser().toString());

             for (int i = 0; i < 5; i++) {
                 userDao.insert(new User(i,"南尘"+i,20+i));
             }
             Log.d("flag","插入5个对象----"+userDao.getAllUser().toString());
             Log.d("flag","查询1----"+userDao.findByNameOrAge("南尘1",20));
             Log.d("flag","查询2----"+userDao.findByNameOrAge("南尘1",23));
             userDao.updateUser("南尘1","nanchen");
             Log.d("flag","更新1----"+userDao.findByNameOrAge("南尘1",23));
             userDao.deleteUser(0);//删除0
             Log.d("flag","删除后查看----"+userDao.getAllUser().toString());

             //统一关闭事务
             userDao.closeRealm();
         } catch (SQLException e) {
             e.printStackTrace();
         }
     }
 }

7）运行查看结果，好像没啥问题呢。

哈哈，对于Realm的简单使用今天就讲到这里哦，大家赶紧搞定一波学习，有女朋友的陪女朋友去，没女朋友的，赶紧学会了好找女朋友！

项目已同步至：https://github.com/nanchen2251/RealmDemo

额，最后根据Realm类总结一番：

1）Realm类可以对你的持久化对象进行存储和事务管理，可以用来创建RealmObjects实例，并且领域内的对象可以在任何时候查询和读取。

2）修改，插入和删除操作均必须在一个完整的事务中，在更新操作中，我们可以通过copyToRealmOrUpdate来做，但是官方更推荐我们用先查询出来后更新的方法，上面代码也有提到。

3）该事务确保多个实例（在多个线程中）可以在一个一致的状态和保证事务在ACID前提下，访问相同的对象。

4）当一个Realm实例操作完成后，一定一定要记住调用close（）方法，否则导致了本地资源无法释放而引起了OOM别怪楼主没提醒。

5）Realm实例不能不在不同的线程间访问操作，所以楼主的异步插入里面打开了一个新的实例，当然也得关掉它！

6）对于UI线程来说。打开和关闭Realm实例，应当放在onCreate/onDestory或者onPause/onStop方法中。

7）在不同的线程间，Realm实例使用Handler机制来调整它的状态。也就是说，Realm实例在线程中，如果没有Looper，是不能收到更新通知的。除非手动调用waitForChange方法。

8）重点注意：Realm数据库的主键字段不是自动增长的，并且不支持设置数据的自增。需要自己设置，做添加的时候如果不给id字段值，默认为是0。后面再添加的话会报错说id为0的字段已经存在。尤其是批量添加的时候要注意，当心出现只添加了一条记录的悲剧！

9）数据自动更新。可以通过调用addChangeListener（context）来做。当数据库的数据有变化时，系统会自动回调此方法，说到这里，小伙伴是不是心动了？在列表数据的时候，麻麻再也不用担心我忘了更新数据库了。

注：此文章为原创，欢迎转载，请在文章页面明显位置给出此文链接：http://www.cnblogs.com/liushilin/p/5752099.html
若您觉得这篇文章还不错请点击下右下角的推荐，非常感谢！