1. 添加依賴:
// 在總的 build.gradle 中
buildscript {
repositories {
jcenter()
?mavenCentral() // 加入倉庫
}
dependencies {
classpath 'com.android.tools.build:gradle:2.3.1'
?classpath 'org.greenrobot:greendao-gradle-plugin:3.0.0' // 添加插件
}
}
// 在應用程序的 build.grdle 中
apply plugin: 'com.android.application'
apply plugin: 'org.greenrobot.greendao' //添加應用插件
dependencies {
compile 'org.greenrobot:greendao:3.0.1'
compile'org.greenrobot:greendao-generator:3.0.0'
}
//應用程序的 build.grdle 的 android 中
android{
????...
greendao {
schemaVersion 1//數(shù)據(jù)庫版本號
daoPackage 'com.xxx.xxx.greendao'//設(shè)置 DaoMaster设拟、DaoSession、Dao 包名
targetGenDir 'src/main/java'//設(shè)置 DaoMaster久脯、DaoSession纳胧、Dao 目錄
//targetGenDirTest:設(shè)置生成單元測試目錄
//generateTests:設(shè)置自動生成單元測試用例
????}
}
2. 使用樣例:
實體類 User
@Entity//標示是一個greenDao需要生成的類
public class User {
@Id(autoincrement = true)//標示是自增長的id,必須是Long型
private Long id;
private String name;
????private int age;
????@Transient//表示不會存儲此字段
? ? private boolean isCheck;
}
3.? 相關(guān)注解說明 :
3.1. 實體@Entity 注解
schema:告知 GreenDao 當前實體屬于哪個 schema
active:標記一個實體處于活躍狀態(tài),活動實體有更新帘撰、刪除和刷新方法
nameInDb:在數(shù)據(jù)庫中使用的別名跑慕,默認使用的是實體的類名
indexes:定義索引,可以跨越多個列
createInDb:標記創(chuàng)建數(shù)據(jù)庫表
3.2. 基礎(chǔ)屬性注解
@Id:主鍵 Long 型摧找,可以通過@Id(autoincrement = true)設(shè)置自增長
@Property:設(shè)置一個非默認關(guān)系映射所對應的列名核行,默認是使用字段名,例如:@Property(nameInDb = “name”)
@NotNull:設(shè)置數(shù)據(jù)庫表當前列不能為空
@Transient:添加此標記后不會生成數(shù)據(jù)庫表的列
3.3. 索引注解
@Index:使用@Index 作為一個屬性來創(chuàng)建一個索引蹬耘,通過 name 設(shè)置索引別名芝雪,也可以通過 unique 給索引添加約束
@Unique:向數(shù)據(jù)庫添加了一個唯一的約束
3.4. 關(guān)系注解:
@ToOne:定義與另一個實體(一個實體對象)的關(guān)系
@ToMany:定義與多個實體對象的關(guān)系
4. 當編寫好實體類并添加了注解之后,點擊Make Project或者Make Module * ,就會在自己設(shè)定的目錄下看到生成的類文件,并且
會自動生成各個屬性的 get,set 方法
5. 初始化(一般在 Application 中)
DaoMaster.DevOpenHelper openHelper=new DaoMaster.DevOpenHelper(上下文,數(shù)據(jù)庫名字);//也有三個參數(shù)的構(gòu)造,第三個參
數(shù)是游標工廠
Database db=openHelper.getWritableDb();
DaoMaster daoMaster=new DaoMaster(db);
ormDao=daoMaster.newSession();//這個 ormDao 就是要用于操作的
6. 增刪改查的操作(要 try 一下,如果有異常表示操作失敗)
6.1. 增:ormDao.get 實體類名 Dao().insert(對象);//注意,Long 型 id 如果傳入 null,則會自增長
6.2. 刪: deleteBykey(主鍵) :根據(jù)主鍵刪除一條記錄。
delete(對象) :根據(jù)實體類刪除一條記錄综苔,一般結(jié)合查詢方法惩系,查詢出一條記錄之后刪除。
deleteAll(): 刪除所有記錄如筛。
6.3. 改:update(對象);//應該是根據(jù)主鍵改的
6.4. 查: loadAll():查詢所有記錄
load(Long key):根據(jù)主鍵查詢一條記錄
queryBuilder().list():返回:List 列表
queryBuilder().where(UserDao.Properties.Name.eq(“”)).list():返回:List 列表
queryRaw(String where,String selectionArg):返回:List 列表
6.5. 高級查詢:
.orderAsc(類.字段)//按照字段進行正序排序,應該有 desc,倒序
.or()//條件或者,可以加多個條件,中間用逗號隔開
.and()//條件并且,可以加多個條件,中間用逗號隔開
queryBuilder() .offset(0* 20).limit(20).list();//分頁查詢,現(xiàn)在是查詢第 1 頁,每頁 20 條數(shù)據(jù)