Android轻量级ORM框架ActiveAndroid入门教程(转)

/article/4906588.html

开始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对象里面添加的对应字段（如果有增加字段的话，添加规则参考上面创建数据库模型

还有园子里的一篇文章：

/article/7050236.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的反射机制，反射有个缺点，就是会造成效率不高、耗时较长的现象。当有数据批量操作的时候，会把耗时加长好几倍。所以当遇到业务中有很多的记录要处理的时候，就不推荐大家使用框架了，还是老老实实的写比较靠谱。今天干货分享到此为止，希望可以帮助到大家。