写在前面:html
又到一年一度七夕虐狗节,看着你们忍受着各类朋友圈和QQ空间还有现实生活中的轮番轰炸,我实在不忍心再在这里给你们补刀,因此我以为今天不虐狗,继续给你们分享有用的。java
若是你比较关心android开发的最新动态的话,我想你必定知道android数据库新王者,没错,就是这个东西——Realm。android
在安卓开发中,咱们有sharedPreference和文件操做,固然还有一直为之自豪的轻量级数据库sqlite。git
SharedPreference实际上是采用xml的方式,以键值对形式存储基本数据类型的数据,对于复杂的数据筛选查询操做,file和sharedpreference就显得鸡肋,这个时候sqlite即可以知足有大量复杂查询要求的缓存数据操做,可是它的使用一直被人诟病,是的,由于代码量太多了!github
做为一个要为全世界作贡献的程序猿,怎么能够忍受这样多的代码实现一点小东西呢?No,No,咱们绝对不能接受!!!sql
还好网上出现了不少优秀的ORM框架供咱们参略,好比ORMite,greenDao等,而这些都是基于SQLite的。数据库
额,仍是不扯远了,直接给你们带来今天的主角,没错,就是它——realm!缓存
对于初学Realm的小伙伴,确定仍是应该对比着咱们熟悉不过的sqlite来讲的。网络
相比sqlite,Realm具备别人不可比拟的神奇速度,哦,这不是重点,它还有强大先进的特性等着你,好比数据加密支持,对Json的支持,流畅的API,数据观察者变化,全部的一切都是为了让咱们程序猿更加潇洒!什么?程序猿还能够潇洒??有的小伙伴确定怒火中烧了?楼主别装逗比。app
额,好吧,只要你心潇洒,你人就潇洒啦~怎么跑题了呢?仍是回归正题!!!
哦,对了,对于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,没法编译别怪楼主没提醒你哈!!
1 classpath 'io.realm:realm-gradle-plugin:1.1.0'
2)而后再去app下的gradle头部添加:
1 apply plugin: 'realm-android'
3)随便写一个Java实体类,例如我写了一个用户类User,只须要继承RealmObject便可,对于主键能够添加注解@PrimaryKey,对于@Required天然是必填项,@Ignore便是可忽略的。
1 package com.example.nanchen.realmdemo; 2 3 import io.realm.RealmObject; 4 import io.realm.annotations.Ignore; 5 import io.realm.annotations.PrimaryKey; 6 import io.realm.annotations.Required; 7 8 /** 9 * 10 * @author nanchen 11 * @date 2016-08-08 17:21:15 12 */ 13 public class User extends RealmObject { 14 //主键必须添加注解 15 @PrimaryKey 16 private int id;//主键id 17 @Required //注解设为Required表明必须项 18 private String name;//姓名 19 20 private int age;//年龄 21 22 @Ignore //表示忽视项,数据库不会存储该字段 23 private boolean hasGrilFriend;//是否有女友 24 25 public User() { 26 } 27 28 public User(int id, String name, int age) { 29 this.id = id; 30 this.name = name; 31 this.age = age; 32 } 33 34 public User(String name, int id, int age, boolean hasGrilFriend) { 35 this.name = name; 36 this.id = id; 37 this.age = age; 38 this.hasGrilFriend = hasGrilFriend; 39 } 40 41 public boolean isHasGrilFriend() { 42 return hasGrilFriend; 43 } 44 45 public void setHasGrilFriend(boolean hasGrilFriend) { 46 this.hasGrilFriend = hasGrilFriend; 47 } 48 49 public int getId() { 50 return id; 51 } 52 53 public void setId(int id) { 54 this.id = id; 55 } 56 57 public String getName() { 58 return name; 59 } 60 61 public void setName(String name) { 62 this.name = name; 63 } 64 65 public int getAge() { 66 return age; 67 } 68 69 public void setAge(int age) { 70 this.age = age; 71 } 72 73 @Override 74 public String toString() { 75 return "User{" + 76 "id=" + id + 77 ", name='" + name + '\'' + 78 ", age=" + age + 79 ", hasGrilFriend=" + hasGrilFriend + 80 '}'; 81 } 82 }
4)额,这个东西确定也是须要初始化的嘛。额,楼主这里就单独写一个RealmUtils工具类了。
1 package com.example.nanchen.realmdemo; 2 3 import android.content.Context; 4 5 import io.realm.Realm; 6 import io.realm.RealmConfiguration; 7 8 /** 9 * @author nanchen 10 * @date 16-8-8 下午5:51 11 */ 12 public class RealmUtils { 13 private Context context; 14 private static RealmUtils mInstance; 15 private String realName = "myRealm.realm"; 16 17 private RealmUtils(Context context){ 18 this.context = context; 19 } 20 21 public static RealmUtils getInstance(Context context){ 22 if (mInstance == null){ 23 synchronized (RealmUtils.class){ 24 if (mInstance == null){ 25 mInstance = new RealmUtils(context); 26 } 27 } 28 } 29 return mInstance; 30 } 31 32 /** 33 * 得到Realm对象 34 * @return 35 */ 36 public Realm getRealm(){ 37 return Realm.getInstance(new RealmConfiguration.Builder(context).name(realName).build()); 38 } 39 }
5)而后在看看基本操做,楼主这里就使用比较流行的Dao模式吧
先写一个Dao接口,注释很清楚哈。
1 package com.example.nanchen.realmdemo; 2 3 import java.sql.SQLException; 4 import java.util.List; 5 6 /** 7 * 操做数据库的接口Dao 8 * 9 * @author nanchen 10 * @date 2016-08-08 17:23:18 11 * 12 */ 13 public interface UserDao { 14 15 /** 16 * 插入一个用户 17 * @param user 须要插入的用户对象 18 * @throws SQLException 19 */ 20 void insert(User user) throws SQLException; 21 22 /** 23 * 得到全部的用户列表 24 * @return 用户列表 25 * @throws SQLException 26 */ 27 List<User> getAllUser() throws SQLException; 28 29 /** 30 * 更新一个用户 31 * @param user 须要更新的用户类 32 * @return 更新后的对象 33 * @throws SQLException 34 */ 35 User updateUser(User user) throws SQLException; 36 37 /** 38 * 根据姓名修改新姓名 39 * @param name1 老名字 40 * @param name2 新名字 41 * @throws SQLException 42 */ 43 void updateUser(String name1,String name2) throws SQLException; 44 45 /** 46 * 根据id删除用户 47 * @param id 用户主键 48 * @throws SQLException 49 */ 50 void deleteUser(int id) throws SQLException; 51 52 /** 53 * 异步添加用户 54 * @param user 须要添加的用户对象 55 * @throws SQLException 56 */ 57 void insertUserAsync(User user) throws SQLException; 58 59 /** 60 * 按名字或者年龄查找第一个User 61 */ 62 User findByNameOrAge(String name1,int age1) throws SQLException; 63 64 /** 65 * 清楚全部 66 * @throws SQLException 67 */ 68 void deleteAll() throws SQLException; 69 70 /** 71 * 关闭事务 72 */ 73 void closeRealm(); 74 }
而后是咱们的Dao实现类,一样是满满的注释,看楼主对大家这么用心,很感动有木有,想以身相许了有木有,额,楼主,不搞基!!!
不过你既然这么心存感激,就在文章右下角给楼主点个赞吧~~嘿嘿。
1 package com.example.nanchen.realmdemo; 2 3 import android.content.Context; 4 5 import java.sql.SQLException; 6 import java.util.List; 7 8 import io.realm.Realm; 9 import io.realm.Realm.Transaction; 10 import io.realm.RealmResults; 11 import io.realm.Sort; 12 13 /** 14 * @author nanchen 15 * @date 16-8-8 下午5:49 16 */ 17 public class UserDaoImpl implements UserDao { 18 19 private Context context; 20 private Realm mRealm; 21 22 public UserDaoImpl(Context context) { 23 mRealm = RealmUtils.getInstance(context).getRealm(); 24 } 25 26 /** 27 * 同步插入 28 * @param user 须要插入的用户对象 29 * @throws SQLException 30 */ 31 @Override 32 public void insert(User user) throws SQLException { 33 mRealm.beginTransaction();//必须先开启事务 34 User user1 = mRealm.copyToRealm(user);//把User对象复制到Realm 35 mRealm.commitTransaction();//提交事务 36 // mRealm.close();//必须关闭,否则会形成内存泄漏 37 } 38 39 /** 40 * 返回全部的User对象,并按照名字首字母排序 41 * @return User对象表 42 * @throws SQLException 43 */ 44 @Override 45 public List<User> getAllUser() throws SQLException { 46 List<User> list = null; 47 RealmResults<User> results = mRealm.where(User.class).findAll(); 48 results.sort("name", Sort.DESCENDING);//针对字符串的排序,但目前并非支持全部字符集 49 list = results; 50 // mRealm.close(); 51 return list; 52 } 53 54 /** 55 * 更新一个User 56 * @param user 须要更新的用户类 57 * @return 返回更新后的User 58 * @throws SQLException 59 */ 60 @Override 61 public User updateUser(User user) throws SQLException { 62 mRealm.beginTransaction();//开启事务 63 User user1 = mRealm.copyToRealmOrUpdate(user); 64 mRealm.commitTransaction();//提交事务 65 // mRealm.close();//必须关闭事务 66 return user1; 67 } 68 69 /** 70 * @param name1 老名字 71 * @param name2 新名字 72 * @throws SQLException 73 */ 74 @Override 75 public void updateUser(String name1, String name2) throws SQLException { 76 mRealm.beginTransaction();//开启事务 77 mRealm.where(User.class) 78 .equalTo("name",name1)//查询出name为name1的User对象 79 .findFirst() 80 .setName(name2);//修改查询出的第一个对象的名字 81 mRealm.commitTransaction(); 82 // mRealm.close(); 83 } 84 85 /** 86 * 根据id删除一个User 87 * @param id 用户主键 88 * @throws SQLException 89 */ 90 @Override 91 public void deleteUser(int id) throws SQLException { 92 User user = mRealm.where(User.class).equalTo("id",id).findFirst();//删除id列值为id的行 93 mRealm.beginTransaction(); 94 user.deleteFromRealm();//从数据库删除 95 mRealm.commitTransaction(); 96 // mRealm.close(); 97 } 98 99 /** 100 * 异步插入User 101 * @param user 须要添加的用户对象 102 * @throws SQLException 103 */ 104 @Override 105 public void insertUserAsync(final User user) throws SQLException { 106 //一个Realm只能在同一个线程访问,在子线程中进行数据库操做必须从新获取realm对象 107 mRealm.executeTransaction(new Transaction() { 108 @Override 109 public void execute(Realm realm) { 110 realm.beginTransaction();//开启事务 111 User user1 = realm.copyToRealm(user); 112 realm.commitTransaction(); 113 realm.close();//记得关闭事务 114 } 115 }); 116 // mRealm.close();//外面也不能忘记关闭事务 117 } 118 119 120 /** 121 * 返回第一个指定名字或者年龄的对象 122 * @param name1 名字 123 * @param age1 年龄 124 */ 125 @Override 126 public User findByNameOrAge(String name1,int age1) throws SQLException{ 127 User user = mRealm.where(User.class) 128 .equalTo("name",name1)//至关于where name = name1 129 .or()//或,链接查询条件,没有这个方式时会默认是&链接 130 .equalTo("age",age1)//至关于where age = age1 131 .findFirst(); 132 //总体至关于select * from (表名) where name = (传入的name) or age = (传入的age)limit 1; 133 // mRealm.close(); 134 return user; 135 } 136 137 @Override 138 public void deleteAll() throws SQLException { 139 mRealm.beginTransaction(); 140 mRealm.where(User.class).findAll().deleteAllFromRealm(); 141 mRealm.commitTransaction(); 142 // mRealm.close(); 143 } 144 145 146 @Override 147 public void closeRealm() { 148 mRealm.close(); 149 } 150 }
6)实际上不少时候咱们的close都是写在方法里面的,楼主只是为了测试Demo的好用,就单独写了一个关闭事务的方法来标新立异了哈,你们各自创新~~
额,对了,close你是必须必须调用的,否则你会内存泄漏!!
再简单看一下楼主的调用:
1 package com.example.nanchen.realmdemo; 2 3 import android.support.v7.app.AppCompatActivity; 4 import android.os.Bundle; 5 import android.util.Log; 6 7 import java.sql.SQLException; 8 9 public class MainActivity extends AppCompatActivity { 10 private UserDao userDao; 11 12 @Override 13 protected void onCreate(Bundle savedInstanceState) { 14 super.onCreate(savedInstanceState); 15 setContentView(R.layout.activity_main); 16 17 userDao = new UserDaoImpl(this); 18 try { 19 userDao.deleteAll();//先删除全部,以避免demo出现主键已经存在的异常 20 User user = new User(); 21 user.setId(10); 22 user.setName("小刺猬"); 23 user.setAge(22); 24 user.setHasGrilFriend(true); 25 userDao.insert(user); 26 27 Log.d("flag","插入小刺猬----"+userDao.getAllUser().toString()); 28 29 for (int i = 0; i < 5; i++) { 30 userDao.insert(new User(i,"南尘"+i,20+i)); 31 } 32 Log.d("flag","插入5个对象----"+userDao.getAllUser().toString()); 33 Log.d("flag","查询1----"+userDao.findByNameOrAge("南尘1",20)); 34 Log.d("flag","查询2----"+userDao.findByNameOrAge("南尘1",23)); 35 userDao.updateUser("南尘1","nanchen"); 36 Log.d("flag","更新1----"+userDao.findByNameOrAge("南尘1",23)); 37 userDao.deleteUser(0);//删除0 38 Log.d("flag","删除后查看----"+userDao.getAllUser().toString()); 39 40 41 //统一关闭事务 42 userDao.closeRealm(); 43 } catch (SQLException e) { 44 e.printStackTrace(); 45 } 46 } 47 }
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若您以为这篇文章还不错请点击下右下角的推荐,很是感谢!