GreenDao3+ 介绍
简介
GreenDao可以说是当今最流行，最高效而且还在迭代的关系型数据库。
关系型数据库：ORM(Object Relation Mapping 即 对象关系映射)，就是将面向对象编程语言里的对象与数据库关联起来的一种技术，greenDao其实就是一种将java object 与SQLite Database关联起来的桥梁
配置不介绍了，参考官网即可。
优点
1.存取速度快
2.支持数据库加密
支持android原生的数据库SQLite，也支持SQLCipher(在SQLite基础上加密型数据库)。
3.轻量级
greenDao的代码库仅仅100k大小
4.激活实体
处于激活状态下的实体可以有更多操作方法
5.支持缓存
能够将使用的过的实体存在缓存中，下次使用时可以直接从缓存中取，这样可以使性能提高N个数量级
6.代码自动生成
DaoMaster
DaoMaster 是入口类，每一个DaoMaster持有一个数据库连接，通过DaoMaster#newSession()方法可以实例化多个Session，这些Session对应同一个数据库连接，但是系统会为每一个Session分配内存，在这片内存中会为实体进行缓存。每一个Session对应一个Identity .
DaoSession
从DaoSession中可以获取各实体类的对应DAO，然后就可以进行增删改查的操作了，对于每一个Session中的查询操作都会对查到的实体类做缓存操作，所以对应同一个Session的多次查询操作，如果entity的对象在该Session中有对应缓存则直接使用，而不再从数据库中读取数据并构建新的实体类对象。
常用注解介绍
@Entity
该实例是类的注解，告诉greenDAO这个类是需要持久化的实体类。下面是其内部注解
@Entity(
// If you want to 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
)
@ID, field注解
表示选择一个long或Long类型的属性作为该实体所对应数据库中数据表的主键，参数可以设置(autoincreament=true),其实其他类型高版本也是可以的，比如String 不过应该不能自增长了。
@Property field 注解
可以自定义该属性在数据表的列名，默认的列名为属性名大写，并由下划线隔开多个单词，@Property(nameInDb="XXXX")可以自定义列名。
@NotNull
对应着数据表中该列不能为空。
@Transient
与Java中的Transient关键字类似，指不对该属性持久化，即不为该属性在数据表中创建相应列。
@Index
使用@Index 可以将一个属性变为数据库索引；其有俩个参数
name :不使用默认名称，自定义索引名称
unique : 给索引增加一个唯一约束，迫使该值唯一
@Entity
public class User {
@Id
private Long id;
@Index(unique = true)
private String name;
}
@Unique
含义与数据表中列的unique一致, 这种情况下，SQLite会自动为该列建立索引。
@Generated greenDAO
会根据开发者定义的实体类定义schema，并生成DAOs,而在生成过程中会为开发者编写的实体类的一些方法和域上添加
@Generated注解
提示开发者该属性不能被修改；并且实体类的方法，属性，构造器一旦被@Generated注释就不能被再次修改，否则或报错
此外还有@ToOne, @ToMany, @JoinEntity与多个数据表的关系有关，后面再对此详细介绍。
@Entity
public class User {
@Id(autoincrement = true)
private Long id;
@Property(nameInDb = "USERNAME")
private String name;
@NotNull
private int repos;
@Transient
private int tempUsageCount;
...}
查询list
1.list()
缓存查询结果;list()类型一般为ArrayList
2.listLazy();
懒查询,只有当调用list()中的实体对象时才会执行查询操作并且只缓存第一次被查询的结果，需要关闭
3.listlazyUncached() 懒查询,只有当调用list()中的实体对象时才会执行查询操作并且不缓存;
4.listIterator() 对查询结果进行遍历，不缓存，需要关闭;
List<City> cityList =EntityManager.getInstance().getCityDao().queryBuilder().list();
LazyList<City> cityList2 =EntityManager.getInstance().getCityDao().queryBuilder().listLazy();
cityList2.close();
List<City> cityList3 =EntityManager.getInstance().getCityDao().queryBuilder().listLazyUncached();
CloseableListIterator<City> cityList4 =EntityManager.getInstance().getCityDao().queryBuilder().listIterator();
cityList4.close();//需要try
分页查询
limit(int): 限制查询的数量;
offset(int): 每次返回的数量; offset不能单独使用；
多次查询：
即 第一次查询返回的 query 可以再次设置条件；
// fetch users with Joe as a first name born in 1970
Query<User> query = userDao.queryBuilder().where(
Properties.FirstName.eq("Joe"), Properties.YearOfBirth.eq(1970)
).build();
List<User> joesOf1970 = query.list();
// using the same Query object, we can change the parameters
// to search for Marias born in 1977 later:
query.setParameter(0, "Maria");
query.setParameter(1, 1977);
List<User> mariasOf1977 = query.list();
关联查询 joinI();
@Entity
public class City {
@Id
private Long id;
private String name;
private int population;
private Long countryId;
}
@Entity
public class Country {
@Id
private Long id;
private String name;
}
city 表示持有country 表的id
QueryBuilder<Country> qb=EntityManager.getInstance().getCountryDao().queryBuilder();
Join cities= qb.join(City.class,CityDao.Properties.CountryId)
.where(CityDao.Properties.Population.gt(1000));
List<Country> countries =qb.list();
就是 join on 只不过这里它替你写了 on 的部分，应该只是 id 才可以。
多线程查询
多条线程执行查询语句时需要调用forCurrentThread()方法将query对象与当前线程进行绑定，如果其他线程修改该Query对象，greenDao将会抛出一个异常;forCurrentThread()方法通过将Query创建时的时间作为 query标识;
先看一段代码
final Query<Country> query =EntityManager.getInstance().getCountryDao().queryBuilder().build();
new Thread(new Runnable() {
@Override
public void run() {
List<Country> countries =query.list();
for (Country c:countries){
Log.e("返回",c.getName()+Thread.currentThread().getName());
}
}
}).start();
执行后会报错，当前的query 已经绑定到主线程，这时候在子线程中调用query 会报错
08-08 15:56:44.040 4587-4614/com.green.dao E/AndroidRuntime: FATAL EXCEPTION: Thread-314
Process: com.green.dao, PID: 4587
org.greenrobot.greendao.DaoException: Method may be called only in owner thread, use forCurrentThread to get an instance for this thread
at org.greenrobot.greendao.query.AbstractQuery.checkThread(AbstractQuery.java:99)
at org.greenrobot.greendao.query.Query.list(Query.java:87)
at com.green.dao.MainActivity$1.run(MainActivity.java:98)
at java.lang.Thread.run(Thread.java:818)
这个错误是在哪里抛出的呢？看下list()源码
public List<T> list() {
checkThread();
Cursor cursor = dao.getDatabase().rawQuery(sql, parameters);
return daoAccess.loadAllAndCloseCursor(cursor);
}
protected void checkThread() {
if (Thread.currentThread() != ownerThread) {
throw new DaoException(//就是这里抛出了异常
"Method may be called only in owner thread, use forCurrentThread to get an instance for this thread");
}
}
啥意思？list(）只能在它自己的线程中调用。 错误提示很清晰了，用 forCurrentThread 给当前线程一个 query
final Query<Country> query =EntityManager.getInstance().getCountryDao().queryBuilder().build();
new Thread(new Runnable() {
@Override
public void run() {
List<Country> countries =query.forCurrentThread().list();
for (Country c:countries){
Log.e("返回",c.getName());
}
}
}).start();
这样就ok 了。大概就是每个线程要绑定自己的query
所以下面这张写法肯定没有问题啦
new Thread(new Runnable() {
@Override
public void run() {
Query<Country> query =EntityManager.getInstance().getCountryDao().queryBuilder().build();
List<Country> countries =query.list();
for (Country c:countries){
Log.e("返回",c.getName());
}
}
}).start();
Sql语句查询
方式1
Query<City> query =EntityManager.getInstance().getCityDao().queryBuilder().where(new WhereCondition.StringCondition("_ID IN"+"(SELECT _ID FROM CITY WHERE _ID=1)")).build();
City city =query.unique();
StringCondition()中的内容：_ID 可以换成任何字段，但是需要跟后面的查询内容保持一致， 虽然后面的sql 语句是如果放到数据库里查询是只能返回id 但是这里不是 而是返回所有值。注意 IN 还有sql 语句的括号。
方式2：
Query<City> query =EntityManager.getInstance().getCityDao().queryRawCreate("where _ID=?","1");
City city=query.unique();
Log.e("返回值",city.getPopulation()+"~~~"+city.getName()+"~~~"+city.getId());
方式3
List<City> citiess=EntityManager.getInstance().getCityDao().queryRaw("where _ID=?","1");
for (City city:citiess){
Log.e("返回值",city.getPopulation()+"~~~"+city.getName()+"~~~"+city.getId());
}
