我相信，在平時(shí)的開(kāi)發(fā)過(guò)程中，大家一定會(huì)或多或少地接觸到 SQLite。然而在使用它時(shí)，我們往往需要做許多額外的工作，像編寫(xiě) SQL 語(yǔ)句與解析查詢結(jié)果等。所以，適用于Android 的ORM 框架也就孕育而生了，現(xiàn)在市面上主流的框架有 OrmLite、SugarORM、Active Android、Realm 與 GreenDAO。而今天的主角便是 greenDAO，下面，我將詳解地介紹如何在 Android Studio 上使用 greenDAO，并結(jié)合代碼總結(jié)一些使用過(guò)程中的心得。
簡(jiǎn)單的講，greenDAO 是一個(gè)將對(duì)象映射到 SQLite 數(shù)據(jù)庫(kù)中的輕量且快速的 ORM 解決方案。（greenDAO is a light & fast ORM solution that maps objects to SQLite databases.） 而關(guān)于 ORM （Object Relation Mapping - 對(duì)象關(guān)系映射）的概念，可參見(jiàn) Wikipedia。
一個(gè)精簡(jiǎn)的庫(kù)
性能最大化
內(nèi)存開(kāi)銷最小化
易于使用的 APIs
對(duì) Android 進(jìn)行高度優(yōu)化
greenDAO 性能遠(yuǎn)遠(yuǎn)高于同類的 ORMLite，具體測(cè)試結(jié)果可見(jiàn)官網(wǎng)
greenDAO 支持 PRotocol buffer(protobuf) 協(xié)議數(shù)據(jù)的直接存儲(chǔ)，如果你通過(guò) protobuf 協(xié)議與服務(wù)器交互，將不需要任何的映射。
與 ORMLite 等使用注解方式的 ORM 框架不同，greenDAO 使用「Code generation」的方式，這也是其性能能大幅提升的原因。
這是其核心概念：為了在我們的 Android 工程中使用 greenDAO ，我們需要另建一個(gè)純 java Project，用于自動(dòng)生成后繼 Android 工程中需要使用到的 Bean、DAO、DaoMaster、Daosession 等類。
關(guān)于以上幾個(gè)類的相關(guān)概念與作用，我將在下面的代碼（注釋）中詳細(xì)講解。當(dāng)然，你也可以在 官網(wǎng) 中找到相關(guān)介紹。
在 .src/main 目錄下新建一個(gè)與 java 同層級(jí)的「java-gen」目錄，用于存放由 greenDAO 生成的 Bean、DAO、DaoMaster、DaoSession 等類。 
配置 Android 工程（app）的 build.gradle，如圖分別添加 sourceSets 與dependencies。 
通過(guò) File -> New -> New Module -> Java Library -> 填寫(xiě)相應(yīng)的包名與類名 -> Finish.
配置 daoexamplegenerator 工程的 build.gradle，添加 dependencies.
編寫(xiě) ExampleDaoGenerator 類，注意： 我們的 Java 工程只有一個(gè)類，它的內(nèi)容決定了「GreenDao Generator」的輸出，你可以在這個(gè)類中通過(guò)對(duì)象、關(guān)系等創(chuàng)建數(shù)據(jù)庫(kù)結(jié)構(gòu)，下面我將以注釋的形式詳細(xì)講解代碼內(nèi)容。
[js] view plain copy public class ExampleDaoGenerator { public static void main(String[] args) throws Exception { // 正如你所見(jiàn)的，你創(chuàng)建了一個(gè)用于添加實(shí)體（Entity）的模式（Schema）對(duì)象。 // 兩個(gè)參數(shù)分別代表：數(shù)據(jù)庫(kù)版本號(hào)與自動(dòng)生成代碼的包路徑。 Schema schema = new Schema(1, "me.itangqi.greendao"); // 當(dāng)然，如果你愿意，你也可以分別指定生成的 Bean 與 DAO 類所在的目錄，只要如下所示： // Schema schema = new Schema(1, "me.itangqi.bean"); // schema.setDefaultJavaPackageDao("me.itangqi.dao"); // 模式（Schema）同時(shí)也擁有兩個(gè)默認(rèn)的 flags，分別用來(lái)標(biāo)示 entity 是否是 activie 以及是否使用 keep sections。 // schema2.enableActiveEntitiesByDefault(); // schema2.enableKeepSectionsByDefault(); // 一旦你擁有了一個(gè) Schema 對(duì)象后，你便可以使用它添加實(shí)體（Entities）了。 addNote(schema); // 最后我們將使用 DAOGenerator 類的 generateAll() 方法自動(dòng)生成代碼，此處你需要根據(jù)自己的情況更改輸出目錄（既之前創(chuàng)建的 java-gen)。 // 其實(shí)，輸出目錄的路徑可以在 build.gradle 中設(shè)置，有興趣的朋友可以自行搜索，這里就不再詳解。 new DaoGenerator().generateAll(schema, "/Users/tangqi/android-dev/AndroidStudioProjects/MyGreenDAO/app/src/main/java-gen"); } /** * @param schema */ private static void addNote(Schema schema) { // 一個(gè)實(shí)體（類）就關(guān)聯(lián)到數(shù)據(jù)庫(kù)中的一張表，此處表名為「Note」（既類名） Entity note = schema.addEntity("Note"); // 你也可以重新給表命名 // note.setTableName("NODE"); // greenDAO 會(huì)自動(dòng)根據(jù)實(shí)體類的屬性值來(lái)創(chuàng)建表字段，并賦予默認(rèn)值 // 接下來(lái)你便可以設(shè)置表中的字段： note.addIdProperty(); note.addStringProperty("text").notNull(); // 與在 Java 中使用駝峰命名法不同，默認(rèn)數(shù)據(jù)庫(kù)中的命名是使用大寫(xiě)和下劃線來(lái)分割單詞的。 // For example, a property called “creationDate” will become a database column “CREATION_DATE”. note.addStringProperty("comment"); note.addDateProperty("date"); } }執(zhí)行 generator 工程，如一切正常，你將會(huì)在控制臺(tái)看到如下日志，并且在主工程「java-gen」下會(huì)發(fā)現(xiàn)生成了DaoMaster、DaoSession、NoteDao、Note共4個(gè)類文件。 
如果在此處出錯(cuò)，你可以依據(jù)錯(cuò)誤日志進(jìn)行排查，主要看是否輸出目錄存在？其他配置是否正確？等
這里，我們只創(chuàng)建一個(gè) NodeActivity 類，用于測(cè)試與講解 greenDAO 的增、刪、查功能。
activity_note.xml
[js] view plain copy <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical"> <LinearLayout android:id="@+id/linearLayout1" android:layout_width="fill_parent" android:layout_height="wrap_content" android:orientation="horizontal"> <EditText android:id="@+id/editTextNote" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_weight="1" android:hint="Enter new note" android:inputType="text"></EditText> <Button android:id="@+id/buttonAdd" android:layout_width="wrap_content" android:layout_height="wrap_content" android:onClick="onMyButtonClick" android:text="Add"></Button> <Button android:id="@+id/buttonSearch" android:layout_width="wrap_content" android:layout_height="wrap_content" android:onClick="onMyButtonClick" android:text="Search"></Button> </LinearLayout> <ListView android:id="@android:id/list" android:layout_width="fill_parent" android:layout_height="wrap_content"></ListView> </LinearLayout>NoteActivity.java
[js] view plain copy public class NoteActivity extends ListActivity { private SQLiteDatabase db; private EditText editText; private DaoMaster daoMaster; private DaoSession daoSession; private Cursor cursor; public static final String TAG = "DaoExample"; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_note); // 官方推薦將獲取 DaoMaster 對(duì)象的方法放到 application 層，這樣將避免多次創(chuàng)建生成 Session 對(duì)象 setupDatabase(); // 獲取 NoteDao 對(duì)象 getNoteDao(); String textColumn = NoteDao.Properties.Text.columnName; String orderBy = textColumn + " COLLATE LOCALIZED ASC"; cursor = db.query(getNoteDao().getTablename(), getNoteDao().getAllColumns(), null, null, null, null, orderBy); String[] from = {textColumn, NoteDao.Properties.Comment.columnName}; int[] to = {android.R.id.text1, android.R.id.text2}; SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, cursor, from, to); setListAdapter(adapter); editText = (EditText) findViewById(R.id.editTextNote); } private void setupDatabase() { // 通過(guò) DaoMaster 的內(nèi)部類 DevOpenHelper，你可以得到一個(gè)便利的 SQLiteOpenHelper 對(duì)象。 // 可能你已經(jīng)注意到了，你并不需要去編寫(xiě)「CREATE TABLE」這樣的 SQL 語(yǔ)句，因?yàn)?nbsp;greenDAO 已經(jīng)幫你做了。 // 注意：默認(rèn)的 DaoMaster.DevOpenHelper 會(huì)在數(shù)據(jù)庫(kù)升級(jí)時(shí)，刪除所有的表，意味著這將導(dǎo)致數(shù)據(jù)的丟失。 // 所以，在正式的項(xiàng)目中，你還應(yīng)該做一層封裝，來(lái)實(shí)現(xiàn)數(shù)據(jù)庫(kù)的安全升級(jí)。 DaoMaster.DevOpenHelper helper = new DaoMaster.DevOpenHelper(this, "notes-db", null); db = helper.getWritableDatabase(); // 注意：該數(shù)據(jù)庫(kù)連接屬于 DaoMaster，所以多個(gè) Session 指的是相同的數(shù)據(jù)庫(kù)連接。 daoMaster = new DaoMaster(db); daoSession = daoMaster.newSession(); } private NoteDao getNoteDao() { return daoSession.getNoteDao(); } /** * Button 點(diǎn)擊的監(jiān)聽(tīng)事件 * * @param view */ public void onMyButtonClick(View view) { switch (view.getId()) { case R.id.buttonAdd: addNote(); break; case R.id.buttonSearch: search(); break; default: Log.d(TAG, "what has gone wrong ?"); break; } } private void addNote() { String noteText = editText.getText().toString(); editText.setText(""); final DateFormat df = DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM); String comment = "Added on " + df.format(new Date()); // 插入操作，簡(jiǎn)單到只要你創(chuàng)建一個(gè) Java 對(duì)象 Note note = new Note(null, noteText, comment, new Date()); getNoteDao().insert(note); Log.d(TAG, "Inserted new note, ID: " + note.getId()); cursor.requery(); } private void search() { // Query 類代表了一個(gè)可以被重復(fù)執(zhí)行的查詢 Query query = getNoteDao().queryBuilder() .where(NoteDao.Properties.Text.eq("Test1")) .orderAsc(NoteDao.Properties.Date) .build(); // 查詢結(jié)果以 List 返回 // List notes = query.list(); // 在 QueryBuilder 類中內(nèi)置兩個(gè) Flag 用于方便輸出執(zhí)行的 SQL 語(yǔ)句與傳遞參數(shù)的值 QueryBuilder.LOG_SQL = true; QueryBuilder.LOG_VALUES = true; } /** * ListView 的監(jiān)聽(tīng)事件，用于刪除一個(gè) Item * @param l * @param v * @param position * @param id */ @Override protected void onListItemClick(ListView l, View v, int position, long id) { // 刪除操作，你可以通過(guò)「id」也可以一次性刪除所有 getNoteDao().deleteByKey(id); // getNoteDao().deleteAll(); Log.d(TAG, "Deleted note, ID: " + id); cursor.requery(); } }一切就緒，讓我們看看效果吧！運(yùn)行程序，分別執(zhí)行添加按鈕、刪除（點(diǎn)擊 List 的 Item）與查詢按鈕，可以在控制臺(tái)得到如下日志：
本文的 Demo 下載鏈接：https://github.com/tangqi92/MyGreenDAO
本教程旨在介紹 greenDAO 的基本用法與配置，更高級(jí)與詳細(xì)的使用，請(qǐng)參見(jiàn) 官網(wǎng)
如本文有任何錯(cuò)誤與遺漏，歡迎指正。同時(shí)我期待與大家成為朋友，所以歡迎在社交網(wǎng)絡(luò)上互粉！！！
http://greendao-orm.com/ https://github.com/greenrobot/greenDAOhttp://stackoverflow.com/questions/tagged/greendaohttps://groups.google.com/forum/#!forum/greendao
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注
