Android开发数据库之第三方ORM框架(GreenDao)

     移动APP追求追求功能实现的同一时候,用户体验很重要。開始APP的同一时候。要时刻的切换开发人员的角色,如你开发的时候。是

站在APP的开发角色,处于生产者的位置;当你測试的时候。你应该把自己放在用户的角色上去考虑所做的APP了。举一个非常easy的

样例,就像我们天天使用手机上的新闻、好友动态等,当你没有网络的时候,也还有数据的存在提供用户浏览,而不是一篇”白

色“的。如同电脑死机一般。这就是移动APP在开发的时候,提供了最后一次网络状态下的数据缓存,提到数据缓存,可想而知有内

存缓存、硬件缓存之分。在这我主要讲述的是一个硬件缓存-----Android开发数据库之第三方ORM框架(GreenDao)。

     开发了那么久的移动APP。近期工作量比較小,闲着没事在对开发项目的性能进行优化。因为项目里涉及了大量的缓存处理和数

据库运用,须要对数据库进行频繁的读写、查询等操作。因此首先想到了对整个项目的数据库框架进行优化。

原先使用android本身

内置的sqllite,也就是用的最主要的SQLiteOpenHelper方法,这样的方法对自己来说比較方便易懂。

可是在使用过程中感觉非常繁琐,

从建表到对表的增删改查等操作,假设表对象的属性非常多,就须要使用大量的代码来运行建表、插入等。在代码运行中还须要对数

据库和游标的进行及时关闭(开启使用,用完关闭),并且还须要部分sql语言。这在开发中产生bug进行调试时尤其不方便。眼下

android经经常使用的orm框架主要有greenDAO、OrmLite、AndrORM。 综合了网上的各种评价,greenDAO的执行效率最高。内存消耗最

少,性能最佳。

因此决定採用greenDAO框架。对项目的orm框架进行改进。

       何以体现greenDAO的优势呢?以下 greenDAO与ORMLite性能对照:

            wKioL1LjvcbQqp7UAALzTaGquzw329.jpg

       经过几天的改动,最终将项目里的数据库相关的都优化完了。

在这过程中,发现greenDAO的性能确实不错,并且使用相当方便。不再须要涉及到不论什么的sql语言。能够直接通过对象类进行建表、增删改查等。尤其是api接口又方便易懂。在摸索学习中发现国内相关学习资料实在实在是太少,遂决定在此记录下自己对使用这个orm框架的一些心得和方法总结。


一、greenDAO框架相关资源

       首先greenDAO作为第三方的数据库ORM框架。那必然有它的相关站点等资源。

       1、greenDAO官网:http://greendao-orm.com/    
       2、项目下载地址:https://github.com/greenrobot/greenDAO(或者官网)
greenDAO是一个能够帮助Android开发人员高速将Java对象映射到SQLite数据库的表单中的ORM解决方式,通过使用一个简单的面向对象API,开发人员能够对Java对象进行存储、更新、删除和查询。


greenDAO的主要设计目标:
*最大性能(最快的Android ORM)
*易于使用API
*高度优化
*最小内存消耗


二、开发使用步骤(重点)

        1、下载greenDAO框架资源后,解压分析官方Demo里共同拥有六个project文件夹,分别为:
(1).DaoCore:库文件夹,即jar文件greendao-1.3.0-beta-1.jar的代码。
(2).DaoExample:android范例project。
(3).DaoExampleGenerator:DaoExampleproject的DAO类构造器。javaproject;
(4).DaoGenerator:DAO类构造器。javaproject;
(5).DaoTest、PerformanceTestOrmLite:其它測试相关的project。

        2、DAO类构造
