效果图：
点此进入目录：[干货] 十天 教你从创意到上线APP
一、什么是greenDao？
greenDao是一个将对象映射到SQLite数据库中的轻量且快速的ORM解决方案。
二、为什么选用greenDAO ？
- greenDAO 可以将我们数据库的中数据转换为相应的对象，这样可以省去我们自己去转换对象的时间。
- 和同类型的库相比，性能是最好的。（与OrmLite、ActiveOrm、LitePal等数据库相比，单位时间内可以插入、更新和查询更多的数据，而且提供了大量的灵活通用接口，对比可见下图。）
- greenDAO 也是当前 Android 开发中比较流行的库，当前的 github 星星数为 7369。
- 使用 SQL 语句进行查询容易出错，而且错误比较难以发现，使用 greenDAO 的话可以在编译阶段就发现错误。
- 还有就是代码比较简单明了，程序员都想用最少的代码，做最多的事。
-
轻量级，整个库大小小于 150 k。
三、GreenDao 3.0的使用
当前的 greenDAO 要求 gradle 的版本至少是 3.3，那我们采用3.3来实现。其中GreenDao 3.1采用注解的方式来定义实体类，通过gradle插件生成相应的代码。
1、在Android Studio中导入相关的包
compile 'org.greenrobot:greendao:3.1.0'
compile 'org.greenrobot:greendao-generator:3.1.0'
2、在build.gradle中进行配置
buildscript {
repositories {
jcenter()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.3.3'
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
}
}
注：在gradle的根模块中加入上述代码。
3、自定义路径
greendao {
schemaVersion 1
daoPackage 'com.wgh.willflowaicollection.greendao'
targetGenDir 'src/main/java'
}
属性介绍：
- schemaVersion : 指定数据库schema版本号，迁移等操作会用到；
- daoPackage : dao的包名，包名默认是entity所在的包；
- targetGenDir : 生成数据库文件的目录；
在gradle的根模块中加入上述代码，就完成了我们的基本配置了。
4、创建一个Category的实体类
/**
* Created by : WGH.
*/
@Entity
public class Category implements Serializable {
private static final long serialVersionUID = 7247714666080613254L;
@Id(autoincrement = true)
private Long id;
private int grade;
private String name;
private String selfKey;
@Convert(columnType = String.class, converter = ListConverter.class)
private ArrayList<String> nextNames = new ArrayList<>();
@Convert(columnType = String.class, converter = ListConverter.class)
private ArrayList<String> contentUrls = new ArrayList<>();
@Convert(columnType = String.class, converter = ListConverter.class)
private ArrayList<String> contentTitles = new ArrayList<>();
@Convert(columnType = String.class, converter = ListConverter.class)
private ArrayList<String> nextKeys = new ArrayList<>();
public Category() {
}
@Generated(hash = 182005897)
public Category(Long id, int grade, String name, String selfKey, ArrayList<String> nextNames, ArrayList<String> contentUrls, ArrayList<String> contentTitles, ArrayList<String> nextKeys) {
this.id = id;
this.grade = grade;
this.name = name;
this.selfKey = selfKey;
this.nextNames = nextNames;
this.contentUrls = contentUrls;
this.contentTitles = contentTitles;
this.nextKeys = nextKeys;
}
public Category(int grade, String name) {
this.grade = grade;
this.name = name;
}
}
5、构造数据转换模板类
/**
* Created by : WGH.
*/
public class ListConverter implements PropertyConverter<ArrayList<String>, String> {
@Override
public ArrayList<String> convertToEntityProperty(String databaseValue) {
ArrayList<String> arrayList;
if (databaseValue == null) {
return null;
} else {
List<String> list = Arrays.asList(databaseValue.split(PreDefine.SplitString));
arrayList = new ArrayList<>(list);
return arrayList;
}
}
@Override
public String convertToDatabaseValue(ArrayList<String> entityProperty) {
if (entityProperty == null) {
return null;
} else {
StringBuilder sb = new StringBuilder();
for (String entity : entityProperty) {
sb.append(entity);
sb.append(PreDefine.SplitString);
}
return sb.toString();
}
}
}
6、编译工程
编译项目后Category实体类会自动编译，然后生成get、set方法并且会在greendao目录下生成三个文件：
另外的三个是其它数据类构造出来的三个文件，在这里可以不用理会。
四、greenDao的增删改查操作
首先在 MyApplication 中进行这样设置：
/**
* Created by : WGH.
*/
public class MyApplication extends Application{
private static DaoMaster daoMaster;
private static DaoSession daoSession;
@Override
public void onCreate() {
super.onCreate();
}
public static DaoMaster getDaoMaster() {
if (daoMaster == null) {
DaoMaster.OpenHelper helper = new DaoMaster.DevOpenHelper(mMyApplication, PreDefine.DBNAME, null);
daoMaster = new DaoMaster(helper.getReadableDatabase());
}
return daoMaster;
}
public static DaoSession getDaoSession() {
if (daoSession == null) {
if (daoMaster == null) {
daoMaster = getDaoMaster();
}
daoSession = daoMaster.newSession();
}
return daoSession;
}
}
然后在使用greenDao的地方进行这样的调用：
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
这样就能获得categoryDao 对象了。
1、增删改查的简单实现
- 增
Category categoryNew = new Category();
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
categoryDao.insert(categoryNew);
- 删
public void deleteCategoryFromDB(Category category) {
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
Category categoryOld = getCategotyFromDB(category.getKey());
if (categoryOld != null) {
categoryDao.delete(categoryOld);
}
}
- 删除全部
public void deleteAllCategory() {
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
categoryDao.deleteAll();
}
- 改
public void updateCategoryToDB(Category categoryNew) {
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
Category categoryOld = getCategotyFromDB(categoryNew.getKey());
categoryNew.setId(categoryOld.getId());
categoryDao.update(categoryNew);
}
- Key值查找
public Category getCategotyFromDB(String key) {
if (TextUtils.isEmpty(key)) {
return null;
}
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
QueryBuilder<Category> queryBuilder = categoryDao.queryBuilder().where(CategoryDao.Properties.SelfKey.eq(key));
if (queryBuilder.list().size() > 0) {
return queryBuilder.list().get(0);
} else {
return null;
}
}
- 模糊查询
public ArrayList<Category> getEligibleCategory(String contentString) {
CategoryDao categoryDao = MyApplication.getDaoSession().getCategoryDao();
QueryBuilder<Category> queryBuilder = categoryDao.queryBuilder().where(CategoryDao.Properties.ContentTitles.like("%" + contentString + "%"));
if (queryBuilder.list().size() > 0) {
return new ArrayList<>(queryBuilder.list());
} else {
return null;
}
}
- 查询全部
public ArrayList<Category > getAllCategory () {
Category category = MyApplication.getDaoSession().getCategoryDao();
return new ArrayList<>(category .loadAll());
}
- 条件查询
List<Category > list = categoryDao.queryBuilder()
.offset(1)//偏移量，相当于 SQL 语句中的 skip
.limit(3)//只获取结果集的前 3 个数据
.orderAsc(categoryDao.Properties.StudentNum)//通过 StudentNum 这个属性进行正序排序
.where(categoryDao.Properties.Name.eq("zone"))//数据筛选，只获取 Name = "zone" 的数据。
.build()
.list();
2、greenDao中的注解详解
(一) @Entity 定义实体
- @nameInDb 在数据库中的名字，如不写则为实体中类名
- @indexes 索引
- @createInDb 是否创建表，默认为true,false时不创建
- @schema 指定架构名称为实体
- @active 无论是更新生成都刷新
(二) @Id
(三) @NotNull 不为null
(四) @Unique 唯一约束
(五) @ToMany 一对多
(六) @OrderBy 排序
(七) @ToOne 一对一
(八) @Transient 不存储在数据库中
(九) @generated 由greendao产生的构造函数或方法
联系方式：
