GreenDao应用解析

一、概论

GreenDao是一种对象关系映射（ORM）型数据库，在Android开发中使用较为广泛，比其他关系映射数据库性能更加良好。

GreenDao的Github源码地址：https://github.com/greenrobot/greenDAO

GreenDao的官方地址：http://greenrobot.org/greendao/

Tips：国外网站存在被墙的问题，相信这不会影响大家对实现原理的探究。

二、在Android中配置使用GreenDao

配置GreenDao需要两个步骤：

• 通过Java工程生成实体类和相应的管理类；

• 将第一步生成的实体类和管理类加到Android项目中，就可以使用了。

注意：这两个步骤，不管使用Eclipse还是Android Studio，都需要加入依赖的jar包。

步骤一用到的jar包，有下边两个：

步骤二用到的jar包，是GreenDao.jar

下载全部jar包

下面详细介绍两个步骤：

生成类

Main方法中的代码：

public static void main(String[] args) throws IOException, Exception {
        Schema schema = new Schema(1, "de.greenrobot.daoexample");  //生成的实体类的目录

        addSeason(schema);//添加实体类

        addMatchClass(schema); //添加实体类

        new DaoGenerator().generateAll(schema, "D://DaoExamples");//生成的实体类目录要保存的路径，也可以是本地途径，例如“./daoExamples”，就会把生成的内容保存到daoExamples下，目录结构为de.greenrobot.daoexample。
    }

addSeason(schema)类中的代码：

private static void addSeason(Schema schema) {
         season = schema.addEntity("Season");
         season.addLongProperty("seasonId").notNull().primaryKey();
         season.addStringProperty("seasonName");
         season.addStringProperty("description");
    }

addMatchClass(schema)类中的代码：

private static void addMatchClass(Schema schema) {
        matchClass = schema.addEntity("MatchClass");
        matchClass.addLongProperty("classId").notNull().primaryKey();
        matchClass.addStringProperty("className");
        matchClass.addStringProperty("description");

        Property propertySeasonId = matchClass.addLongProperty("seasonId").getProperty();
        matchClass.addToOne(season, propertySeasonId);//将MatchClass的seasonId属性和Season关联
    }

在addMatchClass(schema)类中我么用到了关联数据库的基本操作，即：建“外键”。

此处使用的是一对一的关联，还有一对多、多对多的关联，不过多介绍，可参考：
http://blog.csdn.net/wangkeke1860/article/details/51934058

使用类

将生成的类加入到Android项目中，加入greendao.jar包后，就可以使用。

DaoMaster.java：持有数据库对象（SQLiteDatabase）并管理一些DAO类（而不是对象），以静态方式创建和drop数据库表。它的内部类OpenHelper和DevOpenHelper是SQLiteOpenHelper的实现类，用于创建SQLite数据库的模式。

DaoSession.java：管理Dao对象，执行增删改查这些操作。

Season.java：实体类。

SeasonDao.java：数据访问对象，用于实体的持久化和查询。

三、数据库升级

默认的升级方法会删除原来所有的表，然后重建。为了避免数据丢失，我们需要对每个表进行手动操作，但是这样也太麻烦，所以这里给出一个对数据库升级的工具类（来自：http://stackoverflow.com/questions/13373170/greendao-schema-update-and-data-migration）

import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.text.TextUtils;
import android.util.Log;

import com.crashlytics.android.Crashlytics;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import de.greenrobot.dao.AbstractDao;
import de.greenrobot.dao.internal.DaoConfig;
import greendao.DaoMaster;


/**
 * Created by pokawa on 18/05/15.
 */
public class MigrationHelper {

    private static final String CONVERSION_CLASS_NOT_FOUND_EXCEPTION = "MIGRATION HELPER - CLASS DOESN'T MATCH WITH THE CURRENT PARAMETERS";
    private static MigrationHelper instance;

    public static MigrationHelper getInstance() {
        if(instance == null) {
            instance = new MigrationHelper();
        }
        return instance;
    }

    public void migrate(SQLiteDatabase db, Class<? extends AbstractDao<?, ?>>... daoClasses) {
        generateTempTables(db, daoClasses);//建立临时数据库
        DaoMaster.dropAllTables(db, true);//删除数据库
        DaoMaster.createAllTables(db, false);//创建新数据库
        restoreData(db, daoClasses);//将临时数据库的数据添加到新数据库，并将脸是数据库删除
    }

