最近有幾個童鞋問我關于greendao的使用問題,以及碰見的一些坑,所以寫這篇文章來說下。
GreenDao是什么?
?? greenDAO是一個對象關系映射(ORM)的框架,能夠提供一個接口通過操作對象的方式去操作關系型數據庫,它能夠讓你操作數據庫時更簡單、更方便。
官網地址:http://greenrobot.org/greendao/
Github地址:https://github.com/greenrobot/greenDAO
?有哪些優勢?
1、性能高,號稱Android最快的關系型數據庫,比sqlite性能高30%.
2、內存占用小
3、庫文件比較小,小于100K,編譯時間低,而且可以避免65K方法限制
4、支持數據庫加密 greendao支持SQLCipher進行數據庫加密 有關SQLCipher
5、簡潔易用的API,也支持sql語句
使用流程:
第一步在項目的Project 的 buil.gradle 里設置如下
?在buildscript- repositories添加配置mavenCentral(),
在dependencies 里添加
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
buildscript {
repositories {
jcenter()
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.2'
classpath 'org.greenrobot:greendao-gradle-plugin:3.1.0'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
第二步在自己Module里 buil.gradle 里設置如下
2.1 頭部添加
apply plugin:'org.greenrobot.greendao'
2.2?在dependencies 里添加
compile'org.greenrobot:greendao:3.1.0'
compile'org.greenrobot:greendao-generator:3.1.0'
2.3在android里添加
greendao{
schemaVersion 1
daoPackage'com.example.mytest.greendao.gen'
targetGenDir'src/main/java'
}
參數說明:
schemaVersion: 數據庫schema版本,也可以理解為數據庫版本號
daoPackage:設置DaoMaster、DaoSession、Dao包名
targetGenDir:設置DaoMaster、DaoSession、Dao目錄
targetGenDirTest:設置生成單元測試目錄
generateTests:設置自動生成單元測試用例
第三步創建實體類TestBean。
在實體類上方寫上 @Entity 即可!然后不需要寫set get 方法,編譯后會自動幫我們生成.
編譯后生成的界面
Application里的設置
增刪改查的操作
先初始化
TestBeanDao testBeanDao = AppApplication.getApplication().getDaoSession().getTestBeanDao();
新增:
TestBean testBean=newTestBean(null,"zhangsan");
testBeanDao.insert(testBean);
刪除:
testBeanDao.delete(testBean);
修改:
testBeanDao.update(testBean);
查詢:
List list = testBeanDao.queryBuilder().where(TestBeanDao.Properties.Name.eq("zhangsan")).build().list(); 查詢名字叫張三的人。這種可以滿足多條件查詢。
List list = testBeanDao.loadAll();查詢所有
關于查詢還有很多方法,如notEq、between、like等一些,大家可以根據需求來用。
注解說明
1.)實體@Entity注解
schema:告知GreenDao當前實體屬于哪個schema
active:標記一個實體處于活動狀態,活動實體有更新、刪除和刷新方法
nameInDb:在數據中使用的別名,默認使用的是實體的類名
indexes:定義索引,可以跨越多個列
createInDb:標記創建數據庫表**
2.)基礎屬性注解
@Id :主鍵 Long型,可以通過@Id(autoincrement = true)設置自增長
@Property:設置一個非默認關系映射所對應的列名,默認是的使用字段名舉例:@Property (nameInDb="name")
@NotNul:設置數據庫表當前列不能為空
@Transient:添加次標記之后不會生成數據庫表的列
3.)索引注解
@Index:使用@Index作為一個屬性來創建一個索引,通過name設置索引別名,也可以通過unique給索引添加約束
@Unique:向數據庫列添加了一個唯一的約束
4.)關系注解
@ToOne:定義與另一個實體(一個實體對象)的關系
@ToMany:定義與多個實體對象的關系
(一) @Entity 定義實體
@nameInDb 在數據庫中的名字,如不寫則為實體中類名
@indexes 索引
@createInDb 是否創建表,默認為true,false時不創建
@schema 指定架構名稱為實體
@active 無論是更新生成都刷新
(二) @Id
(三) @NotNull 不為null
(四) @Unique 唯一約束
(五) @ToMany 一對多
(六) @OrderBy 排序
(七) @ToOne 一對一
(八) @Transient 不存儲在數據庫中
(九) @generated 由greendao產生的構造函數或方法
注意事項:
1、默認數據庫升級時會刪除所有的表導致數據丟失,所以在正式的項目中需要另外封裝一層,來實現數據庫的安全升級。
2、3.0之前需要通過新建GreenDaoGenerator工程生成Java數據對象(實體)和DAO對象,對象多的時候操作起來非常麻煩。GreenDao 3.0之后采用注解的方式通過編譯方式生成Java數據對象和DAO對象,配置上相對于2.0要簡單的多。
3、查詢的時候會有緩存,比如第一次和第二次,所有數據改變時需要清除緩存在查詢。testBeanDao.detachAll();
數據庫的查看可以推薦用facebook的調試工具Stetho,在無root的時候也能看手機里的數據庫、緩存、cookie等信息,在開發調試時非常方便,到時候我在下篇文章里會寫Stetho的使用教程。