轉自http://www.jianshu.com/p/cd1684b58
【威哥說】realm是什麼？可能很多人都沒有聽說過，realm是一個跨平臺移動數據庫引擎，支持iOS、OS X（Objective-C和Swift）以及Android。專門針對移動平臺設計的數據庫。目標是取代SQLite，核心數據引擎C++打造，比單獨無封裝的SQLite還要快。這篇投稿詳細講解了realm的使用，分享給大家。
【正文】當我們的app有數據需要保存到本地緩存時，可以使用file，sharedpreferences，還有sqlite。sharedpreferences其實使用xml的方式，以鍵值對形式存儲基本數據類型的數據。對於有複雜篩選查詢的操作，file和sharedpreferences都不能滿足了。sqlite可以滿足有大量複雜查詢要求的緩存數據操作。但是sqlite的使用略複雜，代碼量很大，還好網上有很多優秀的orm框架可使用，比喻ORMlite，greenDao等。
ORMlite，greenDao這些框架都是在SQLite的基礎上封裝的ORM對象關係映射框架，簡化了代碼操作。而今天的主角：Realm是一個可以替代SQLite以及ORM Libraries的輕量級數據庫。相比SQLite，Realm更快並且具有很多現代數據庫的特性，比如支持JSON，流式api，數據變更通知，以及加密支持，這些都爲安卓開發者帶來了方便。不多介紹我們重點來說說Reaml的使用，看看到底爽在哪裏。
環境配置：
1、在Project的build.gradle文件中添加依賴：
dependencies {
…
classpath “io.realm:realm-gradle-plugin:1.1.0”
…
}
2、在app module的build.gradle文件的top添加下面代碼：
apply plugin: ‘com.android.application’
apply plugin: ‘realm-android’
….
配置完畢.
使用：
在整個使用的過程中，Realm是主角，我們先來看看Realm類中的一段翻譯：
/**
Realm類可以對你的持久化對象進行存儲和事務管理，可以用來創建RealmObjects實例。領域內的對象可以在任何時間查詢和讀取。
創建，修改和刪除等操作必須被包含在一個完整的事務裏面，後面的代碼會講到。
該事務確保多個實例（在多個線程）可以在一個一致的狀態和保證事務在ACID前提下，訪問相同的對象。
當一個Realm實例操作完成後，切記不要忘記調用close()方法。否則會導致本地資源無法釋放，引起OOM。
Realm實例不能在不同的線程間訪問操作。確切的說，你必須在每個要使用的線程上打開一個實例
每個線程都會使用引用計數來自動緩存Realm實例，所以只要引用計數不達到零，
調用getInstance(RealmConfiguration)方法將會返回緩存的Realm實例，應該算是一個輕量級的操作。
對於UI線程來說，打開和關閉Realm實例，應當放在onCreate/onDestroy或者onStart/onStop方法中
在不同的線程間，Realm實例使用Handler機制來調整他的狀態。也就是說，Realm實例在線程中，如果沒有Looper，是不能收到更新通知的，
除非手動調用waitForChange()方法
在安卓Activity領域工作的一個標準模式可以在下面看到
在Android Activity中，Realm的標準工作模式如下：
*
- public class RealmApplication extends Application {
*
\@Override
public void onCreate() {
super.onCreate();
*
// The Realm file will be located in package’s “files” directory.
RealmConfiguration realmConfig = new RealmConfiguration.Builder(this).build();
Realm.setDefaultConfiguration(realmConfig);
}
}
*
public class RealmActivity extends Activity {
private Realm realm;
\@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.layout_main);
realm = Realm.getDefaultInstance();
}
\@Override
protected void onDestroy() {
super.onDestroy();
realm.close();
}
}
*
Realm支持String和byte字段長度高達16MB
參考連接：
ACID
Examples using Realm
*
*/
部分源碼分析：
public final class Realm extends BaseRealm {
//默認的文件名，是啥？
public static final String DEFAULT_REALM_NAME = RealmConfiguration.DEFAULT_REALM_NAME;
//怎麼這麼熟悉呢？是RxJava？
@Override
@OptionalAPI(dependencies = {“rx.Observable”})
public Observable asObservable() {
return configuration.getRxFactory().from(this);
}
//下面這些方法，應該都能顧名思義吧
public void createAllFromJson(Class clazz, JSONArray json) {
}
public void createOrUpdateAllFromJson(Class clazz, JSONArray json) {
}
public E createOrUpdateObjectFromJson(Class clazz, JSONObject json) {
}
public E createObject(Class clazz) {
}
public E copyToRealmOrUpdate(E object) {
}
public void executeTransaction(Transaction transaction) {
}
public void delete(Class clazz) {
}
}
RealmConfiguration類的說明翻譯：
/**
一個RealmConfiguration對象，可用來設置特定的Realm實例
RealmConfiguration實例只能通過io.realm.RealmConfiguration.Builder類的build()方法來創建
想使用默認的RealmConfiguration實例，請使用io.realm.Realm#getDefaultInstance()方法。
如果想使用自己配置RealmConfiguration實例的Realm實例，需要調用Realm#setDefaultConfiguration(RealmConfiguration)
*
*
可以用下面代碼創建一個最簡單配置的實例:
RealmConfiguration config = new RealmConfiguration.Builder(getContext()).build())
這樣創建的實例，具有一下屬性：
*
*
*
Realm的默認文件名是”default.realm”
*
“default.realm”文件保存在”Context.getFilesDir()”目錄中
*
它的schema版本號設置爲0
*
*/
部分源碼分析：
public final class RealmConfiguration {
//默認文件名
public static final String DEFAULT_REALM_NAME = “default.realm”;
//Rx工廠
private final RxObservableFactory rxObservableFactory;
//弱引用
private final WeakReference contextWeakRef;
/**
從Asset目錄中返回Realm文件名，還可以保存在Asset中？
@return input stream to the asset file.
@throws IOException if copying the file fails.
*/
InputStream getAssetFile() throws IOException {
Context context = contextWeakRef.get();
if (context != null) {
return context.getAssets().open(assetFilePath);
} else {
}
}
/**
使用app自己內置硬盤目錄來存儲Realm file。不需要任何擴展訪問權限。
默認目錄爲：/data/data//files，這個路徑能否修改取決於供應商的具體實現
*
- @param 參數context請使用application的context.
*/
public Builder(Context context) {
if (context == null) {
throw new IllegalArgumentException(“A non-null Context must be provided”);
}
RealmCore.loadLibrary(context);
initializeBuilder(context.getFilesDir());
}
｝
通過上面的翻譯說明和源碼分析，應該幾乎明白了Realm的原理和基本使用了吧。總結下面幾點：
1、Realm保存的結果其實是在一個文件裏面，默認的文件名是”default.realm”，在”Context.getFilesDir()”目錄中，即：/data/data//files/default.realm。意思是，當你在應用管理裏面給當前app”清除數據”，realm數據庫的數據會丟失。故我們需要把默認的數據文件放到asset目錄中，當數據庫初始化時再copy到”Context.getFilesDir()”下。
2、在創建RealmConfiguration對象時，可以通過.assetFile(this,”realm file path in assets”)方法指定初始化的數據庫文件。Realm會把制定路徑下的xxx.realm文件copy到Context.getFilesDir()目錄中，以替換默認創建的空數據庫文件。
3、可以設置默認文件名，通過RealmConfiguration類進行配置。路徑似乎改不了，需要看具體設備供應商的實現。
4、Realm的實例需要在每次的具體操作中獲取，可以看成是一個數據操作的sessin，用完後必須close關閉。打開和關閉Realm實例，應當放在onCreate/onDestroy或者onStart/onStop方法中。
5、Realm中似乎有RxJava的影子，支持鏈式異步任務？
6、Realm中有個各種增刪改差的方法，還可以根據JSON的數據實例化一個RealmObject子類java bean。
7、重點：切記，Realm數據庫的主鍵字段不是自動增長的，需要自己設置，做添加的時候如果不給id字段值，默認會爲0。後面再添加會報錯，說id爲0的數據已經存在。尤其是批量添加的時候要注意，當心出現只添加了一條記錄的悲劇。
8、數據自動更新。mRealm.addChangeListener(this);//當數據庫的數據有變化時，系統回調此方法。
經過上面的分析和總結，其實已經很明瞭了。爲了那些伸手主義者，還是簡單擼些代碼吧。還有些需要注意的地方，在代碼中講解。
本文出自微信公衆號mjw-java，更多內容微信公衆號或訪問www.moliying.com
文／磨礪營IT（簡書作者）
原文鏈接：http://www.jianshu.com/p/cd1684b58035
著作權歸作者所有，轉載請聯繫作者獲得授權，並標註“簡書作者”。
官方文檔
