Android(安卓)Studio 导入 GreenDao

Android Studio 导入 GreenDao
参考自：Android ORM 框架之 GreenDao使用心得

根据以上链接做了一次markdown(请忽略两条虚线间的内容)

适用于 Android 的ORM 框架也就孕育而生了，现在市面上主流的框架有 OrmLite、SugarORM、Active Android、Realm 与 GreenDAO。而今天的主角便是 greenDAO，下面，我将详解地介绍如何在 Android Studio 上使用 greenDAO，并结合代码总结一些使用过程中的心得。

关于 greenDAO
Android ORM 框架之 GreenDao使用心得
适用于 Android 的ORM 框架也就孕育而生了，现在市面上主流的框架有 OrmLite、SugarORM、Active Android、Realm 与 GreenDAO。而今天的主角便是 greenDAO，下面，我将详解地介绍如何在 Android Studio 上使用 greenDAO，并结合代码总结一些使用过程中的心得。

关于 greenDAO
Android ORM 框架之 GreenDao使用心得

简单的讲，GreenDao是一个将对象映射到 SQLite 数据库中的轻量且快速的 ORM 解决方案。（GreenDaois 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 ORM 框架之 GreenDao使用心得

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

CORE CLASSES & MODELLING ENTITIES
关于以上几个类的相关概念与作用，我将在下面的代码（注释）中详细讲解。
当然，你也可以在官网中找到相关介绍。
简单的讲，GreenDao是一个将对象映射到 SQLite 数据库中的轻量且快速的 ORM 解决方案。（GreenDaois 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

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

下面开始我们的工作了，
一. 在 ANDROID 工程中配置「GreenDaoGENERATOR」模块
1、在 .src/main 目录下新建一个与 java 同层级的「java-gen」目录，用于存放由 GreenDao生成的 Bean、DAO、DaoMaster、DaoSession 等类。

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

点此链接下载包【若不成功】

          sourceSets {        main {            java.srcDirs = ['src/main/java', 'src/main/java-gen']        }

dependencies {    compile fileTree(dir: 'libs', include: ['*.jar'])    testCompile 'junit:junit:4.12'    compile 'com.android.support:appcompat-v7:23.1.1'    compile 'com.android.support:design:23.1.1' // compile 'de.greenrobot:greendao:1.3.7'    compile files('src/main/libs/freemarker-2.3.10.jar')    compile files('src/main/libs/greendao-1.3.7.jar')    compile files('src/main/libs/greendao-generator-1.3.1.jar')}

二. 新建「GreenDaoGENERATOR」模块 (纯 JAVA 工程）
通过 File -> New -> New Module -> Java Library -> 填写相应的包名与类名 -> Finish.

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

project(':MyDaoGenerator') {    apply plugin: 'application'    apply plugin: 'java'    mainClassName = "pl.surecase.eu.MyDaoGenerator"    // edit output direction    // def outputDir = "../DaoExample/src/main/java-gen"    def outputDir = "../app/src/main/java-gen"    dependencies {        compile fileTree(dir: 'libs', include: ['*.jar'])        // compile('de.greenrobot:DaoGenerator:1.3.7')    }    task createDocs {        def docs = file(outputDir)        docs.mkdirs()    }    run {        args outputDir    }}dependencies {    compile files('src/main/libs/freemarker-2.3.10.jar')    compile files('src/main/libs/greendao-1.3.7.jar')    compile files('src/main/libs/greendao-generator-1.3.1.jar')}

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

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

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

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

四. 在 ANDROID 工程中进行数据库操作
这里，我们只创建一个 NodeActivity 类，用于测试与讲解 greenDAO 的增、删、查功能。

activity_note.xml

<?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>

MainActivity.java

public class MainActivity 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 对象的方法放到 Application 层，这样将避免多次创建生成 Session 对象        setupDatabase();        // 获取 NoteDao 对象        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() {        // 通过 DaoMaster 的内部类 DevOpenHelper，你可以得到一个便利的 SQLiteOpenHelper 对象。        // 可能你已经注意到了，你并不需要去编写「CREATE TABLE」这样的 SQL 语句，因为 greenDAO 已经帮你做了。        // 注意：默认的 DaoMaster.DevOpenHelper 会在数据库升级时，删除所有的表，意味着这将导致数据的丢失。        // 所以，在正式的项目中，你还应该做一层封装，来实现数据库的安全升级。        DaoMaster.DevOpenHelper helper = new DaoMaster.DevOpenHelper(this, "notes-db", null);        db = helper.getWritableDatabase();        // 注意：该数据库连接属于 DaoMaster，所以多个 Session 指的是相同的数据库连接。        daoMaster = new DaoMaster(db);        daoSession = daoMaster.newSession();    }    private NoteDao getNoteDao() {        return daoSession.getNoteDao();    }    /** * Button 点击的监听事件 * * @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());        // 插入操作，简单到只要你创建一个 Java 对象        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 类代表了一个可以被重复执行的查询        Query query = getNoteDao().queryBuilder()                .where(NoteDao.Properties.Text.eq("Test1"))                .orderAsc(NoteDao.Properties.Date)                .build();// 查询结果以 List 返回// List notes = query.list();        // 在 QueryBuilder 类中内置两个 Flag 用于方便输出执行的 SQL 语句与传递参数的值        QueryBuilder.LOG_SQL = true;        QueryBuilder.LOG_VALUES = true;    }    /** * ListView 的监听事件，用于删除一个 Item * @param l * @param v * @param position * @param id */    @Override    protected void onListItemClick(ListView l, View v, int position, long id) {        // 删除操作，你可以通过「id」也可以一次性删除所有        getNoteDao().deleteByKey(id);// getNoteDao().deleteAll();        Log.d(TAG, "Deleted note, ID: " + id);        cursor.requery();    }}

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

不废话，源码请点击这里

更多相关文章

随机推荐