Android 数据库ORM框架GreenDao学习心得及使用总结<一>

简介: 转: http://www.it165.net/pro/html/201401/9026.html   最近在对开发项目的性能进行优化。由于项目里涉及了大量的缓存处理和数据库运用,需要对数据库进行频繁的读写、查询等操作。

转:

http://www.it165.net/pro/html/201401/9026.html

 

  • 最近在对开发项目的性能进行优化。由于项目里涉及了大量的缓存处理和数据库运用,需要对数据库进行频繁的读写、查询等操作。因此首先想到了对整个项目的数据库框架进行优化。

    原先使用android本身内置的sqllite,也就是用的最基本的SQLiteOpenHelper方法,这种方法对自己来说比较方便易懂。但是在使用过程中感觉很繁琐,从建表到对表的增删改查等操作,如果表对象的属性很多,就需要使用大量的代码来执行建表、插入等。在代码执行中还需要对数据库和游标的进行及时关闭(开启使用,用完关闭),而且还需要部分sql语言,这在开发中产生bug进行调试时尤其不方便。

    目前android经常用的orm框架主要有greenDAO、OrmLite、AndrORM。 综合了网上的各种评价,greenDAO的运行效率最高,内存消耗最少,性能最佳。因此决定采用greenDAO框架,对项目的orm框架进行改进。

    wKioL1LjvcbQqp7UAALzTaGquzw329.jpg

    greenDAO与ORMLite性能对比

     

    经过两天的修改,终于将项目里的数据库相关的都优化完了。在这过程中,发现greenDAO的性能确实不错,而且使用相当方便,不再需要涉及到任何的sql语言,可以直接通过对象类进行建表、增删改查等,尤其是api接口又方便易懂。在摸索学习中发现国内相关学习资料实在实在是太少,遂决定在此记录下自己对使用这个orm框架的一些心得和方法总结。

     

    一、greenDAO相关

    1.greenDAO官网:http://greendao-orm.com/

    2.项目下载地址:https://github.com/greenrobot/greenDAO(或者官网)

    greenDAO是一个可以帮助Android开发者快速将Java对象映射到SQLite数据库的表单中的ORM解决方案,通过使用一个简单的面向对象API,开发者可以对Java对象进行存储、更新、删除和查询。

    greenDAO的主要设计目标:

    *最大性能(最快的Android ORM)

    *易于使用API

    *高度优化

    *最小内存消耗

    二、使用步骤

    官方Demo里共有六个工程目录,分别为:

    (1).DaoCore:库目录,即jar文件greendao-1.3.0-beta-1.jar的代码;

    (2).DaoExample:android范例工程;

    (3).DaoExampleGenerator:DaoExample工程的DAO类构造器,java工程;

    (4).DaoGenerator:DAO类构造器,java工程;

    (5).DaoTest、PerformanceTestOrmLite:其他测试相关的工程。

     

    (一)DAO类构造

    首先需要新建一个java工程来生成DAO类文件,该工程需要导入greendao-generator.jar和freemarker.jar文件到项目中。

     

    01. package de.greenrobot.daogenerator.gentest;
    02. import de.greenrobot.daogenerator.DaoGenerator;
    03. import de.greenrobot.daogenerator.Entity;
    04. import de.greenrobot.daogenerator.Property;
    05. import de.greenrobot.daogenerator.Schema;
    06. import de.greenrobot.daogenerator.ToMany;
    07. /**
    08. * Generates entities and DAOs for the example project DaoExample.
    09. *
    10. * Run it as a Java application (not Android).
    11. *
    12. * @author Markus
    13. */
    14. public class ExampleDaoGenerator
    15. {
    16.  
    17. public static void main(String[] args) throws Exception
    18. {
    19. Schema schema = new Schema(3"de.greenrobot.daoexample");
    20.  
    21. addNote(schema);
    22. addCustomerOrder(schema);
    23.  
    24. new DaoGenerator().generateAll(schema, "../DaoExample/src-gen");
    25. }
    26.  
    27. private static void addNote(Schema schema)
    28. {
    29. Entity note = schema.addEntity("Note");
    30. note.addIdProperty();
    31. note.addStringProperty("text").notNull();
    32. note.addStringProperty("comment");
    33. note.addDateProperty("date");
    34. }
    35.  
    36. private static void addCustomerOrder(Schema schema)
    37. {
    38. Entity customer = schema.addEntity("Customer");
    39. customer.addIdProperty();
    40. customer.addStringProperty("name").notNull();
    41.  
    42. Entity order = schema.addEntity("Order");
    43. order.setTableName("ORDERS"); // "ORDER" is a reserved key<a href="http://www.it165.net/edu/ebg/" target="_blank" class="keylink">word</a>
    44. order.addIdProperty();
    45. Property orderDate = order.addDateProperty("date").getProperty();
    46. Property customerId = order.addLongProperty("customerId").notNull().getProperty();
    47. order.addToOne(customer, customerId);
    48.  
    49. ToMany customerToOrders = customer.addToMany(order, customerId);
    50. customerToOrders.setName("orders");
    51. customerToOrders.orderAsc(orderDate);
    52. }
    53.  
    54. }

     

    在main方法中,

     

    1. Schema schema = new Schema(3"de.greenrobot.daoexample");

    该方法第一个参数用来更新数据库版本号,第二个参数为要生成的DAO类所在包路径。

     

    然后进行建表和设置要生成DAO文件的目标工程的项目路径。

     

     

    addNote(schema);
    addCustomerOrder(schema);
    new DaoGenerator().generateAll(schema, "../DaoExample/src-gen");

    其中src-gen这个目录名需要在运行前手动创建,否则会报错。

     

    如果运行后出现以下错误,则导入DaoGenerator项目的dao.ftl文件即可(或者直接使用DaoGenerator来生成DAO文件)。

     

    1. Exception in thread "main" java.io.FileNotFoundException: Template "dao.ftl" not found.
    2. at freemarker.template.Configuration.getTemplate(Configuration.java:742)
    3. at freemarker.template.Configuration.getTemplate(Configuration.java:665)
    4. at de.greenrobot.daogenerator.DaoGenerator.<init>(DaoGenerator.java:68)
    5. at de.greenrobot.daogenerator.gentest.ExampleDaoGenerator.main(ExampleDaoGenerator.java:41)

     

    运行后出现以下的提示说明DAO文件自动生成成功了,刷新一下DaoExample项目即可看到。

     

    01. greenDAO Generator
    02. Copyright 2011-2013 Markus Junginger, greenrobot.de. Licensed under GPL V3.
    03. This program comes with ABSOLUTELY NO WARRANTY
    04. Processing schema version 3...
    05. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\NoteDao.java
    06. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\Note.java
    07. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\CustomerDao.java
    08. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\Customer.java
    09. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\OrderDao.java
    10. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\Order.java
    11. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\DaoMaster.java
    12. Written F:\Android_Ex\work_10\DaoExample\src-gen\de\greenrobot\daoexample\DaoSession.java
    13. Processed 3 entities in 204ms

     

    运行后可以看到,DaoExample项目src-gen下面自动生成了8个文件,3个实体对象,3个dao,1个DaoMaster,1个DaoSession.

     

    (二)创建表

    1.创建一个实体类

     

    Entity note = schema.addEntity("Note");

    默认表名就是类名,也可以自定义表名

     

    1. dao.setTableName("NoteList");

    greenDAO会自动根据实体类属性创建表字段,并赋予默认值。例如在数据库方面的表名和列名都来源于实体类名和属性名。默认的数据库名称是大写使用下划线分隔单词,而不是在Java中使用的驼峰式大小写风格。例如,一个名为“CREATIONDATE”属性将成为一个数据库列“CREATION_DATE”。

     

    设置一个自增长ID列为主键:

     

    1. dao.addIdProperty().primaryKey().autoincrement();

     

    设置其他各种类型的属性:

     

    dao.addIntProperty("cityId");
    dao.addStringProperty("infoType").notNull();//非null字段
    dao.addDoubleProperty("Id");

    在生成的实体类中,int类型为自动转为long类型。

    如果在编译过程中出现以下错误,那么有可能是主键的类型错误所致:

    1. java.lang.ClassCastException: java.lang.Integer cannot be cast to java.lang.String

     

    在使用greenDAO时,一个实体类只能对应一个表,目前没法做到一个表对应多个实体类,或者多个表共用一种对象类型。后续的升级也不会针对这一点进行扩展。

     

    (二)表的增删改查

    增删改查相当方便,完全的面向对象,不需要涉及到任何的sql语言。

    1.查询

    范例1:查询某个表是否包含某个id:

     

    1. public boolean isSaved(int ID)
    2. {
    3. QueryBuilder<SaveList> qb = saveListDao.queryBuilder();
    4. qb.where(Properties.Id.eq(ID));
    5. qb.buildCount().count();
    6. return qb.buildCount().count() > 0 true false;
    7. }

     

    范例2:获取整个表的数据集合,一句代码就搞定!

     

    public List<PhotoGalleryDB> getPhotoGallery()
    {
        return photoGalleryDao.loadAll();// 获取图片相册
    }

     

    范例3:通过一个字段值查找对应的另一个字段值(为简便直接使用下面方法,也许有更简单的方法,尚未尝试)

     

     

    01. /** 通过图片id查找其目录id */
    02. public int getTypeId(int picId)
    03. {
    04. QueryBuilder<PhotoGalleryDB> qb = photoGalleryDao.queryBuilder();
    05. qb.where(Properties.Id.eq(picId));
    06. if (qb.list().size() > 0)
    07. {
    08. return qb.list().get(0).getTypeId();
    09. }
    10. else
    11. {
    12. return -1;
    13. }
    14. }

     

    范例4:查找所有第一姓名是“Joe”并且以lastname排序。

     

    1. List joes = userDao.queryBuilder()
    2. .where(Properties.FirstName.eq("Joe"))
    3. .orderAsc(Properties.LastName)
    4. .list();

     

    范例5:多重条件查询

    (1)获取id为cityId并且infotype为HBContant.CITYINFO_SL的数据集合:

     

     

    1. public List<CityInfoDB> getSupportingList(int cityId)
    2. {
    3. QueryBuilder<CityInfoDB> qb = cityInfoDao.queryBuilder();
    4. qb.where(qb.and(Properties.CityId.eq(cityId),Properties.InfoType.eq(HBContant.CITYINFO_SL)));
    5. qb.orderAsc(Properties.Id);// 排序依据
    6. return qb.list();
    7. }

     

    (2)获取firstname为“Joe”并且出生于1970年10月以后的所有user集合:

     

    1. QueryBuilder qb = userDao.queryBuilder();
    2. qb.where(Properties.FirstName.eq("Joe"),
    3. qb.or(Properties.YearOfBirth.gt(1970),
    4. qb.and(Properties.YearOfBirth.eq(1970), Properties.MonthOfBirth.ge(10))));
    5. List youngJoes = qb.list();

     

    范例6:获取某列对象

    1. picJsonDao.loadByRowId(picId);

     

     

    2.增添/插入、修改

    插入数据更加简单,也是只要一句代码便能搞定!

     

    1. public void addToPhotoTable(Photo p)
    2. {
    3. photoDao.insert(p);
    4. }

     

    插入时需要new一个新的对象,范例如下:

     

    1. DevOpenHelper helper = new DaoMaster.DevOpenHelper(this"notes-db"null);
    2. db = helper.getWritableDatabase();
    3. daoMaster = new DaoMaster(db);
    4. daoSession = daoMaster.newSession();
    5. noteDao = daoSession.getNoteDao();
    6. Note note = new Note(null, noteText, comment, new Date());
    7. noteDao.insert(note);

     

    修改更新:

    1. photoDao.insertOrReplace(photo);
    2. photoDao.insertInTx(photo);

     

    3.删除:

    (1)清空表格数据

     

    1. /** 清空相册图片列表的数据 */
    2. public void clearPhoto()
    3. {
    4. photoDao.deleteAll();
    5. }

     

    (2)删除某个对象

    1. public void deleteCityInfo(int cityId)
    2. {
    3. QueryBuilder<DBCityInfo> qb = cityInfoDao.queryBuilder();
    4. DeleteQuery<DBCityInfo> bd = qb.where(Properties.CityId.eq(cityId)).buildDelete();
    5. bd.executeDeleteWithoutDetachingEntities();
    6. }

     

    参考:https://github.com/greenrobot/greenDAO/issues/34

     

    由上可见,使用greenDAO进行数据库的增删改查时及其方便,而且性能极佳。

     

    (三)常用方法笔记

    1.在Application实现得到DaoMaster和DaoSession的方法:

     

    01. private static DaoMaster daoMaster;
    02. private static DaoSession daoSession;
    03. /**
    04. * 取得DaoMaster
    05. *
    06. * @param context
    07. * @return
    08. */
    09. public static DaoMaster getDaoMaster(Context context)
    10. {
    11. if (daoMaster == null)
    12. {
    13. OpenHelper helper = new DaoMaster.DevOpenHelper(context, HBContant.DATABASE_NAME, null);
    14. daoMaster = new DaoMaster(helper.getWritableDatabase());
    15. }
    16. return daoMaster;
    17. }
    18. /**
    19. * 取得DaoSession
    20. *
    21. * @param context
    22. * @return
    23. */
    24. public static DaoSession getDaoSession(Context context)
    25. {
    26. if (daoSession == null)
    27. {
    28. if (daoMaster == null)
    29. {
    30. daoMaster = getDaoMaster(context);
    31. }
    32. daoSession = daoMaster.newSession();
    33. }
    34. return daoSession;
    35. }

     

    2.增删改查工具类:

    01. public class DBHelper
    02. {
    03. private static Context mContext;
    04. private static DBHelper instance;
    05.  
    06. private CityInfoDBDao cityInfoDao;
    07.  
    08. private DBHelper()
    09. {
    10. }
    11.  
    12. public static DBHelper getInstance(Context context)
    13. {
    14. if (instance == null)
    15. {
    16. instance = new DBHelper();
    17. if (mContext == null)
    18. {
    19. mContext = context;
    20. }
    21.  
    22. // 数据库对象
    23. DaoSession daoSession = HBApplication.getDaoSession(mContext);
    24. instance.cityInfoDao = daoSession.getCityInfoDBDao();
    25. }
    26. return instance;
    27. }
    28.  
    29. /** 添加数据 */
    30. public void addToCityInfoTable(CityInfo item)
    31. {
    32. cityInfoDao.insert(item);
    33. }
    34.  
    35. /** 查询 */
    36. public List<EstateLoveListJson> getCityInfoList()
    37. {
    38. QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
    39. return qb.list();
    40. }
    41.  
    42. /** 查询 */
    43. public List<CityInfo> getCityInfo()
    44. {
    45. return cityInfoDao.loadAll();// 查找图片相册
    46. }
    47.  
    48. /** 查询 */
    49. public boolean isSaved(int Id)
    50. {
    51. QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
    52. qb.where(Properties.Id.eq(Id));
    53. qb.buildCount().count();
    54. return qb.buildCount().count() > 0 true false;// 查找收藏表
    55. }
    56.  
    57. /** 删除 */
    58. public void deleteCityInfoList(int Id)
    59. {
    60. QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
    61. DeleteQuery<CityInfo> bd = qb.where(Properties.Id.eq(Id)).buildDelete();
    62. bd.executeDeleteWithoutDetachingEntities();
    63. }
    64.  
    65. /** 删除 */
    66. public void clearCityInfo()
    67. {
    68. cityInfoDao.deleteAll();
    69. }
    70.  
    71. /** 通过城市id查找其类型id */
    72. public int getTypeId(int cityId)
    73. {
    74. QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
    75. qb.where(Properties.Id.eq(cityId));
    76. if (qb.list().size() > 0)
    77. {
    78. return qb.list().get(0).getTypeId();
    79. }
    80. else
    81. {
    82. return 0;
    83. }
    84. }
    85.  
    86. /** 多重查询 */
    87. public List<CityInfo> getIphRegionList(int cityId)
    88. {
    89. QueryBuilder<CityInfoDB> qb = cityInfoDao.queryBuilder();
    90. qb.where(qb.and(Properties.CityId.eq(cityId), Properties.InfoType.eq(HBContant.CITYINFO_IR)));
    91. qb.orderAsc(Properties.Id);// 排序依据
    92. return qb.list();
    93. }
    94. }

     

     

    另外,还有多表关联、惰性加载等功能,待后续研究。

    参考资料:

    1.https://github.com/greenrobot/greenDAO

    2.http://greendao-orm.com/documentation/how-to-get-started/

    3.http://blog.csdn.net/krislight/article/details/9391455

