Android ORM 框架之 greenDAO应用基础
greenDAO是时下Android最流行的一款ORM框架,其性能高，可加密，使用简洁，做android开发，如果会使用它，工作量会大大减小。其性能与其他ORM框架之比较可以查阅其官网。
目前greenDAO版本为3.1.1，greenDAO3相较于greenDAO2发生了较大的改变：可以使用注解声明schemas和实体。有两种方式使用greenDAO3，一种是使用java库的形式（greenDAO2的使用方法），一种是基于注解的形式（greenDAO3新增的）。
方式一，java库形式
1>在 src/main 目录下新建一个与 java 同层级的java-gen目录，用于存放由 greendao生成的 Bean类、DAO类、DaoMaster、DaoSession 等类：
2> 在build.gradle（app），添加 sourceSets 与依赖：
sourceSets {
main {
java.srcDirs = ['src/main/java', 'src/main/java-gen']
}
}
dependencies {
compile 'org.greenrobot:greendao:3.1.0'
// This is only needed if you want to use encrypted databases
compile 'net.zetetic:android-database-sqlcipher:3.5.1'
}3>新建java库模块：File -> New -> New Module -> Java Library：
4>在java库模块build.gradle的dependencies中添加依赖：
dependencies {
compile 'org.greenrobot:greendao-generator:3.1.0'
}5>编写java库模块生成的类，创建实体（表）：
public class Generator {
public static void main(String[] args) throws Exception {
int version = 1;
String defaultPackage = "com.example.bean";
//创建模式对象，指定版本号和自动生成的bean对象的包名
Schema schema = new Schema(version, defaultPackage);
//指定自动生成的dao对象的包名,不指定则都DAO类生成在"com.example.bean"包中
schema.setDefaultJavaPackageDao("com.example.dao");
//添加实体
addEntity(schema);
//java-gen绝对路径
String outDir = "H:/Persion/app/src/main/java-gen";
//调用DaoGenerator().generateAll方法自动生成代码到之前创建的java-gen目录下
new DaoGenerator().generateAll(schema, outDir);
}
private static void addEntity(Schema schema) {
//添加一个实体，会自动生成实体类Persion
Entity persion = schema.addEntity("Persion");
//指定表名，如不指定，表名则为 Persion（即实体类名）
persion.setTableName("persion");
//给实体类中添加成员（即给表中添加列，并设置列的属性）
persion.addIdProperty().autoincrement();//添加Id,自增长
persion.addStringProperty("name").notNull();//添加String类型的name,不能为空
persion.addIntProperty("age");//添加Int类型的age
persion.addDoubleProperty("high");//添加Double类型的high
...
}
}6>运行此java类，会自动在Android项目的java-gen目录下生成bean类和DAO类：
7>转到下方 操作数据库 部分
代码说明
点击阅读greenrobot
方式二，使用注解
1>在build.gradle（app）中添加插件和依赖:
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
}
}
apply plugin: 'org.greenrobot.greendao'
dependencies {
compile 'org.greenrobot:greendao:3.1.0'
// This is only needed if you want to use encrypted databases
compile 'net.zetetic:android-database-sqlcipher:3.5.1'
compile 'org.greenrobot:greendao-generator:3.1.0'
}2>在build.gradle（app）中插件配置：
如果不对 greenDAO进行属性配置，在下面当”Build -> Make Project”时， greendao生成的源代码路径会是： build/generated/source/greendao。对greenDAO进行相关配置，则可以指定其路径：
greendao {
schemaVersion 1
daoPackage 'com.example.greendao'
targetGenDir 'src/main/java'
}这个greendao 可以配置的属性:
schemaVersion: 数据库schema版本号，默认为1。
daoPackage: greendao生成文件 DAOs,DaoMaster,DaoSession所在的包名，默认为源码实体所在的包名。
targetGenDir: 上面包所在的路径目录，默认为：build/generated/source/greendao。
generateTests: 设置为true可以自动生成单元测试。
targetGenDirTests:生成单元测试存储在的目录， 默认为：src/androidTest/java。
3>使用注解创建Bean类：
@Entity
public class Persion {
@Id
private Long id;
@NotNul
private String name;
private int age;
}4>Build -> Make Project:
Make Project后，greenDAO自动为Bean类生成构造方法和每个成员的get set方法，以及前面设置的com.example.greendao包及其中的文件：
5>转到下方 操作数据库 部分
类注解
@Entity：注解实体类，标识一个表，添加的属性可以查阅依赖库中Entity注解类：
public @interface Entity {
/**
* 指定数据库中表明，默认为注解的实体类的类名
*/
String nameInDb() default "";
/**
* 对实体的索引
*
* 注意: 如果创建单列索引使用 {@link Index}
*/
Index[] indexes() default {};
/**
* 如果设置为false,表示这个实体类不在数据库中创建表。 仅仅是一个实体类。
* 注意，greendao不会在缓存中同步多个实体。
*/
boolean createInDb() default true;
/**
* 指定schema名字。
*/
String schema() default "default";
/**
* 是否可以生成update/delete/refresh方法。
*如果实体被定义成{@link ToMany} 或者 {@link ToOne} 关系,这个属性是active
*/
boolean active() default false;
/**
* 构造器是否可以生成.
*/
boolean generateConstructors() default true;
}用法为：
@Entity(nameInDb="persion ",active=false)注意：注解方式不支持多schema，但java库形式支持。
基础属性注解
@Id：对象id，通过设置@Id(autoincrement = true)表示自增，只有当Long/long时才有效
@Property：设置成员属性名（表的列名），如果不设置此属性表示默认是类成员名
@NotNull ：表示此成员属性非空
@Transient：标识这个字段是自定义的，不会创建到数据库表中
自定义类型
@Convert：如果有自定义的成员类型，使用此注解。如果自定义类型或转换器是在此实体类外，需要设置她们为静态的。
使用实例：
@Entity
public class User {
@Id
private Long id;
//注解中converter指向类型类，columnType指向在此表中显示的字段类型
@Convert(converter = RoleConverter.class, columnType = String.class)
private Role role;
enum Role {
DEFAULT, AUTHOR, ADMIN
}
static class RoleConverter implements PropertyConverter<Role, String> {
@Override
public Role convertToEntityProperty(String databaseValue) {
return Role.valueOf(databaseValue);
}
@Override
public String convertToDatabaseValue(Role entityProperty) {
return entityProperty.name();
}
}
}索引注解
@Index：为数据库中此列设置为索引列，通过其name参数指定此列的索引名，通过unique参数给索引添加约束 。
@Unique：给索引添加约束。
关系注解
@ToOne：声明与另一个实体的关系：一对一。参数joinProperty 指向另一个实体的 ID列，如果不设置，则默认为id主键：
@Entity
public class Order {
@Id private Long id;
private long customerId;
@ToOne(joinProperty = "customerId")
private Customer customer;
}
@Entity
public class Customer {
@Id private Long id;
}@ToMany：声明与另外多个实体的关系：一对多。这种关系映射有三种情况：
referencedJoinProperty 参数：外键属性，指向另一实体的ID列：
@Entity
public class User {
@Id private Long id;
@ToMany(referencedJoinProperty = "ownerId")
private List ownedSites;
}
@Entity
public class Site {
@Id private Long id;
private long ownerId;
} joinProperties 参数：对于更复杂的关系，可以使用多个@JoinProperty：
@Entity
public class User {
@Id private Long id;
@Unique private String authorTag;
@ToMany(joinProperties = {
@JoinProperty(name = "authorTag", referencedName = "ownerTag")
})
private List ownedSites;
}
@Entity
public class Site {
@Id private Long id;
@NotNull private String ownerTag;
} @JoinEntity：多对多的关系：
@Entity
public class Site {
@Id private Long id;
@ToMany
@JoinEntity(
entity = JoinSiteToUser.class,
sourceProperty = "siteId",
targetProperty = "userId"
)
private List authors;
}
@Entity
public class JoinSiteToUser {
@Id private Long id;
private Long siteId;
private Long userId;
}
@Entity
public class User {
@Id private Long id;
} @Generated代码
@Generated 这个是build后greendao自动生成的，这个注解理解为防止重复，每一块代码生成后会加个hash作为标记。 官方不建议你去碰这些代码，改动会导致里面代码与hash值不符。如果手动改变引发错误：
Error:Execution failed for task ':app:greendao'.
> Constructor (see ExampleEntity:21) has been changed after generation.
Please either mark it with @Keep annotation instead of @Generated to keep it untouched,
or use @Generated (without hash) to allow to replace it.当这个错误出现时，通常有两种方法解决：
1>恢复@Generated注解的代码，可以删除此段代码，下次build时，会再重新生成。
2>使用@Keep注解代替@Generated注解，它会告诉greenDAO不去触碰@Keep注解的代码。
操作数据库
在Android项目中自定义一个Application：
public class App extends Application {
/** 数据库是否加密的标识 */
public static final boolean ENCRYPTED = true;
private DaoSession daoSession;
@Override
public void onCreate() {
super.onCreate();
//创建数据库
DevOpenHelper helper = new DevOpenHelper(this, ENCRYPTED ? "notes-db-encrypted" : "notes-db");
//获取数据库读写的权限，如果进行加密调用helper.getEncryptedWritableDb("super-secret")，参数为设置的密码
Database db = ENCRYPTED ? helper.getEncryptedWritableDb("super-secret") : helper.getWritableDb();
daoSession = new DaoMaster(db).newSession();
}
public DaoSession getDaoSession() {
return daoSession;
}
}在Manifest文件中指向自定义的Application：
".App"
...
对数据库加密
在build.gradle中添加依赖：
dependencies {
compile 'net.zetetic:android-database-sqlcipher:3.5.1'
}如上App类，对数据库进行加密读写：
//创建数据库（上下文，数据库名）
DevOpenHelper helper = new DevOpenHelper(this,"notes-db-encrypted");
//获取读写（密码）
Database db = helper.getEncryptedWritableDb("super-secret")如果只要求对加密的数据库进行读的操作：
//获取读（密码）
Database db = helper.getEncryptedReadableDb("super-secret")DaoMaster和DaoSession
DaoMaster：是使用greenDAO的入口点，DaoMaster为指定的schema保存数据库对象（SQLiteDatabase）并且管理DAO类（不是对象类）。它内部的静态方法可以用来创建表或删除表，它的内部类OpenHelper 和 DevOpenHelper 是 SQLiteOpenHelper在数据库中创建schema的实现。
DaoSession：也是使用greenDAO的重要类，为指定的schema管理所有可用的DAO对象，可以使用getter方法获得DAO对象。DaoSession还提供了一些通用的持久性的方法，如插入，装载，更新，刷新和删除实体。
如果要对数据库进行操作，需要先获取相关实体类Dao对象：
daoMaster = new DaoMaster(db);
daoSession = daoMaster.newSession();
persionDao = daoSession.getPersionDao();请注意，该数据库连接属于DaoMaster，所以多个Session指向的是同一个数据库。新的Session可以相当迅速的创建。每个Session都分配内存，通常为实体的一个Session“缓存”。
如果有对同一个数据库对象的多个请求，会有几个java对象来处理？这取决于作用域，默认（如果不对他进行配置）是这多个请求会返回同一个java对象，比如，查询USER 表的 ID 42 获取User对象，会为每一个请求返回相同的结果。并且会将其缓存在内存中。如果一个实体仍然存在内存中（greenDAO对它有弱引用），该实体将不会是从数据库值再次获得，例如，如果通过其ID加载实体，但是之前已经加载过这个实体，greenDAO就不会再次询问数据库了，它会从session缓存“马上”返回此对象，这样更快一个或两个数量级。
操作
1>获取DAO
// get the note DAO
DaoSession daoSession = ((App) getApplication()).getDaoSession();
persionDao = daoSession.getPersionDao();2>插入数据：id设为null，数据库会自动为其分配自增的id：
Persion persion = new Persion(null, "liHua", 5);
persionDao.insert(persion);3>保存数据：如果key属性不为null，会更新这个对象；如果为null，会插入这个对象：
Persion persion = new Persion(2, "liHua", 5);
persionDao.save(persion);4>查询数据：
Persion persion = persionDao.queryBuilder().where(PersionDao.Properties.Name.eq("LiHua")).build().unique();unique()表示查询结果为一条数据，若数据不存在，persion为null。如果多个获取多个查询结果：
List persionList = persionDao.queryBuilder()
.where(PersionDao.Properties.Id.notEq(10)) //查询条件
.orderAsc(PersionDao.Properties.Id) //按首字母排列
.limit(10) //限制查询结果个数
.build().list(); //结果放进list中 5>删除数据：
persionDao.delete(persion);
//或
persionDao.deleteByKey(persion.getId()); 6>事务：当执行的数据较多时，可以使用事务处理，事务的方法有insertInTx(~),saveInTx(~)等后缀为-InTx的方法，其参数为多个对象：
Persion persion = new Persion(2, "liHua", 5);
Persion persion1 = new Persion(2, "liHua", 5);
Persion persion2 = new Persion(2, "liHua", 5);
persionDao.saveInTx(persion,persion1,persion2);7>更多使用方法参考greendao库中AbstractDao类。
更多参考greenDAO: Android ORM for your SQLite database