GreenDAO

https://github.com/greenrobot/greenDAO

前言

我相信，在平时的开发过程中，大家一定会或多或少地接触到 SQLite。然而在使用它时，我们往往需要做许多额外的工作，像编写 SQL 语句与解析查询结果等。所以，适用于 Android 的ORM 框架也就孕育而生了，现在市面上主流的框架有 OrmLite、SugarORM、Active Android、Realm 与 GreenDAO。而今天的主角便是 greenDAO，下面，我将详解地介绍如何在 Android Studio 上使用 greenDAO，并结合代码总结一些使用过程中的心得。

---

关于 greenDAO

简单的讲，greenDAO 是一个将对象映射到 SQLite 数据库中的轻量且快速的 ORM 解决方案。（greenDAO is a light & fast ORM solution that maps objects to SQLite databases.） 
而关于 ORM （Object Relation Mapping - 对象关系映射）的概念，可参见 Wikipedia。

GREENDAO 设计的主要目标

• 一个精简的库

• 性能最大化

• 内存开销最小化

• 易于使用的 APIs

• 对 Android 进行高度优化

GREENDAO 设计的主要特点

• greenDAO 性能远远高于同类的 ORMLite，具体测试结果可见官网

• greenDAO 支持 protocol buffer(protobuf) 协议数据的直接存储，如果你通过 protobuf 协议与服务器交互，将不需要任何的映射。

• 与 ORMLite 等使用注解方式的 ORM 框架不同，greenDAO 使用「Code generation」的方式，这也是其性能能大幅提升的原因。

DAO CODE GENERATION PROJECT

这是其核心概念：为了在我们的 Android 工程中使用 greenDAO ，我们需要另建一个纯 Java Project，用于自动生成后继 Android 工程中需要使用到的 Bean、DAO、DaoMaster、DaoSession 等类。

CORE CLASSES & MODELLING ENTITIES

关于以上几个类的相关概念与作用，我将在下面的代码（注释）中详细讲解。
当然，你也可以在 官网 中找到相关介绍。

---

让我们开始吧

一. 在 ANDROID 工程中配置「GREENDAO GENERATOR」模块

1. 在 .src/main 目录下新建一个与 java 同层级的「java-gen」目录，用于存放由 greenDAO 生成的 Bean、DAO、DaoMaster、DaoSession 等类。 
   

2. 配置 Android 工程（app）的 build.gradle，如图分别添加 sourceSets 与dependencies。 

[js] view plain copy

1. sourceSets {  
2.         main {  
3.             java.srcDirs = ['src/main/java', 'src/main/java-gen']  
4.         }  
5.     }  

[js] view plain copy

1. compile 'de.greenrobot:greendao:1.3.7'  

