為什么用realm
android開(kāi)發(fā)不僅僅是從網(wǎng)上獲取數(shù)據(jù)并且展示,有時(shí)候我們需要把數(shù)據(jù)保存到我們本地,一般我們會(huì)想到用file,sp或者數(shù)據(jù)庫(kù)sqlite,file的方式主要是IO流操作,sp是其實(shí)是使用xml的方式以鍵值對(duì)形式存儲(chǔ)基本數(shù)據(jù)類型的數(shù)據(jù)务蝠。但是對(duì)于app中有復(fù)雜篩選查詢的操作绿语，file和sp都不能滿足了.雖然sqlite可以滿足有大量復(fù)雜查詢要求的緩存數(shù)據(jù)操作赤拒。但是sqlite的使用略復(fù)雜穿铆，代碼量很大.這時(shí)候就需要一種輕量級(jí)的數(shù)據(jù)庫(kù).Realm是一個(gè)可以替代SQLite以及ORM Libraries的輕量級(jí)數(shù)據(jù)庫(kù)侥衬。
realm的優(yōu)勢(shì)
- 相比SQLite吊骤，Realm更快并且具有很多現(xiàn)代數(shù)據(jù)庫(kù)的特性捧存，比如除了基本數(shù)據(jù)類型之外,還支持JSON.流式api捷绒，數(shù)據(jù)變更通知，以及加密支持
- realm是一個(gè)跨平臺(tái)移動(dòng)數(shù)據(jù)庫(kù)引擎捉貌，支持iOS支鸡、OS X（Objective-C和Swift）以及Android。這些都為移動(dòng)端開(kāi)發(fā)者帶來(lái)了方便趁窃。
- 性能比較高
- 使用簡(jiǎn)單
使用方法
1.在項(xiàng)目的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,并進(jìn)行相關(guān)配置.(Realm是框架的核心所在牧挣，是我們構(gòu)建數(shù)據(jù)庫(kù)的訪問(wèn)點(diǎn),使用建造者模式構(gòu)建對(duì)象。)
默認(rèn)配置,
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();//默認(rèn)配置
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.創(chuàng)建實(shí)體RealmObject(這是我們自定義的realm數(shù)據(jù)模型棚菊。創(chuàng)建數(shù)據(jù)模型的行為將會(huì)影響到數(shù)據(jù)庫(kù)的結(jié)構(gòu)浸踩。要?jiǎng)?chuàng)建一個(gè)數(shù)據(jù)模型，我們只需要繼承RealmObject统求，然后設(shè)計(jì)我們想要存儲(chǔ)的屬性即可检碗。)
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.使用事務(wù)操作,新建一個(gè)對(duì)象,并且進(jìn)行存儲(chǔ)
Realm realm=Realm.getDefaultInstance();
realm.beginTransaction();//開(kāi)啟一個(gè)事務(wù)
User user = realm.createObject(User.class); //創(chuàng)建一個(gè)對(duì)象
user.setName("John");
user.setEmail("john@corporation.com");
realm.commitTransaction();//提交事務(wù)
b.使用事務(wù)塊
Realm mRealm=Realm.getDefaultInstance();
final User user = new User("John");//創(chuàng)建對(duì)象
user.setEmail("john@corporation.com");
mRealm.executeTransaction(new Realm.Transaction() {//事務(wù)塊
@Override
public void execute(Realm realm) {
realm.copyToRealm(user);
}
});
5.刪. (RealmResults：這個(gè)類是執(zhí)行任何查詢請(qǐng)求后所返回的類，其中包含了一系列的Object對(duì)象码邻。和List類似折剃，我們可以用下標(biāo)語(yǔ)法來(lái)對(duì)其進(jìn)行訪問(wèn)，并且還可以決定它們之間的關(guān)系像屋。不僅如此怕犁，它還擁有許多更強(qiáng)大的功能，包括排序己莺、查找等等操作奏甫。
)
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();
//刪除第一個(gè)數(shù)據(jù)
dogs.deleteFirstFromRealm();
//刪除最后一個(gè)數(shù)據(jù)
dogs.deleteLastFromRealm();
//刪除位置為1的數(shù)據(jù)
dogs.deleteFromRealm(1);
//刪除所有數(shù)據(jù)
dogs.deleteAllFromRealm();
}
});
上面的代碼是用事務(wù)塊進(jìn)行刪除,跟增加操作一樣,也可以用事務(wù)beginTransaction和commitTransaction方法進(jìn)行刪除
6.改
RealmObject是自動(dòng)更新的，比如你將一個(gè)數(shù)據(jù)讀取出來(lái)后凌受，又做了修改阵子，修改會(huì)馬上在數(shù)據(jù)中生效，不需要你再
將數(shù)據(jù)保存到數(shù)據(jù)庫(kù)
Realm mRealm=Realm.getDefaultInstance();
Dog dog = mRealm.where(Dog.class).equalTo("id", id).findFirst();
mRealm.beginTransaction();
dog.setName(newName);
mRealm.commitTransaction();
也可以用事務(wù)塊來(lái)進(jìn)行修改
7.查
a.查詢?nèi)?/p>
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來(lái)操作數(shù)據(jù)庫(kù)胜蛉，盡管這些操作很快挠进，但是還是建議放在后臺(tái)進(jìn)行色乾。可以在回調(diào)中更新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.
}
});
最后,我們要及時(shí)關(guān)閉realm任務(wù)领突，避免程序crash
public void onDestroy () {
if (transaction != null && !transaction.isCancelled()) {
transaction.cancel();
}
}
Realm的一些坑
1.查詢到的結(jié)果數(shù)據(jù) 不能跨線程使用.例如在主線程中查到的結(jié)果 在線程中想使用 需要在子線程中再查一次
2.realm對(duì)象不能跨線程使用.主線程中獲取的realm對(duì)象, 不能在子線程中使用.需要重新調(diào)用getDefaultInstance()在子線程中獲取另一個(gè)realm對(duì)象
3.當(dāng)query到的數(shù)據(jù)要被使用時(shí), realm數(shù)據(jù)庫(kù)是要在開(kāi)啟的狀態(tài)下的, 這樣數(shù)據(jù)才能通過(guò)數(shù)據(jù)庫(kù)鏈接訪問(wèn)到.在數(shù)據(jù)使用完畢后 需要把數(shù)據(jù)庫(kù)關(guān)閉.一般選在在頁(yè)面onDestory()的方法中 調(diào)用realm.close()方法關(guān)閉數(shù)據(jù)庫(kù)鏈接.但如果網(wǎng)絡(luò)請(qǐng)求數(shù)據(jù)的回調(diào)在頁(yè)面關(guān)閉之后發(fā)生 也就是realm.close()調(diào)用了之后 又使用了同一個(gè)realm數(shù)據(jù)庫(kù)鏈接查詢數(shù)據(jù)
此時(shí)回報(bào)錯(cuò)誤This Realm instance has already been closed, making it unusable.
解決辦法是
如果還想使用同一個(gè)realm鏈接
先判斷realm.isClosed()
數(shù)據(jù)庫(kù)鏈接是否關(guān)閉了 如果關(guān)閉了重新打開(kāi)一個(gè)新的數(shù)據(jù)庫(kù)鏈接 使用完之后再將新的數(shù)據(jù)庫(kù)鏈接關(guān)閉
4.如果想在Realm.close()之后繼續(xù)操作查詢得到的對(duì)象暖璧，只能復(fù)制一份數(shù)據(jù)傳出來(lái).
5.如果直接修改或刪除query得到的數(shù)據(jù)，必須在transaction中完成.
