realm学习

2017-02-09 本文已影响0人誰許誰天荒

为什么用realm

android开发不仅仅是从网上获取数据并且展示,有时候我们需要把数据保存到我们本地,一般我们会想到用file,sp或者数据库sqlite,file的方式主要是IO流操作,sp是其实是使用xml的方式以键值对形式存储基本数据类型的数据。但是对于app中有复杂筛选查询的操作，file和sp都不能满足了.虽然sqlite可以满足有大量复杂查询要求的缓存数据操作。但是sqlite的使用略复杂，代码量很大.这时候就需要一种轻量级的数据库.Realm是一个可以替代SQLite以及ORM Libraries的轻量级数据库。

realm的优势

相比SQLite，Realm更快并且具有很多现代数据库的特性，比如除了基本数据类型之外,还支持JSON.流式api，数据变更通知，以及加密支持
realm是一个跨平台移动数据库引擎，支持iOS、OS X（Objective-C和Swift）以及Android。这些都为移动端开发者带来了方便。
性能比较高
使用简单

使用方法

1.在项目的build.grade中配置

apply plugin: 'realm-android'
buildscript {
    repositories {
        jcenter()
        maven { url 'https://jitpack.io' }
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:1.0.0"
    }
}

2.初始化Realm,并进行相关配置.(Realm是框架的核心所在，是我们构建数据库的访问点,使用建造者模式构建对象。)

默认配置,

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);//初始化realm
    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);
  }
}

3.创建实体RealmObject(这是我们自定义的realm数据模型。创建数据模型的行为将会影响到数据库的结构。要创建一个数据模型，我们只需要继承RealmObject，然后设计我们想要存储的属性即可。)

public class Dog extends RealmObject {
private String name;
private int age;

@PrimaryKey
private String 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;
}

public String getId() {
    return id;
}

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

4.增

a.使用事务操作,新建一个对象,并且进行存储
Realm realm=Realm.getDefaultInstance();

realm.beginTransaction();//开启一个事务
User user = realm.createObject(User.class); //创建一个对象
user.setName("John");
user.setEmail("john@corporation.com");
realm.commitTransaction();//提交事务

b.使用事务块
Realm mRealm=Realm.getDefaultInstance();

final User user = new User("John");//创建对象
user.setEmail("john@corporation.com");

mRealm.executeTransaction(new Realm.Transaction() {//事务块
            @Override
            public void execute(Realm realm) {
            
            realm.copyToRealm(user);
               
            }
        });

5.删. (RealmResults：这个类是执行任何查询请求后所返回的类，其中包含了一系列的Object对象。和List类似，我们可以用下标语法来对其进行访问，并且还可以决定它们之间的关系。不仅如此，它还拥有许多更强大的功能，包括排序、查找等等操作。
)

Realm  mRealm=Realm.getDefaultInstance();

final RealmResults<Dog> dogs=  mRealm.where(Dog.class).findAll();

    mRealm.executeTransaction(new Realm.Transaction() {
        @Override
        public void execute(Realm realm) {
        
            Dog dog=dogs.get(5);
            dog.deleteFromRealm();
            //删除第一个数据
            dogs.deleteFirstFromRealm();
            //删除最后一个数据
            dogs.deleteLastFromRealm();
            //删除位置为1的数据
            dogs.deleteFromRealm(1);
            //删除所有数据
            dogs.deleteAllFromRealm();
        }
    });

上面的代码是用事务块进行删除,跟增加操作一样,也可以用事务beginTransaction和commitTransaction方法进行删除

6.改

RealmObject是自动更新的，比如你将一个数据读取出来后，又做了修改，修改会马上在数据中生效，不需要你再
将数据保存到数据库

Realm  mRealm=Realm.getDefaultInstance();

Dog dog = mRealm.where(Dog.class).equalTo("id", id).findFirst();
mRealm.beginTransaction();
dog.setName(newName);
mRealm.commitTransaction();

也可以用事务块来进行修改

7.查

a.查询全部

 public List<Dog> queryAllDog() {
        Realm  mRealm=Realm.getDefaultInstance();
    
        RealmResults<Dog> dogs = mRealm.where(Dog.class).findAll();
        
        return mRealm.copyFromRealm(dogs);
    }

b.条件查询

  public Dog queryDogById(String id) {
    Realm  mRealm=Realm.getDefaultInstance();

    Dog dog = mRealm.where(Dog.class).equalTo("id", id).findFirst();
    return dog;
}

还有其他的条件:

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

8.使用realm来操作数据库，尽管这些操作很快，但是还是建议放在后台进行。可以在回调中更新ui

realm.executeTransactionAsync(new Realm.Transaction() {  
        @Override  
        public void execute(Realm bgRealm) {  
            User user = bgRealm.createObject(User.class);  
            user.setName("John");  
            user.setEmail("john@corporation.com");  
        }  
    }, new Realm.Transaction.OnSuccess() {  
        @Override  
        public void onSuccess() {  
            // Transaction was a success.  
        }  
    }, new Realm.Transaction.OnError() {  
        @Override  
        public void onError(Throwable error) {  
            // Transaction failed and was automatically canceled.  
        }  
    });

最后,我们要及时关闭realm任务，避免程序crash

public void onDestroy () {  
if (transaction != null && !transaction.isCancelled()) {  
    transaction.cancel();  
}  
}

Realm的一些坑

1.查询到的结果数据不能跨线程使用.例如在主线程中查到的结果在线程中想使用需要在子线程中再查一次

2.realm对象不能跨线程使用.主线程中获取的realm对象, 不能在子线程中使用.需要重新调用getDefaultInstance()在子线程中获取另一个realm对象

3.当query到的数据要被使用时, realm数据库是要在开启的状态下的, 这样数据才能通过数据库链接访问到.在数据使用完毕后需要把数据库关闭.一般选在在页面onDestory()的方法中调用realm.close()方法关闭数据库链接.但如果网络请求数据的回调在页面关闭之后发生也就是realm.close()调用了之后又使用了同一个realm数据库链接查询数据
此时回报错误This Realm instance has already been closed, making it unusable.
解决办法是
如果还想使用同一个realm链接
先判断realm.isClosed()
数据库链接是否关闭了如果关闭了重新打开一个新的数据库链接使用完之后再将新的数据库链接关闭

4.如果想在Realm.close()之后继续操作查询得到的对象，只能复制一份数据传出来.

5.如果直接修改或删除query得到的数据，必须在transaction中完成.

realm学习

为什么用realm

realm的优势

使用方法

Realm的一些坑

猜你喜欢

热点阅读