Android数据库框架-----GreenDao3的相关使用和版本升级更新

GreenDAO是一款非要流行的Android平台上的数据库框架，性能优秀，代码简洁；是一个将对象映射到SQLite数据库中的轻量且快速的ORM解决方案。

GreenDAO 优势
1、一个精简的库
2、性能最大化
3、内存开销最小化
4、易于使用的 APIs
5、对 Android 进行高度优化
首先先添加相关配置文件，依赖库

 compile 'org.greenrobot:greendao:3.+'

并在库文件顶部添加：

apply plugin: 'org.greenrobot.greendao'

库文件下定义路径

greendao {
    schemaVersion 1//指定数据库版本号，更新操作会用到;
    daoPackage 'com.zhangqie.greendao.gen'//自动生成的dao的包名，包名默认是entity所在的包；
    targetGenDir 'src/main/java'//生成数据库文件的目录
}

在build.gradle文件中添加配置

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.2.3'
        classpath 'org.greenrobot:greendao-gradle-plugin:3.2.1'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

通过以上操作就完成我们的基本配置了；

创建一个类User

@Entity
public class User {
    @Id(autoincrement = true)
    private Long id;//主键  自增长
    @NotNull   //不许为空
    private String name;
    private String age;
    private String content;
}

编译运行项目，User实体类会自动编译，生成get、set方法并且会在com.zhangqie.greendao.gen目录下生成三个文件；

image

创建Application类 以下是GreenDao的基本的用法 注释了的 自定义Helper类包含了版本升级更新

public class GreenApplication extends Application {
 private DaoMaster.DevOpenHelper mHelper;
 //private Helper mHelper;
 private SQLiteDatabase db;
 private DaoMaster mDaoMaster;
 private DaoSession mDaoSession;
 public static GreenApplication instances;
 @Override    public void onCreate() {
     super.onCreate();
     instances = this;
     setDatabase();
 }
 public static GreenApplication getInstances(){
     return instances;
 }

/**
 * 设置greenDao
 */
private void setDatabase() {
    // 通过 DaoMaster 的内部类 DevOpenHelper，你可以得到一个便利的 SQLiteOpenHelper 对象。
    // 可能你已经注意到了，你并不需要去编写「CREATE TABLE」这样的 SQL 语句，因为 greenDAO 已经帮你做了。
    // 注意：默认的 DaoMaster.DevOpenHelper 会在数据库升级时，删除所有的表，意味着这将导致数据的丢失。
    // 所以，在正式的项目中，你还应该做一层封装，来实现数据库的安全升级。
　　 //mHelper = new Helper(new GreenDaoUtils(this));

　　
    mHelper = new DaoMaster.DevOpenHelper(this, "notes-db", null);
    db = mHelper.getWritableDatabase();
    // 注意：该数据库连接属于 DaoMaster，所以多个 Session 指的是相同的数据库连接。 
    mDaoMaster = new DaoMaster(db); 
    mDaoSession = mDaoMaster.newSession();
}
public DaoSession getDaoSession() {
      return mDaoSession;
}
public SQLiteDatabase getDb() {
      return db;
  }
}

MainActivity中

UserDao userDao= GreenApplication.getInstances().getDaoSession().getUserDao();
//获取对象来完成  增删改查

1：添加

  User user2=new User();
       user2.setName("白子画");
       user2.setAge("18");
       user2.setContent("我是");long a=userDao.insert(user2);    //添加  a>0添加成功

2：删除

userDao.deleteByKey(1);//id

3：修改

 User user3=new User((long)2,"花千骨","19","你是");//修改Id=2的一列
  userDao.update(user3);

4：查询

List users = userDao.loadAll();
String username = "";
for (int i = 0; i < users.size(); i++) {
 username += users.get(i).getId() + "---"+users.get(i).getName() +"\n";
}
textView.setText(username);

相关的条件查询，可下载源码查看；运行效果如下：

image

版本升级更新

比如需要在实体类加一个字段 或者 改变字段属性等 就需要版本更新来保存以前的数据了；

我的案例中是加了一个 times的字段；

1：需要一个**MigrationHelper.java类 **一位大神写的 直接拿来用即可

地址：https://stackoverflow.com/questions/13373170/greendao-schema-update-and-data-migration/30334668#30334668

2：接下来就是我们 GreenApplication 类里的 Helper类了

public class Helper extends DaoMaster.OpenHelper{

    private static DaoMaster daoMaster;
    private static DaoSession daoSession;

    public static final String DBNAME = "greendao.db";

    public Helper(Context context){
        super(context,DBNAME,null);
    }


    @Override
    public void onUpgrade(Database db, int oldVersion, int newVersion) {
        super.onUpgrade(db, oldVersion, newVersion);
        Log.i("version", oldVersion + "---先前和更新之后的版本---" + newVersion);
        if (oldVersion < newVersion) {
            Log.i("version", oldVersion + "---先前和更新之后的版本---" + newVersion);
            MigrationHelper.getInstance().migrate(db, UserDao.class);
            //更改过的实体类(新增的不用加)   更新UserDao文件 可以添加多个  XXDao.class 文件
//             MigrationHelper.getInstance().migrate(db, UserDao.class,XXDao.class);
        }
    }

    /**
     * 取得DaoMaster
     *
     * @param context
     * @return
     */
    public static DaoMaster getDaoMaster(Context context) {
        if (daoMaster == null) {
            DaoMaster.OpenHelper helper = new DaoMaster.DevOpenHelper(context,
                    DBNAME, null);
            daoMaster = new DaoMaster(helper.getWritableDatabase());
        }
        return daoMaster;
    }

    /**
     * 取得DaoSession
     *
     * @param context
     * @return
     */
    public static DaoSession getDaoSession(Context context) {
        if (daoSession == null) {
            if (daoMaster == null) {
                daoMaster = getDaoMaster(context);
            }
            daoSession = daoMaster.newSession();
        }
        return daoSession;
    }
}

完成相关操作之后；还要改数据库版本

greendao {
    schemaVersion 2//改版本号为2
    daoPackage 'com.zhangqie.greendao.gen'；
    targetGenDir 'src/main/java'
}

编译运行，可以去实体类和UserDao查看 增加的字段相关信息自动生成完成；

当然先前的版本1 中的数据也是存在的，只不过 新添加的字段 的值全部为空而已；

提示：如果感觉复杂可以先看看 别人的这篇博客 GreenDao3.0简单使用 先学基本使用 再来弄版本升级更新也不迟

由于代码太多，就不一一贴出来了，直接下载源码即可

源码点击下载

https://github.com/DickyQie/android-greendao