1、配置
1.1 在project的Gradle中配置:
buildscript {
repositories {
jcenter()
mavenCentral()// 添加这一行
}
dependencies {
classpath'com.android.tools.build:gradle:2.3.3'
classpath'org.greenrobot:greendao-gradle-plugin:3.2.2' // 添加这一行
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
1.2 在app的Gradle中配置:
applyplugin:'com.android.application'
applyplugin:'org.greenrobot.greendao'// 添加这一行
dependencies {
compile'org.greenrobot:greendao:3.2.2'// 添加依赖
}
1.3 在app的Gradle配置数据库版本等信息
greendao {
schemaVersion 1 // 指定数据库schema版本号,迁移等操作会用到;
daoPackage 'com.greendao.gen' //dao的包名,包名默认是entity所在的包;
targetGenDir 'src/main/java' //生成数据库文件的目录;
}
2、在项目中定义实体类
# User.java
@Entity
public classUser {
@Id
private long id;
@Property(nameInDb="USERNAME")
@NotNull
private String name;
@Unique
private String mobile;
private int gender;
private int age;
private Date birthday;
@Transient
private String remarks;
}
注解:
@Entity 标识实体类,greenDAO会映射成sqlite的一个表,表名为实体类名的大写形式
@Id 标识主键,该字段的类型为long或Long类型,autoincrement设置是否自动增长
@Property 标识该属性在表中对应的列名称, nameInDb设置名称
@Transient 标识该属性将不会映射到表中,也就是没有这列
@NotNull 设置表中当前列的值不可为空
@Convert 指定自定义类型(@linkPropertyConverter)
@Generated greenDAO运行所产生的构造函数或者方法,被此标注的代码可以变更或者下次运行时清除
@Index 使用@Index作为一个属性来创建一个索引;定义多列索引(@link Entity#indexes())
@JoinEntity 定义表连接关系
@JoinProperty 定义名称和引用名称属性关系
@Keep 注解的代码段在GreenDao下次运行时保持不变
1.注解实体类:默认禁止修改此类
2.注解其他代码段,默认禁止修改注解的代码段
@OrderBy 指定排序
@ToMany 定义与多个实体对象的关系
@ToOne 定义与另一个实体(一个实体对象)的关系
@Unique 向数据库列添加了一个唯一的约束
定义好了之后按ctrl+F9(或者工具栏build下面的Make Project)对项目进行重新构建,在daoPackage的目录下就会自动生成代码
3、使用
# App.java
public class App extends Application {
private DaoMaster.DevOpenHelper mHelper;
private SQLiteDatabase db;
private DaoMaster mDaoMaster;
private DaoSession mDaoSession;
public static App instances;
public static App getInstances() {
return instances;
}
@Override
public voidonCreate() {
super.onCreate();
instances=this;
setDatabase();
}
/**
* 设置greenDao
*/
private void setDatabase() {
// 通过 DaoMaster 的内部类 DevOpenHelper,你可以得到一个便利的 SQLiteOpenHelper 对象。
// 可能你已经注意到了,你并不需要去编写「CREATE TABLE」这样的 SQL 语句,因为 greenDAO 已经帮你做了。
// 注意:默认的 DaoMaster.DevOpenHelper 会在数据库升级时,删除所有的表,意味着这将导致数据的丢失。
// 所以,在正式的项目中,你还应该做一层封装,来实现数据库的安全升级。
mHelper=new DaoMaster.DevOpenHelper(this,"myproject-db", null);
db=mHelper.getWritableDatabase();
// 注意:该数据库连接属于 DaoMaster,所以多个 Session 指的是相同的数据库连接。
mDaoMaster=new DaoMaster(db);
mDaoSession=mDaoMaster.newSession();
}
public DaoSession getDaoSession() {
return mDaoSession;
}
public SQLiteDatabase getDb() {
return db;
}
}
# MainActivity.java
获取UserDao对象:
UserDao mUserDao = MyApplication.getInstances().getDaoSession().getUserDao();
增
User mUser=new User((long)1,"豆浆油条","18601952581",1,28,TimeUtils.strToDate("1990-01-01"));
mUserDao.insertOrReplace(mUser);//添加一个
删
mUserDao.deleteByKey(id); // 根据ID删除
mUserDao.deleteAll(); // 删除所有
改
User mUser=new User((long)1,"煎饼果子","18601952581",1,28,TimeUtils.strToDate("1990-09-23"));
mUserDao.update(mUser);
查
List
User mUser =mUserDao.loadByRowId(id); // 根据ID查询一条