首先须要新建一个javaproject来生成DAO类文件。该project须要导入greendao-generator.jar和freemarker.jar文件到项目中。

                 public class ExampleDaoGenerator
{
 
public static void main(String[] args) throws Exception
{
Schema schema = new Schema(3, "de.greenrobot.daoexample");
 
addNote(schema);
addCustomerOrder(schema);
 
new DaoGenerator().generateAll(schema, "../DaoExample/src-gen");
}
 
private static void addNote(Schema schema)
{
Entity note = schema.addEntity("Note");
note.addIdProperty();
note.addStringProperty("text").notNull();
note.addStringProperty("comment");
note.addDateProperty("date");
}
 
private static void addCustomerOrder(Schema schema)
{
Entity customer = schema.addEntity("Customer");
customer.addIdProperty();
customer.addStringProperty("name").notNull();
Entity order = schema.addEntity("Order");
order.setTableName("ORDERS"); // "ORDER" is a reserved key<a href="http://www.it165.net/edu/ebg/" target="_blank" class="keylink">word</a>
order.addIdProperty();
Property orderDate = order.addDateProperty("date").getProperty();
Property customerId = order.addLongProperty("customerId").notNull().getProperty();
order.addToOne(customer, customerId);
ToMany customerToOrders = customer.addToMany(order, customerId);
customerToOrders.setName("orders");
customerToOrders.orderAsc(orderDate);
}
}

           在main方法中。分析例如以下:

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

                                该方法第一个參数用来更新数据库版本,第二个參数为要生成的DAO类所在包路径。
            然后进行建表和设置要生成DAO文件的目标project的项目路径。

                                addNote(schema);
            addCustomerOrder(schema);
            new DaoGenerator().generateAll(schema, "../DaoExample/src-gen");
            当中src-gen这个文件夹名须要在执行前手动创建。否则会报错。
           假设执行后出现下面错误,则导入DaoGenerator项目的dao.ftl文件就可以(或者直接使用DaoGenerator来生成DAO文件)。

                执行后出现下面的提示说明DAO文件自己主动生成成功了。刷新一下DaoExample项目就可以看到。

                                

             执行后能够看到。DaoExample项目src-gen以下自己主动生成了8个文件,3个实体对象。3个dao,1个DaoMaster,1个DaoSession.


       3、创建表
创建一个实体类
Entity note = schema.addEntity("Note");
默认表名就是类名。也能够自己定义表名
dao.setTableName("NoteList");
greenDAO会自己主动依据实体类属性创建表字段,并赋予默认值。

比如在数据库方面的表名和列名都来源于实体类名和属性名。默认的数据库名称是大写使用下划线分隔单词,而不是在Java中使用的驼峰式大写和小写风格。比如,一个名为“CREATIONDATE”属性将成为一个数据库列“CREATION_DATE”。


设置一个自增长ID列为主键:
dao.addIdProperty().primaryKey().autoincrement();
设置其它各种类型的属性:
dao.addIntProperty("cityId");
dao.addStringProperty("infoType").notNull();//非null字段
dao.addDoubleProperty("Id");
在生成的实体类中,int类型为自己主动转为long类型。


假设在编译过程中出现下面错误,那么有可能是主键的类型错误所致:
java.lang.ClassCastException: java.lang.Integer cannot be cast to java.lang.String
在使用greenDAO时,一个实体类仅仅能相应一个表。眼下没法做到一个表相应多个实体类。或者多个表共用一种对象类型。

兴许的升级也不会针对这一点进行扩展。


 

4、表的增删改查
增删改查相当方便。全然的面向对象。不须要涉及到不论什么的sql语言。
          查询
范例1:查询某个表是否包括某个id:
public boolean isSaved(int ID)
{
QueryBuilder<SaveList> qb = saveListDao.queryBuilder();
qb.where(Properties.Id.eq(ID));
qb.buildCount().count();
return qb.buildCount().count() > 0 ?

true : false;
}
范例2:获取整个表的数据集合,一句代码就搞定!
public List<PhotoGalleryDB> getPhotoGallery()
{
   return photoGalleryDao.loadAll();// 获取图片相冊
}
范例3:通过一个字段值查找相应的还有一个字段值(为简便直接使用以下方法,或许有更简单的方法,尚未尝试)
/** 通过图片id查找其文件夹id */
public int getTypeId(int picId)
{
QueryBuilder<PhotoGalleryDB> qb = photoGalleryDao.queryBuilder();
qb.where(Properties.Id.eq(picId));
if (qb.list().size() > 0)
{
return qb.list().get(0).getTypeId();
}
else
{
return -1;
}
}
范例4:查找全部第一姓名是“Joe”而且以lastname排序。
List joes = userDao.queryBuilder()
.where(Properties.FirstName.eq("Joe"))
.orderAsc(Properties.LastName)
.list();
范例5:多重条件查询
(1)获取id为cityId而且infotype为HBContant.CITYINFO_SL的数据集合:
public List<CityInfoDB> getSupportingList(int cityId)
{
QueryBuilder<CityInfoDB> qb = cityInfoDao.queryBuilder();
qb.where(qb.and(Properties.CityId.eq(cityId),Properties.InfoType.eq(HBContant.CITYINFO_SL)));
qb.orderAsc(Properties.Id);// 排序根据
return qb.list();
}
(2)获取firstname为“Joe”而且出生于1970年10月以后的全部user集合:
QueryBuilder qb = userDao.queryBuilder();
qb.where(Properties.FirstName.eq("Joe"),
qb.or(Properties.YearOfBirth.gt(1970),
qb.and(Properties.YearOfBirth.eq(1970), Properties.MonthOfBirth.ge(10))));
List youngJoes = qb.list();
范例6:获取某列对象
picJsonDao.loadByRowId(picId);

