Android轻量级ORM框架ActiveAndroid入门教程
注:没有找到出处,如有侵犯,请告知
开始ActiveAndroid神奇之旅:
在AndroidManifest.xml中我们需要添加这两个
- AA_DB_NAME (数据库名称,这个name不能改,但是是可选的,如果不写的话 是默认的"Application.db"这个值)
- AA_DB_VERSION (数据库版本号,同样是可选的 – 默认为1)
<manifest ...> <application android:name="com.activeandroid.app.Application" ...> ... <meta-data android:name="AA_DB_NAME" android:value="Pickrand.db" /> <meta-data android:name="AA_DB_VERSION" android:value="5" /> </application> </manifest>
这个<application>是必须指定的,但你也可以使用自己的Application,继承自com.activeandroid.app.Application
public class MyApplication extends com.activeandroid.app.Application { ...
如果你不想或者不能继承com.activeandroid.app.Application的话,那么就这样
public class MyApplication extends SomeLibraryApplication { @Override public void onCreate() { super.onCreate(); ActiveAndroid.initialize(this); } @Override public void onTerminate() { super.onTerminate(); ActiveAndroid.dispose(); } }
ActiveAndroid.initialize(this);做初始化工作,ActiveAndroid.dispose();做清理工作
创建数据库模型
我们使用@Table(name = "Items")来表示表,使用@Column(name = "Name")来表示列,ActiveAndroid会使用自增长的ID作为主键,然后按照注解描述,将类对应映射为数据库表。
@Table(name = "Categories") public class Category extends Model { @Column(name = "Name") public String name; } @Table(name = "Items") public class Item extends Model { @Column(name = "Name") public String name; @Column(name = "Category") public Category category; }
依赖关系的数据库表
假如Item和Category是多对一的关系,那么我们可以这样子创建他们的类
@Table(name = "Items") public class Item extends Model { @Column(name = "Name") public String name; @Column(name = "Category") public Category category; }
@Table(name = "Categories") public class Category extends Model { @Column(name = "Name") public String name; //方法可选,对外键创建没有影响 public List<Item> items() { return getMany(Item.class, "Category"); }
初始化工作做好,让我们看一下如何保存和更新数据到数据库
单个插入
保存Category对象
Category restaurants = new Category(); restaurants.name = "Restaurants"; restaurants.save();
批量插入
如果你要批量插入数据,最好使用事务(transaction)。
ActiveAndroid.beginTransaction(); try { for (int i = 0; i < 100; i++) { Item item = new Item(); item.name = "Example " + i; item.save(); } ActiveAndroid.setTransactionSuccessful(); } finally { ActiveAndroid.endTransaction(); }
使用事务的话只用了 40ms,不然的话需要4秒。
删除记录
我们有三种方式删除一条记录
Item item = Item.load(Item.class, 1); item.delete();
Item.delete(Item.class, 1);
new Delete().from(Item.class).where("Id = ?", 1).execute();
好吧!是不是感觉so easy!
查询数据库
作者将查询做的非常像SQLite的原生查询语句,几乎涵盖了所有的指令 com.activeandroid.query包下有以下类
- Delete
- From
- Join
- Select
- Set
- Update
看实际例子
public static Item getRandom(Category category) { return new Select() .from(Item.class) .where("Category = ?", category.getId()) .orderBy("RANDOM()") .executeSingle(); }
对应的sqlite查询语句就是 select * from Item where Category = ? order by RANDOM()
那么下面代码对应的sqlite查询语句作用是什么,尝试去告诉我吧?
public static List<Item> getAll(Category category) { return new Select() .from(Item.class) .where("Category = ?", category.getId()) .orderBy("Name ASC") .execute(); }
当然还支持其他非常多的指令,你可以从github上面的测试用例去了解~
最后,咱们来尝试升级数据库
很多情况下,我们需要在原来数据库的基础上增加字段,而又顾忌用户原来保存的数据,不想删除原来的数据表再重新建表,因此我们需要这样做:
1、首先,你需要更改AndroidManifest.xml中数据库版本号AA_DB_VERSION(必须比上一版本号大的正整数)
2、其次,你需要在assest目录里面创建sql文件,目录结构(/migrations/升级后的版本号.sql),文件里面你需要写上你变动数据库的sql语句(一行一句sql语句),比如我们想在Category表里增加Count字段来统计数量,我们需要这样写:
ALTER TABLE Category ADD COLUMN Count INTEGER;
3、最后,你需要在Category对象里面添加的对应字段(如果有增加字段的话,添加规则参考上面创建数据库模型
还有园子里的一篇文章:
http://www.cnblogs.com/jack-1900/p/3876728.html
ORM轻量级框架---ActiveAndroid
ORM即Object-Relational Mapping,对象关系映射。简单理解就是把我们Java的对象与数据库里面的记录进行映射,可以把实体对象持久化到数据库中,也能把查询到的记录映射成Java对象。ORM让我们彻底解放,一点也不需要再去编写冗长晦涩的Sql语句,一切都是通过框架去做,不得不说是程序员的一大福音。
ORM框架实现的原理其实也很简单,就是利用Java的反射机制把对象和数据库记录映射关联起来。比如存储的时候,是把对象的属性取出来作为记录的属性值进行插入;而查询的时候则是把查询条件自动构建成一条Sql语句,把查询到的结果集转成对象列表。J2EE有ibatis,Hibernate框架,我们Android也有GreenDAO,ormlite,xUtils,AFinal等。它们的实现原理都一样,不同的也只是细节方面的处理。如果兴趣的同学,推荐阅读下ActiveAndroid的源码。Reading the fucking code!
以前写过介绍xUtils的系列文章,其中的FinalDb模块就是一个ORM框架,也是我工作中常用的。今天我们介绍的ActiveAndroid的API也是相当的简单友好,而且功能一样的强大。ActiveAndroid简洁的API给人一种用起来很舒服的感觉,今天主要是介绍下关于CRUD的简单使用。
一、初始化
有两种方式,一种是配置AndroidManifest的application的name属性,同时在meta-data标签中可选的配置db的name和version;二是在自己的Application类中继承ActiveAndroid的Application;前两种方式入侵性太强,还有一种只需在自定义的Application中静态的注入两个方法即可。
二、定义实体类
实体类需继承Model,可自定义表名和属性对应的字段名
三、插入
可以实现单条数据插入,也可以批量插入,同时也支持事务。
四、删除
支持基于引用的单条记录删除,也支持根据条件进行批量删除。
五、更新
自Model中继承来的save方法,不仅可以进行insert、还可以update;同时也能基于条件进行批量的更新。
六、查询
ActiveAndroid的查询API基本与sql语句的关键字一致,比较友好。这点和xUtils是一样的
写在最后:ORM框架使用起来确实是很方便的,给我们编码提高了效率,但是也有着致命弊端。前面我们也介绍了ORM的实现的原理是Java的反射机制,反射有个缺点,就是会造成效率不高、耗时较长的现象。当有数据批量操作的时候,会把耗时加长好几倍。所以当遇到业务中有很多的记录要处理的时候,就不推荐大家使用框架了,还是老老实实的写比较靠谱。今天干货分享到此为止,希望可以帮助到大家。
如果觉得对你有所帮助,欢迎大家订阅我的微信公众账号——Android干货分享(ID:android_share)。下面是微信的二维码,为你提供及时高质的Android干货。
郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。