Realm之一步上位(基于本地Realm数据库的Android图书馆管理系统)

前言
Realm数据库是基于C++编写的一个不同于SQLite数据库的数据库引擎,是一个可以替代SQLite以及ORMlibraries的移动端数据库。相比SQLite/ORMlibraries,Realm更轻量级,更快,并且具有很多现代数据库的特性,支持JSON,流式api,数据变更通知,以及加密支持,这给android开发者提供了不少帮助。使用起来更是通俗易懂,简单快捷。目前Realm最新版本是2.x,支持Java,Objective C,Swift,React-Native,tamarin五种编程方式,而下文所讲内容都是基于Realm2.x。通过介绍和使用本案例,学习和了解Realm的基本用法。

更多详细介绍请参见官网 :https://realm.io/

基本使用
▲配置与导入
在项目Project的build.gradle文件中添加依赖:


在app的build文件加上:

在Application 中初始化,不配置也可以,就是默认

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Realm.init(this);
        //默认配置
        //RealmConfiguration configuration=new RealmConfiguration.Builder().build();
        //自定义配置
        RealmConfiguration configuration = new RealmConfiguration.Builder()
                .name("donkor.realm")
                .deleteRealmIfMigrationNeeded()
                .build();
        Realm.setDefaultConfiguration(configuration);
    }

同时需要在AndroidManifest.xml中配置


▲案例介绍
图书馆管理系统,其实说白了就是数据库的增删改查,本案例中的增删改查只针对本地Realm的数据库。Realm提供给我们的增删改查操作足够快,在UI线程中执行操作就行。但是如果遇到较复杂的增删改查,或操作的数据较多时,就可以子线程进行操作,使用异步进行增删改查。案例分为两个模块,一个为学生管理,和图书管理,而图书管理则使用异步进行增删改查。

▲创建实体类

  • 学生实体:有相应的用户名,密码,姓名,多本收藏的图书
  • 图书实体:有相应的书名,作者,出版社

创建Student类继承RealmObject

public class Student extends RealmObject {
    //用来标示主键
    @PrimaryKey
    private String name;
    private long password;
    private String nickname;
    //一对多的关系
    private RealmList<Book> books;

    public RealmList<Book> getBooks() {
        return books;
    }

    public void setBooks(RealmList<Book> books) {
        this.books = books;
    }

    public String getName() {
        return name;
    }

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

    public long getPassword() {
        return password;
    }

    public void setPassword(long password) {
        this.password = password;
    }

    public String getNickname() {
        return nickname;
    }

    public void setNickname(String nickname) {
        this.nickname = nickname;
    }
}

创建Book类继承RealmObject

public class Book extends RealmObject {
    private String name;
    private String author;
    private String publishing;

    public String getName() {
        return name;
    }

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

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    public String getPublishing() {
        return publishing;
    }

    public void setPublishing(String publishing) {
        this.publishing = publishing;
    }
}

※ 注: 同时必须知道的注解说明
@PrimaryKey

  • 字段必须是String、 integer、byte、short、 int、long 以及它们的封装类Byte, Short, Integer, and Long
  • 使用了该注解之后可以使用copyToRealmOrUpdate()方法,通过主键查询它的对象,如果查询到了,则更新它,否则新建一个对象来代替。
  • 使用了该注解将默认设置(@index)注解
  • 使用了该注解之后,创建和更新数据将会慢一点,查询数据会快一点。

@Required

  • 数据不能为null

@Ignore

  • 忽略,即该字段不被存储到本地

@Index

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

▲学生管理CRUD
一、增(添加学生)
可以使用事务操作或使用事务块,两种方法对数据库进行增加操作,同理,以下删,改操作同样可以使用以上两种方法。而增添学生可以使用以下三种方式
1.新建一个对象,并进行存储

Realm realm = Realm.getDefaultInstance();

realm.beginTransaction();
Student student = realm.createObject(Student.class);

student.setName("donkor");
student.setPassword(123456);
student.setNickname("aaa");
realm.commitTransaction();

2.复制一个对象到Realm数据库

Realm realm = Realm.getDefaultInstance();

realm.beginTransaction();
Student student=new Student();

student.setName("donkor");
student.setPassword(123456);
student.setNickname("aaa");
realm.copyToRealm(student);
realm.commitTransaction();

3.使用事务块

Realm realm = Realm.getDefaultInstance();

final Student student = new Student();
student.setName("donkor");
student.setPassword(123456);
student.setNickname("aaa");
realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        realm.copyToRealm(student);
}
});

而为学生添加多本图书则可以使用以下两种方式

//数据库添加一本新书,同时为该同学添加该书
Book book = new Book();
book.setName("第一行代码");
book.setAuthor("路人甲");
book.setPublishing("图灵");
student.getBooks().add(book);

或者

//从数据库中找到某一本书,添加给该同学
Book b=realm.where(Book.class).equalTo("name","第一行代码").findFirst();
student.getBooks().add(b);

二、删(删除学生)
方法一使用事务操作

Realm realm = Realm.getDefaultInstance();

realm.beginTransaction();
Student student = realm.where(Student.class).equalTo("name", "donkor").findFirst();
//指定student从数据库中删除
student.deleteFromRealm();
realm.commitTransaction();

方法二使用事务块

final Realm realm = Realm.getDefaultInstance();

realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        Student student=realm.where(Student.class).equalTo("name","donkor").findFirst();
        //指定student从数据库中删除
        student.deleteFromRealm();
}
});

