首页 > 代码库 > Android GreenDAO3.0——entity建模

Android GreenDAO3.0——entity建模

引言

在项目中,为了使用GreenDAO的自动生成DAO class的功能,我们必须建立entity,该entity通过java注解标识。

                                                           技术分享

 

Schema是数据库对象集合,我们可以通过gradle插件配置GreenDAO,除此之外,我们至少需要配置Schema的版本

// In the build.gradle file of your app project:
android {
...
}

greendao {
    schemaVersion 2
}

我们不仅可以配置schemaVersion,还可以配置其他的属性:

daoPackageDAOs、DAOMaster和DAOSession生成的目录,默认是entity所在的目录

targetGenDir:默认在build/generated/source/greendao

其他......(貌似不重要)

@Entity

在Android项目中,GreenDAO通过注解表征entity:

public class User {
    @Id
    private Long id;
 
    private String name;
 
    @Transient
    private int tempUsageCount; // not persisted
 
   // getters and setters for id and user ...
}

我们通过@Entity对User进行注解,GreenDAO通过识别@Entity在编译期生成支持数据库的对象。                

@Entity还支持一些属性,对该对象进行描述,此时我们对上述代码进行扩展:

@Entity(
        // If you have more than one schema, you can tell greenDAO
        // to which schema an entity belongs (pick any string as a name).
        schema = "myschema",
        
        // Flag to make an entity "active": Active entities have update,
        // delete, and refresh methods.
        active = true,
        
        // Specifies the name of the table in the database.
        // By default, the name is based on the entities class name.
        nameInDb = "AWESOME_USERS",
        
        // Define indexes spanning multiple columns here.
        indexes = {
                @Index(value = "name DESC", unique = true)
        },
        
        // Flag if the DAO should create the database table (default is true).
        // Set this to false, if you have multiple entities mapping to one table,
        // or the table creation is done outside of greenDAO.
        createInDb = false,
 
        // Whether an all properties constructor should be generated.
        // A no-args constructor is always required.
        generateConstructors = true,
 
        // Whether getters and setters for properties should be generated if missing.
        generateGettersSetters = true
)
public class User {
  ...
}

基本属性

@Entity
public class User {
    @Id(autoincrement = true)
    private Long id;
 
    @Property(nameInDb = "USERNAME")
    private String name;
 
    @NotNull
    private int repos;
 
    @Transient
    private int tempUsageCount;
 
    ...
}

 @Id:对于数据库来说,在数据表中作为主键,类型默认为long型,autoincrement =true使得id自增。

@Property :将java class中的字段名映射为Property 提供的名字,在上述代码中就是将name映射为USERNAME,默认情况下,如果字段是驼峰命名转为下划线命名,如customName 转换为                                CUSTOM_NAME。

@NotNull: 标记基本类型为非空。

@Transient  :表示java class中的该字段不会存储在数据库中,是一个缓存值。

索引

如果我们不喜欢,GreenDAO定制的默认索引,我们可以自行设置新的索引,这是需要属性@index。

@Entity
public class User {
    @Id private Long id;
    @Index(unique = true)
    private String name;
}

id是数据库的唯一索引,即主键。但我们可以通过unique = true,指定name索引也是唯一的。

 

 

Android GreenDAO3.0——entity建模