目录
相关文章
|
1月前
|
网络协议 关系型数据库 MySQL
如何实现无公网ip远程访问本地安卓Termux部署的MySQL数据库【内网穿透】
如何实现无公网ip远程访问本地安卓Termux部署的MySQL数据库【内网穿透】
|
1月前
|
SQL 存储 关系型数据库
【MySQL 数据库】11、学习 MySQL 中的【锁】
【MySQL 数据库】11、学习 MySQL 中的【锁】
76 0
|
2月前
|
存储 人工智能 Cloud Native
阿里云瑶池数据库训练营权益:《玩转Lindorm》学习资料开放下载!
阿里云瑶池数据库训练营权益:《玩转Lindorm》学习资料开放下载!
|
2月前
|
存储 关系型数据库 MySQL
MySQL技能完整学习列表5、数据库操作——1、创建数据库和表——2、修改表结构(ALTER TABLE)
MySQL技能完整学习列表5、数据库操作——1、创建数据库和表——2、修改表结构(ALTER TABLE)
183 0
|
1月前
|
SQL 关系型数据库 MySQL
【MySQL 数据库】4、MySQL 事务学习
【MySQL 数据库】4、MySQL 事务学习
44 0
|
16天前
|
SQL 关系型数据库 MySQL
轻松入门MySQL:深入学习数据库表管理,创建、修改、约束、建议与性能优化(3)
轻松入门MySQL:深入学习数据库表管理,创建、修改、约束、建议与性能优化(3)
|
1月前
|
SQL 数据库 内存技术
学习数据库要掌握的54条SQL查询语句
学习数据库要掌握的54条SQL查询语句
14 0
|
1月前
|
存储 SQL 数据库
【Android 从入门到出门】第六章:使用Room数据库并测试
【Android 从入门到出门】第六章:使用Room数据库并测试
29 4
|
1月前
|
网络协议 关系型数据库 MySQL
安卓手机termux上安装MariaDB数据库并实现公网环境下的远程连接
安卓手机termux上安装MariaDB数据库并实现公网环境下的远程连接
|
1月前
|
存储 SQL 关系型数据库
【MySQL 数据库】6、一篇文章学习【索引知识】,提高大数据量的查询效率【文末送书】
【MySQL 数据库】6、一篇文章学习【索引知识】,提高大数据量的查询效率【文末送书】
56 0