5.增添/插入、改动
插入数据更加简单。也是仅仅要一句代码便能搞定!

                public void addToPhotoTable(Photo p)
{
photoDao.insert(p);
}
插入时须要new一个新的对象,范比例如以下:
DevOpenHelper helper = new DaoMaster.DevOpenHelper(this, "notes-db", null);
db = helper.getWritableDatabase();
daoMaster = new DaoMaster(db);
daoSession = daoMaster.newSession();
noteDao = daoSession.getNoteDao();
Note note = new Note(null, noteText, comment, new Date());
noteDao.insert(note);
改动更新:
photoDao.insertOrReplace(photo);
photoDao.insertInTx(photo);

6.删除:
           (1)清空表格数据
           /** 清空相冊图片列表的数据 */
           public void clearPhoto()
           {
           photoDao.deleteAll();
           }
(2)删除某个对象
 {
       QueryBuilder<DBCityInfo> qb = cityInfoDao.queryBuilder();
       DeleteQuery<DBCityInfo> bd = qb.where(Properties.CityId.eq(cityId)).buildDelete();
       bd.executeDeleteWithoutDetachingEntities();
}
由上可见,使用greenDAO进行数据库的增删改查时及其方便,并且性能极佳。


 三、经常用法笔记
1.在Application实现得到DaoMaster和DaoSession的方法:
private static DaoMaster daoMaster;
private static DaoSession daoSession;
/**
* 取得DaoMaster
*
* @param context
* @return
*/
public static DaoMaster getDaoMaster(Context context)
{
if (daoMaster == null)
{
OpenHelper helper = new DaoMaster.DevOpenHelper(context, HBContant.DATABASE_NAME, null);
daoMaster = new DaoMaster(helper.getWritableDatabase());
}
return daoMaster;
}
/**
* 取得DaoSession
*
* @param context
* @return
*/
public static DaoSession getDaoSession(Context context)
{
if (daoSession == null)
{
if (daoMaster == null)
{
daoMaster = getDaoMaster(context);
}
daoSession = daoMaster.newSession();
}
return daoSession;
}
2.增删改查工具类:
public class DBHelper
{
private static Context mContext;
private static DBHelper instance;
 
private CityInfoDBDao cityInfoDao;
 
private DBHelper()
{
}
 
public static DBHelper getInstance(Context context)
{
if (instance == null)
{
instance = new DBHelper();
if (mContext == null)
{
mContext = context;
}
 
// 数据库对象
DaoSession daoSession = HBApplication.getDaoSession(mContext);
instance.cityInfoDao = daoSession.getCityInfoDBDao();
}
return instance;
}
 
/** 加入数据 */
public void addToCityInfoTable(CityInfo item)
{
cityInfoDao.insert(item);
}
 
/** 查询 */
public List<EstateLoveListJson> getCityInfoList()
{
QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
return qb.list();
}
 
/** 查询 */
public List<CityInfo> getCityInfo()
{
return cityInfoDao.loadAll();// 查找图片相冊
}
 
/** 查询 */
public boolean isSaved(int Id)
{
QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
qb.where(Properties.Id.eq(Id));
qb.buildCount().count();
return qb.buildCount().count() > 0 ? true : false;// 查找收藏表
}
 
/** 删除 */
public void deleteCityInfoList(int Id)
{
QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
DeleteQuery<CityInfo> bd = qb.where(Properties.Id.eq(Id)).buildDelete();
bd.executeDeleteWithoutDetachingEntities();
}
 
/** 删除 */
public void clearCityInfo()
{
cityInfoDao.deleteAll();
}
 
/** 通过城市id查找其类型id */
public int getTypeId(int cityId)
{
QueryBuilder<CityInfo> qb = cityInfoDao.queryBuilder();
qb.where(Properties.Id.eq(cityId));
if (qb.list().size() > 0)
{
return qb.list().get(0).getTypeId();
}
else
{
return 0;
}
}
 
/** 多重查询 */
public List<CityInfo> getIphRegionList(int cityId)
{
QueryBuilder<CityInfoDB> qb = cityInfoDao.queryBuilder();
qb.where(qb.and(Properties.CityId.eq(cityId), Properties.InfoType.eq(HBContant.CITYINFO_IR)));
qb.orderAsc(Properties.Id);// 排序根据
return qb.list();
}
}
       另外。还有多表关联、惰性载入等功能,待兴许研究。


參考资料:
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



原文地址:https://www.cnblogs.com/yjbjingcha/p/7130406.html