Android GreenDao（官方）

**Android GreenDao官方指南** GreenDao是一款专门为Android平台设计的高效、轻量级的对象关系映射（ORM）框架。它允许开发者将Java对象直接映射到SQLite数据库，从而简化了数据库操作，提高了开发效率。在Android应用开发中，GreenDao为开发者提供了便捷的方式来存储和检索数据，避免了对SQL语句的直接操作。 ### 一、GreenDao安装与配置 1. **添加依赖**：你需要在项目的build.gradle文件中添加GreenDao的依赖库。如果使用的是Gradle，可以在dependencies块中加入如下代码： ```groovy implementation 'org.greenrobot:greendao:3.3.0' ``` 2. **生成Dao**：运行项目前，需要配置GreenDao的生成器，创建一个继承自`org.greenrobot.greendao.database.Database`的类，例如`AppDatabase`，并标注`@Database`。然后，定义你的数据实体类，如`User`，并添加对应的`@Entity`注解。通过`DaoGenerator`生成对应的Dao类和实体类的接口。 ### 二、数据库初始化与升级 1. **初始化数据库**：在应用启动时，你需要创建一个`OpenHelper`的子类，例如`AppOpenHelper`，并在其中重写`onCreate()`和`onUpgrade()`方法，以处理数据库的创建和升级。 2. **版本管理**：在`@Database`注解中指定初始版本号，每次修改表结构时增加版本号，`onUpgrade()`中根据旧版本和新版本执行相应的更新操作。 ### 三、插入数据 1. **创建实体对象**：实例化你的数据实体，如`User user = new User();` 2. **使用Dao插入**：通过Dao对象的`insert()`方法将对象插入数据库，如`userDao.insert(user);` ### 四、查询数据 1. **基本查询**：使用`query()`方法进行基础查询，返回`List<YourEntity>`。 2. **条件查询**：可以使用`queryBuilder()`构建复杂的查询条件，如`queryBuilder().where(UserDao.Properties.Name.eq("John")).list();` 3. **分页查询**：通过`setLimit()`和`setOffset()`实现分页。 ### 五、更新数据 1. **更新单个实体**：找到要更新的实体，修改属性，然后调用`update()`方法，如`user.setName("NewName"); userDao.update(user);` 2. **批量更新**：使用`update(Iterable<T>)`方法更新符合条件的所有实体。 ### 六、删除数据 1. **删除单个实体**：通过`delete()`方法删除指定的实体，如`userDao.delete(user);` 2. **按条件删除**：构建查询条件后调用`delete()`，如`userDao.queryBuilder().where(UserDao.Properties.Id.eq(1)).build().delete();` 3. **清空表**：使用`deleteAll()`方法删除表中的所有数据。 ### 七、事务处理 GreenDao支持事务操作，可以通过`Session.beginTransaction()`开始一个事务，`Session.setTransactionSuccessful()`标记事务成功，最后`Session.endTransaction()`结束事务。这样可以确保一系列操作要么全部成功，要么全部失败。 ### 八、缓存与性能优化 1. **缓存管理**：GreenDao提供了一种缓存机制，通过`Session.load()`或`Session.loadIfNotInCache()`方法加载数据，并自动处理缓存。 2. **异步操作**：使用`AsyncSession`进行异步操作，提高应用响应速度。 GreenDao为Android开发者提供了简单、高效的数据库操作方式，通过对象化的API，使得数据库操作如同操作Java对象一样方便。理解并熟练掌握GreenDao的使用，能极大地提升Android应用的数据管理能力。