GreenDao 3.X之注解

        在注解横行的时代，GreenDao 需要通过新建GreenDaoGenerator工程生成Java数据对象（实体）和DAO对象，已经追赶不上时代前行的步伐了。GreenDao 3.X的注解开发模式，终于解开它的面纱，GreenDao  3.X最大的变化就是采 用注解的方式通过编译方式生成Java数据对象和DAO对象。

Gradle配置

        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'        }        // 数据库的版本及Dao相关设置        greendao {            // 数据库schema版本，也可以理解为数据库版本号            schemaVersion 1000            //  设置DaoMaster 、DaoSession、Dao包名            daoPackage  '***'            //  设置DaoMaster 、DaoSession、Dao目录            targetGenDir 'src/main/java'              //  设置生成单元测试目录            targetGenDirTest            //  设置自动生成单元测试用例            generateTests        }

   

常用注解

@Entity -- 实体注解

            public @interface Entity {                /**                 * 在数据库中表的名称，默认为实体的类名                 */                String nameInDb() default "";                /**                 *  定义索引，可以跨越多个列(默认为实体类成员变量的个数)                 */                Index[] indexes() default {};                /**                 * 标记创建数据库表                 * 若一个表映射多个实体类或者创建表外应的GreenDao,设置为false                 */                boolean createInDb() default true;                /**                 *  告知GreenDao当前实体属于哪个schema                 */                String schema() default "default";                /**                 *  实体活动状体标志位(默认为false)                 *  若设置为true，实体有更新、删除和刷新方法                 */                boolean active() default false;            }

@NotNull

        设置表中当前列的值不可为空

@Convert

        指定自定义类型(@link PropertyConverter)

            public @interface Convert {                /** 转换类*/                Class<? extends PropertyConverter> converter();                /**                 * 在数据库中持久化的列                 * 此受限于GreenDao所支持的类                 */                Class columnType();            }

@Generated

        GreenDao运行所产生的构造函数或者方法，被此标注的代码可以变更或者下次运行时清除

            public @interface Generated {                int hash() default -1;            }

@Id

        主键 Long型，可以通过@Id(autoincrement = true)设置自增长。通过这个注解标记的字段必须是Long，数据库中表示它就是主键，并且默认是自增的。

        public @interface Id {            /**              * 设置是否为自增长，默认为false              */            boolean autoincrement() default false;        }

@Index

        使用@Index作为一个属性来创建一个索引；定义多列索引(@link Entity#indexes())

            public @interface Index {                /**                 * 通过逗号间隔创建表的属性索引，例如 “propertyA，propertyB，propertyC”                 * 若要指定排序, 需在列明以后添加 ASC(升序) 或者DESC(降序) ,  例如 "propertyA DESC, propertyB ASC"                 *  只有实体类中使用 {@link Entity#indexes()} 才可设置                 */                String value() default "";                /**                 * 表的可选索引                 * 默认为实体类中的成员变量                 */                String name() default "";                /**                 * 是否为属性设置唯一属性，默认为false                 */                boolean unique() default false;            }

@JoinEntity

        定义表连接关系

            public @interface JoinEntity {                /** 添加的实体类 */                Class<?> entity();                /** 源表的列索引 */                String sourceProperty();                /** 连接表内拥有源实体的属性*/                String targetProperty();            }

@JoinProperty

        定义名称和引用名称属性关系

            public @interface JoinProperty {                /** 实体中的名称，对应于引用的名称 */                String name();                /** 引用的名称 */                String referencedName();            }

@Keep

         注解的代码段在GreenDao下次运行时保持不变

         1.注解实体类：默认禁止修改此类
          2.注解其他代码段，默认禁止修改注解的代码段

@OrderBy

         指定排序

            public @interface OrderBy {                /**                 * 通过逗号间隔创建表的属性索引，例如 “propertyA，propertyB，propertyC”                 * 若要指定排序, 需在列明以后添加 ASC(升序) 或者DESC(降序) ,  例如 "propertyA DESC, propertyB ASC"                 *  默认按升序排序                 *  若不设置默认根据主键排序                 */                String value() default "";            }

@Property

        设置一个非默认关系映射所对应的列名，默认是的使用字段名 举例：@Property (nameInDb="name")

            public @interface Property {                /**                 * 默认是的使用字段名                 */                String nameInDb() default "";            }          

@ToMany

        定义与多个实体对象的关系

            public @interface ToMany {                /**                 * 目标实体持有源实体的名称                 * 此必须设置，否则有 {@link JoinProperty} or {@link JoinEntity} 指定                 */                String referencedJoinProperty() default "";                /**                 * 将源表列索引->目标列                 * 此必须设置，否则有 {@link JoinProperty} or {@link JoinEntity} 指定                 */                JoinProperty[] joinProperties() default {};            }

@ToOne

        定义与另一个实体（一个实体对象）的关系

            public @interface ToOne {                /**                 * 表中相关实体的属性名称                 * 如果该参数不存在，则附加列会自动创建保存密钥                 */                String joinProperty() default "";            }

@Transient

        添加次标记之后不会生成数据库表的列

@Unique

        向数据库列添加了一个唯一的约束

       

        现对GreenDao 3.X的改动已经有了初步了解，尤其是各个注解的含义，后续深入了解GreenDao 3.0如何使用。

参考文档

        1、官方文档

        2.、GreenDAO 3.0 初次使用