※ 注:除了删除指定某项数据时,还提供以下方法进行删除数据库操作

RealmResults<Student> rrStudents = realm.where(Student.class).findAll();

//删除第一个Student数据
rrStudents.deleteFirstFromRealm();
                
//删除最后一个Student数据
rrStudents.deleteLastFromRealm();
        
//删除位置为1的Student数据
//坐标从0开始,0为第一项数据,1为第二项
rrStudents.deleteFromRealm(1);
    
//删除所有Student数据
rrStudents.deleteAllFromRealm();

三、改(修改学生)
方法一使用事务操作

Realm realm = Realm.getDefaultInstance();

Student student = realm.where(Student.class).equalTo("name", "donkor").findFirst();
realm.beginTransaction();
student.setName("newDonkor");
student.setPassword(132654);
student.setNickname("bbb");
realm.commitTransaction();

方法二使用事务块

Realm realm = Realm.getDefaultInstance();

final Student student = realm.where(Student.class).equalTo("name", "donkor").findFirst();
realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        student.setName("newDonkor");
        student.setPassword(132465);
        student.setNickname("bbb");
    }
});

四、查(查询学生)
查询全部

Realm realm = Realm.getDefaultInstance();

//查询全部学生
RealmResults<Student> students = realm.where(Student.class).findAll();

//realm.copyFromRealm(students)方法将它转为List<Student>
List<Student> studentList = realm.copyFromRealm(students);

条件查询

Realm realm = Realm.getDefaultInstance();

//根据name查找第一个student信息
Student student = realm.where(Student.class).equalTo("name", "donkor").findFirst();

※ 注: 常用的条件查询包括

  • between(), greaterThan(), lessThan(), greaterThanOrEqualTo() 与 lessThanOrEqualTo()
  • equalTo() 与 notEqualTo()
  • contains()、beginsWith() 与 endsWith()
  • isNull() 与 isNotNull()
  • isEmpty() 与 isNotEmpty()

※ 注: 同时不仅支持对查询结果的排序(默认为升序排序),还支持聚合查询,包括sum,min,max,average
▲图书管理CRUD
一、异步增(添加图书)

Realm realm = Realm.getDefaultInstance();

RealmAsyncTask addTask = realm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        Book book = new Book();
        book.setName("第一行代码");
        book.setAuthor("郭霖");
        book.setPublishing("图灵");
        realm.copyToRealm(book);
    }
}, new Realm.Transaction.OnSuccess() {
    @Override
    public void onSuccess() {
        Toast.makeText(AddBookActivity.this, "Add success", Toast.LENGTH_SHORT).show();
    }
}, new Realm.Transaction.OnError() {
    @Override
    public void onError(Throwable error) {
        Toast.makeText(AddBookActivity.this, "Add error", Toast.LENGTH_SHORT).show();
    }
});

二、异步删(删除图书)

Realm realm = Realm.getDefaultInstance();

RealmAsyncTask addTask = realm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        //删除指定图书
        Book book = realm.where(Book.class).equalTo("name", "donkor").findFirst();
        book.deleteFromRealm();
    }
}, new Realm.Transaction.OnSuccess() {
    @Override
    public void onSuccess() {
        Toast.makeText(AddBookActivity.this, "Delete success", Toast.LENGTH_SHORT).show();
    }
}, new Realm.Transaction.OnError() {
    @Override
    public void onError(Throwable error) {
        Toast.makeText(AddBookActivity.this, "Delete error", Toast.LENGTH_SHORT).show();
    }
});

三、异步改(修改图书)

Realm realm = Realm.getDefaultInstance();

RealmAsyncTask addTask = realm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        //删改指定图书
        Book book = realm.where(Book.class).equalTo("name", "donkor").findFirst();
        book.setName("第二行代码");
        book.setAuthor("郭霖");
        book.setPublishing("图灵");
    }
}, new Realm.Transaction.OnSuccess() {
    @Override
    public void onSuccess() {
        Toast.makeText(AddBookActivity.this, "Update success", Toast.LENGTH_SHORT).show();
    }
}, new Realm.Transaction.OnError() {
    @Override
    public void onError(Throwable error) {
        Toast.makeText(AddBookActivity.this, "Update error", Toast.LENGTH_SHORT).show();
    }
});

※ 注: 以上异步增删改操作在销毁Activity或Fragment时,都不要忘记了要取消掉异步任务

@Override
protected void onDestroy() {
    super.onDestroy();
    //取消异步操作
    if (addTask != null && !addTask.isCancelled()) {
        addTask.cancel();
    }
}

四、异步查(查询图书)

Realm realm = Realm.getDefaultInstance();

//查询全部图书
RealmResults<Book> books = realm.where(Book.class).findAllAsync();
books.addChangeListener(callback);
private RealmChangeListener callback = new RealmChangeListener() {
    @Override
    public void onChange(Object element) {
        List<Book> bookList = realm.copyFromRealm(books);
        BookAdapter bookAdapter = new BookAdapter(QueryBookActivity.this, bookList);
        lvBooks.setAdapter(bookAdapter);    
    }
};

RealmChangeListener 在退出程序的时候要注销监听

    @Override
    protected void onDestroy() {
        super.onDestroy();
        //注销指定的监听
        books.removeChangeListener(callback);
        //注销所有监听
        books.removeChangeListeners();
    }

最后看下我们实现了的功能和效果图

github下载地址https://github.com/ChenYXin/RealmDemo

关于我

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容