    private void generateTempTables(SQLiteDatabase db, Class<? extends AbstractDao<?, ?>>... daoClasses) {
        for(int i = 0; i < daoClasses.length; i++) {
            DaoConfig daoConfig = new DaoConfig(db, daoClasses[i]);

            String divider = "";
            String tableName = daoConfig.tablename;
            String tempTableName = daoConfig.tablename.concat("_TEMP");
            ArrayList<String> properties = new ArrayList<>();

            StringBuilder createTableStringBuilder = new StringBuilder();

            createTableStringBuilder.append("CREATE TABLE ").append(tempTableName).append(" (");

            for(int j = 0; j < daoConfig.properties.length; j++) {
                String columnName = daoConfig.properties[j].columnName;

                if(getColumns(db, tableName).contains(columnName)) {
                    properties.add(columnName);

                    String type = null;

                    try {
                        type = getTypeByClass(daoConfig.properties[j].type);
                    } catch (Exception exception) {
                        Crashlytics.logException(exception);
                    }

                    createTableStringBuilder.append(divider).append(columnName).append(" ").append(type);

                    if(daoConfig.properties[j].primaryKey) {
                        createTableStringBuilder.append(" PRIMARY KEY");
                    }

                    divider = ",";
                }
            }
            createTableStringBuilder.append(");");

            db.execSQL(createTableStringBuilder.toString());

            StringBuilder insertTableStringBuilder = new StringBuilder();

            insertTableStringBuilder.append("INSERT INTO ").append(tempTableName).append(" (");
            insertTableStringBuilder.append(TextUtils.join(",", properties));
            insertTableStringBuilder.append(") SELECT ");
            insertTableStringBuilder.append(TextUtils.join(",", properties));
            insertTableStringBuilder.append(" FROM ").append(tableName).append(";");

            db.execSQL(insertTableStringBuilder.toString());
        }
    }

    private void restoreData(SQLiteDatabase db, Class<? extends AbstractDao<?, ?>>... daoClasses) {
        for(int i = 0; i < daoClasses.length; i++) {
            DaoConfig daoConfig = new DaoConfig(db, daoClasses[i]);

            String tableName = daoConfig.tablename;
            String tempTableName = daoConfig.tablename.concat("_TEMP");
            ArrayList<String> properties = new ArrayList();

            for (int j = 0; j < daoConfig.properties.length; j++) {
                String columnName = daoConfig.properties[j].columnName;

                if(getColumns(db, tempTableName).contains(columnName)) {
                    properties.add(columnName);
                }
            }

            StringBuilder insertTableStringBuilder = new StringBuilder();

            insertTableStringBuilder.append("INSERT INTO ").append(tableName).append(" (");
            insertTableStringBuilder.append(TextUtils.join(",", properties));
            insertTableStringBuilder.append(") SELECT ");
            insertTableStringBuilder.append(TextUtils.join(",", properties));
            insertTableStringBuilder.append(" FROM ").append(tempTableName).append(";");

            StringBuilder dropTableStringBuilder = new StringBuilder();

            dropTableStringBuilder.append("DROP TABLE ").append(tempTableName);

            db.execSQL(insertTableStringBuilder.toString());
            db.execSQL(dropTableStringBuilder.toString());
        }
    }

    private String getTypeByClass(Class<?> type) throws Exception {
        if(type.equals(String.class)) {
            return "TEXT";
        }
        if(type.equals(Long.class) || type.equals(Integer.class) || type.equals(long.class)) {
            return "INTEGER";
        }
        if(type.equals(Boolean.class)) {
            return "BOOLEAN";
        }

        Exception exception = new Exception(CONVERSION_CLASS_NOT_FOUND_EXCEPTION.concat(" - Class: ").concat(type.toString()));
        Crashlytics.logException(exception);
        throw exception;
    }

    private static List<String> getColumns(SQLiteDatabase db, String tableName) {
        List<String> columns = new ArrayList<>();
        Cursor cursor = null;
        try {
            cursor = db.rawQuery("SELECT * FROM " + tableName + " limit 1", null);
            if (cursor != null) {
                columns = new ArrayList<>(Arrays.asList(cursor.getColumnNames()));
            }
        } catch (Exception e) {
            Log.v(tableName, e.getMessage(), e);
            e.printStackTrace();
        } finally {
            if (cursor != null)
                cursor.close();
        }
        return columns;
    }
}

升级是，在update中添加语句：

 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
        MyMigrationHelper.getInstance().migrate(db,StudentDao.class,SchoolDao.class);//只有已经存在的表才添加到里边，新增的表不用添加
        }

参考博客：http://blog.csdn.net/wangkeke1860/article/details/51838830