二. 新建「GREENDAO GENERATOR」模块 (纯 JAVA 工程）

1. 通过 File -> New -> New Module -> Java Library -> 填写相应的包名与类名 -> Finish.
   

2. 配置 daoexamplegenerator 工程的 build.gradle，添加 dependencies.

3.  

[js] view plain copy

1. compile 'de.greenrobot:greendao-generator:1.3.1'  

1. 编写 ExampleDaoGenerator 类，注意： 我们的 Java 工程只有一个类，它的内容决定了「GreenDao Generator」的输出，你可以在这个类中通过对象、关系等创建数据库结构，下面我将以注释的形式详细讲解代码内容。

[js] view plain copy

1. public class ExampleDaoGenerator {  
2.     public static void main(String[] args) throws Exception {  
3.         // 正如你所见的，你创建了一个用于添加实体（Entity）的模式（Schema）对象。  
4.         // 两个参数分别代表：数据库版本号与自动生成代码的包路径。  
5.         Schema schema = new Schema(1, "me.itangqi.greendao");  
6. //      当然，如果你愿意，你也可以分别指定生成的 Bean 与 DAO 类所在的目录，只要如下所示：  
7. //      Schema schema = new Schema(1, "me.itangqi.bean");  
8. //      schema.setDefaultJavaPackageDao("me.itangqi.dao");  
9.   
10.         // 模式（Schema）同时也拥有两个默认的 flags，分别用来标示 entity 是否是 activie 以及是否使用 keep sections。  
11.         // schema2.enableActiveEntitiesByDefault();  
12.         // schema2.enableKeepSectionsByDefault();  
13.   
14.         // 一旦你拥有了一个 Schema 对象后，你便可以使用它添加实体（Entities）了。  
15.         addNote(schema);  
16.   
17.         // 最后我们将使用 DAOGenerator 类的 generateAll() 方法自动生成代码，此处你需要根据自己的情况更改输出目录（既之前创建的 java-gen)。  
18.         // 其实，输出目录的路径可以在 build.gradle 中设置，有兴趣的朋友可以自行搜索，这里就不再详解。  
19.         new DaoGenerator().generateAll(schema, "/Users/tangqi/android-dev/AndroidStudioProjects/MyGreenDAO/app/src/main/java-gen");  
20.     }  
21.   
22.     /** 
23.      * @param schema 
24.      */  
25.     private static void addNote(Schema schema) {  
26.         // 一个实体（类）就关联到数据库中的一张表，此处表名为「Note」（既类名）  
27.         Entity note = schema.addEntity("Note");  
28.         // 你也可以重新给表命名  
29.         // note.setTableName("NODE");  
30.   
31.         // greenDAO 会自动根据实体类的属性值来创建表字段，并赋予默认值  
32.         // 接下来你便可以设置表中的字段：  
33.         note.addIdProperty();  
34.         note.addStringProperty("text").notNull();  
35.         // 与在 Java 中使用驼峰命名法不同，默认数据库中的命名是使用大写和下划线来分割单词的。  
36.         // For example, a property called “creationDate” will become a database column “CREATION_DATE”.  
37.         note.addStringProperty("comment");  
38.         note.addDateProperty("date");  
39.     }  
40. }  

三. 生成 DAO 文件（数据库）

• 执行 generator 工程，如一切正常，你将会在控制台看到如下日志，并且在主工程「java-gen」下会发现生成了DaoMaster、DaoSession、NoteDao、Note共4个类文件。 

如果在此处出错，你可以依据错误日志进行排查，主要看是否输出目录存在？其他配置是否正确？等

四. 在 ANDROID 工程中进行数据库操作

这里，我们只创建一个 NodeActivity 类，用于测试与讲解 greenDAO 的增、删、查功能。

• activity_note.xml

[js] view plain copy

1. <?xml version="1.0" encoding="utf-8"?>  
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
3.     android:layout_width="fill_parent"  
4.     android:layout_height="fill_parent"  
5.     android:orientation="vertical">  
6.   
7.     <LinearLayout  
8.         android:id="@+id/linearLayout1"  
9.         android:layout_width="fill_parent"  
10.         android:layout_height="wrap_content"  
11.         android:orientation="horizontal">  
12.   
13.         <EditText  
14.             android:id="@+id/editTextNote"  
15.             android:layout_width="wrap_content"  
16.             android:layout_height="wrap_content"  
17.             android:layout_weight="1"  
18.             android:hint="Enter new note"  
19.             android:inputType="text"></EditText>  
20.   
21.         <Button  
22.             android:id="@+id/buttonAdd"  
23.             android:layout_width="wrap_content"  
24.             android:layout_height="wrap_content"  
25.             android:onClick="onMyButtonClick"  
26.             android:text="Add"></Button>  
27.   
28.         <Button  
29.             android:id="@+id/buttonSearch"  
30.             android:layout_width="wrap_content"  
31.             android:layout_height="wrap_content"  
32.             android:onClick="onMyButtonClick"  
33.             android:text="Search"></Button>  
34.     </LinearLayout>  
35.   
36.     <ListView  
37.         android:id="@android:id/list"  
38.         android:layout_width="fill_parent"  
39.         android:layout_height="wrap_content"></ListView>  
40. </LinearLayout>  

• NoteActivity.java

[js] view plain copy

1. public class NoteActivity extends ListActivity {  
2.     private SQLiteDatabase db;  
3.     private EditText editText;  
4.     private DaoMaster daoMaster;  
5.     private DaoSession daoSession;  
6.     private Cursor cursor;  
7.     public static final String TAG = "DaoExample";  
8.   
9.     @Override  
10.     public void onCreate(Bundle savedInstanceState) {  
11.         super.onCreate(savedInstanceState);  
12.         setContentView(R.layout.activity_note);  
13.         // 官方推荐将获取 DaoMaster 对象的方法放到 Application 层，这样将避免多次创建生成 Session 对象  
14.         setupDatabase();  
15.         // 获取 NoteDao 对象  
16.         getNoteDao();  
17.   
18.         String textColumn = NoteDao.Properties.Text.columnName;  
19.         String orderBy = textColumn + " COLLATE LOCALIZED ASC";  
20.         cursor = db.query(getNoteDao().getTablename(), getNoteDao().getAllColumns(), null, null, null, null, orderBy);  
21.         String[] from = {textColumn, NoteDao.Properties.Comment.columnName};  
22.         int[] to = {android.R.id.text1, android.R.id.text2};  
23.   
24.         SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, cursor, from,  
25.                 to);  
26.         setListAdapter(adapter);  
27.   
28.         editText = (EditText) findViewById(R.id.editTextNote);  
29.     }  
30.   
31.     private void setupDatabase() {  
32.         // 通过 DaoMaster 的内部类 DevOpenHelper，你可以得到一个便利的 SQLiteOpenHelper 对象。  
33.         // 可能你已经注意到了，你并不需要去编写「CREATE TABLE」这样的 SQL 语句，因为 greenDAO 已经帮你做了。  
34.         // 注意：默认的 DaoMaster.DevOpenHelper 会在数据库升级时，删除所有的表，意味着这将导致数据的丢失。  
35.         // 所以，在正式的项目中，你还应该做一层封装，来实现数据库的安全升级。  
36.         DaoMaster.DevOpenHelper helper = new DaoMaster.DevOpenHelper(this, "notes-db", null);  
37.         db = helper.getWritableDatabase();  
38.         // 注意：该数据库连接属于 DaoMaster，所以多个 Session 指的是相同的数据库连接。  
39.         daoMaster = new DaoMaster(db);  
40.         daoSession = daoMaster.newSession();  
41.     }  
42.   
43.     private NoteDao getNoteDao() {  
44.         return daoSession.getNoteDao();  
45.     }  
46.   
47.     /** 
48.      * Button 点击的监听事件 
49.      * 
50.      * @param view 
51.      */  
52.     public void onMyButtonClick(View view) {  
53.         switch (view.getId()) {  
54.             case R.id.buttonAdd:  
55.                 addNote();  
56.                 break;  
57.             case R.id.buttonSearch:  
58.                 search();  
59.                 break;  
60.             default:  
61.                 Log.d(TAG, "what has gone wrong ?");  
62.                 break;  
63.         }  
64.     }  
65.   
66.     private void addNote() {  
67.         String noteText = editText.getText().toString();  
68.         editText.setText("");  
69.   
70.         final DateFormat df = DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM);  
71.         String comment = "Added on " + df.format(new Date());  
72.   
73.         // 插入操作，简单到只要你创建一个 Java 对象  
74.         Note note = new Note(null, noteText, comment, new Date());  
75.         getNoteDao().insert(note);  
76.         Log.d(TAG, "Inserted new note, ID: " + note.getId());  
77.         cursor.requery();  
78.     }  
79.   
80.     private void search() {  
81.         // Query 类代表了一个可以被重复执行的查询  
82.         Query query = getNoteDao().queryBuilder()  
83.                 .where(NoteDao.Properties.Text.eq("Test1"))  
84.                 .orderAsc(NoteDao.Properties.Date)  
85.                 .build();  
86.   
87. //      查询结果以 List 返回  
88. //      List notes = query.list();  
89.         // 在 QueryBuilder 类中内置两个 Flag 用于方便输出执行的 SQL 语句与传递参数的值  
90.         QueryBuilder.LOG_SQL = true;  
91.         QueryBuilder.LOG_VALUES = true;  
92.     }  
93.   
94.     /** 
95.      * ListView 的监听事件，用于删除一个 Item 
96.      * @param l 
97.      * @param v 
98.      * @param position 
99.      * @param id 
100.      */  
101.     @Override  
102.     protected void onListItemClick(ListView l, View v, int position, long id) {  
103.         // 删除操作，你可以通过「id」也可以一次性删除所有  
104.         getNoteDao().deleteByKey(id);  
105. //        getNoteDao().deleteAll();  
106.         Log.d(TAG, "Deleted note, ID: " + id);  
107.         cursor.requery();  
108.     }  
109. }  

五. 运行结果

一切就绪，让我们看看效果吧！运行程序，分别执行添加按钮、删除（点击 List 的 Item）与查询按钮，可以在控制台得到如下日志：
  

最后

• 本文的 Demo 下载链接：https://github.com/tangqi92/MyGreenDAO

• 本教程旨在介绍 greenDAO 的基本用法与配置，更高级与详细的使用，请参见 官网

• 如本文有任何错误与遗漏，欢迎指正。同时我期待与大家成为朋友，所以欢迎在社交网络上互粉！！！

References & More

http://greendao-orm.com/ https://github.com/greenrobot/greenDAOhttp://stackoverflow.com/questions/tagged/greendaohttps://groups.google.com/forum/#!forum/greendao