在 Android 中使用 Realm 作本地存储
<p>Android平台有很多的orm框架可以对数据作本地存储,比如ormlite、greenDao、SugarORM等等,这些orm框架基本都是基于sqlite的。今天我要介绍的这个数据库Realm,是用来替代sqlite的一种解决方案,它有一套自己的数据库存储引擎,比sqlite更轻量级,拥有更快的速度,最重要的是跨平台,目前已有Java,Objective C,Swift,React-Native,Xamarin这五种实现。</p> <p>本文是Realm数据库在Android中使用的一个入门级的教程,这里不对Realm与其他的orm框架的优缺点作讨论。</p> <p>本文学习目录</p> <p>一.环境配置</p> <p>二.创建实体</p> <p>三.CRUD(增删改查操作)</p> <p>四.进阶用法</p> <h3><strong>一.环境配置</strong></h3> <ol> <li>在项目的build文件加上 <pre> <code class="language-java">buildscript { repositories { jcenter() } dependencies { ... classpath "io.realm:realm-gradle-plugin:1.2.0" }</code></pre> </li> <li>在 app 的 build文件中加入 <pre> <code class="language-java">apply plugin: 'realm-android'</code></pre> </li> </ol> <h3><strong>二.创建实体</strong></h3> <p>Realm 支持的字段类型,除了Java提供的基本类型之外,Realm还支持 继承了RealmObject 的对象 和 RealmList<? extends RealmObject></p> <p>这里为了方便直接使用了示例项目中的对象了。</p> <p>创建一个User实体</p> <pre> <code class="language-java">public class User extends RealmObject { @PrimaryKey private String id; private String name; private int age; private RealmList<User> friends; 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; } public String getId() { return id; } public void setId(String id) { this.id = id; } public RealmList<User> getFriends() { return friends; } public void setFriends(RealmList<User> friends) { this.friends = friends; } }</code></pre> <p>细心的同学已经注意到了,我们上面创建的实体对象继承于RealmObject ,Realm 数据实体定义需要继承自 RealmObject类。</p> <p>这里需要知道的几点:</p> <ul> <li>@PrimaryKey 用来标识主键</li> <li>默认的所有的字段都会被存储</li> <li>如果某个字段不需要被存储到本地,则需在在这个字段上面加上 @Ignore 注解</li> </ul> <h3><strong>三.CRUD(增删改查操作)</strong></h3> <p>数据库的使用无非上就是增删改查这四种操作,其中查是重点,在写原生sql语句中这也是个难点。下面我们就来看看Realm的CRUD是怎样的</p> <p><strong>1.添加数据</strong></p> <pre> <code class="language-java">RealmConfiguration realmConfig = new RealmConfiguration .Builder(this) .build(); Realm realm = Realm.getInstance(realmConfig);</code></pre> <pre> <code class="language-java">public void testAdd() { initRealm(); realm.executeTransaction(new Realm.Transaction() { @Override public void execute(Realm realm) { for (int i = 0; i < 10; i++) { User user = realm.createObject(User.class); user.setName("user" + i); user.setAge(10 + i); user.setId(UUID.randomUUID().toString()); } showInTextView("10条数据添加成功"); } }); }</code></pre> <p>在用Realm进行操作之前需要对Realm作相关的配置操作,Realm中所有的写操作都必须在事务中进行,不然就会报错, <strong>记得在Activity的onDestory中调用realm.close()释放资源。</strong>上面的代码片段就创建了10个User对象。</p> <p><strong>2.查询数据</strong></p> <ul> <li>查询全部 <pre> <code class="language-java">public void testQuery() { List<User> users= realm.where(User.class).findAll(); for (User user: users) { showInTextView("id:" + user.getId() + " name:" + user.getName() + " age:" + user.getAge()); } }</code></pre> </li> <li>条件查询,Realm 支持以下查询条件(来源于官网): <ul> <li>between()、greaterThan()、lessThan()、greaterThanOrEqualTo() 和 lessThanOrEqualTo()</li> <li>equalTo() 和 notEqualTo()</li> <li>contains()、beginsWith() 和 endsWith()</li> <li>isNull() 和 isNotNull()</li> <li>isEmpty() 和 isNotEmpty()</li> </ul> </li> </ul> <p>以下代码片段查询年龄小于15的User</p> <pre> <code class="language-java">public void testQueryAgeLessThan15() { List<User> users= realm.where(User.class).lessThan("age", 15).findAll(); for (User user: users) { showInTextView("id:" + user.getId() + " name:" + user.getName() + " age:" + user.getAge()); } }</code></pre> <ul> <li> <p>聚合查询,支持的聚合操作有sum,min,max,average</p> <p>以下代码片段得到所有人的平均年龄</p> <pre> <code class="language-java">public void testQueryAverageAge() { double age = realm.where(User.class).findAll().average("age"); textView.setText("average age:" + age); }</code></pre> </li> </ul> <p><strong>3.更新数据</strong></p> <pre> <code class="language-java">public void testUpdate() { realm.executeTransaction(new Realm.Transaction() { @Override public void execute(Realm realm) { User user = realm.where(User.class).equalTo("name", "user9").findFirst(); if (user != null) { user.setAge(99); user.setName("二逼青年"); } textView.setText("更新成功"); } }); }</code></pre> <p><strong>4.删除数据</strong></p> <p>以下代码片段展示了如何删除指定的对象</p> <pre> <code class="language-java">public void testDelete() { realm.executeTransaction(new Realm.Transaction() { @Override public void execute(Realm realm) { User user = realm.where(User.class).equalTo("name", "user0").findFirst(); if (user != null) user.deleteFromRealm(); textView.setText("删除成功"); } }); }</code></pre> <h2><strong>四.进阶用法</strong></h2> <p>通过前面一节的学习,我们基本学会了Realm数据库基本的增删改查操作。</p> <p>本节来看看Realm还有什么其他用法</p> <p><strong>1.用json创建对象</strong></p> <p>在实际开发中我们和json打交道的机会比较多,所以直接从json去创建对象是十分有用的,下面的代码片段展示了怎么去用。</p> <pre> <code class="language-java">private void testAddFromJson() { realm.executeTransaction(new Realm.Transaction() { @Override public void execute(Realm realm) { String json = "{\n" + " \"id\": \"uuid1\",\n" + " \"name\": \"solid\",\n" + " \"age\": 20\n" + "}"; String jsons = "[\n" + " {\n" + " \"id\": \"uuid1\",\n" + " \"name\": \"solid\",\n" + " \"age\": 20\n" + " },\n" + " {\n" + " \"id\": \"uuid2\",\n" + " \"name\": \"jhack\",\n" + " \"age\": 21\n" + " },\n" + " {\n" + " \"id\": \"uuid3\",\n" + " \"name\": \"tom\",\n" + " \"age\": 22\n" + " }\n" + "]"; //realm.createObjectFromJson(User.class, json); realm.createAllFromJson(User.class, jsons); } }); }</code></pre> <p><strong>2.数据模型改变的处理</strong></p> <p>开发中数据模型不可能从一开始创建了,就保证后面的开发过程中不会更改,对于Realm如果其中的某个实体类改变了,而我们没有做任何的处理,就会报错,如果还处于应用的开发的初期,这无所谓,直接清空数据即可,但是如果应用已经发布了,我们就需要去寻找一种解决方案了。</p> <p>这里的解决方案如下:</p> <pre> <code class="language-java">public class MyMigration implements RealmMigration { @Override public void migrate(DynamicRealm realm, long oldVersion, long newVersion) { Log.e(MainActivity.TAG, "oldVersion:" + oldVersion + " newVersion:" + newVersion); RealmSchema schema = realm.getSchema(); if (newVersion == 2) { schema.get("User") .addField("desc", String.class); } } @Override public boolean equals(Object obj) { return obj instanceof MyMigration; } @Override public int hashCode() { return super.hashCode(); } }</code></pre> <pre> <code class="language-java">realmConfig = new RealmConfiguration .Builder(this) .schemaVersion(2) .migration(new MyMigration()) .build();</code></pre> <p><strong>3.与RxJava的结合</strong></p> <p>Realm原生是支持Rxjava的,由于RxJava 是可选依赖,所以在使用的时候需要在app的build文件中添加RxJava库的依赖,下面是使用的代码片段。</p> <pre> <code class="language-java">public void testRxJava() { realm.where(User.class).findAll() .asObservable() .flatMap(new Func1<RealmResults<User>, Observable<User>>() { @Override public Observable<User> call(RealmResults<User> users) { return Observable.from(users); } }) .subscribe(new Action1<User>() { @Override public void call(User user) { showInTextView("id:" + user.getId() + " name:" + user.getName() + " age:" + user.getAge() + " desc:" + user.getDesc()); } }); }</code></pre> <p>这篇文章到这了,遗憾的是Realm在Windows中没有相关的查看器,只有Mac版的,所以不能直接在Windows中查看Realm数据库中的数据,希望官方后面会有支持吧。更多的资料请查看官方文档。</p> <p> </p> <p> </p> <p>来自:http://www.jianshu.com/p/8cb639a78975</p> <p> </p>
本文由用户 tbc 自行上传分享,仅供网友学习交流。所有权归原作者,若您的权利被侵害,请联系管理员。
转载本站原创文章,请注明出处,并保留原始链接、图片水印。
本站是一个以用户分享为主的开源技术平台,欢迎各类分享!