Android开源库--ActiveAndroid(active record模式的ORM数据库框架)
Github地址:https://github.com/pardom/ActiveAndroid
前言
我一般在Android开发中,几乎用不到SQLlite,因为一些小数据就直接使用Preferences保存了,最近涉及到了消息推送历史,或者涉及到信息历史方面的东西,所以就需要用到了android的SQLlite,为了不重复造轮子,果断上github寻找轮子。
GreenDAO虽然效率最高,但由于每次都要手动生成代码,比较麻烦,所以弃用。
Couchbase也有Android版本,同时支持配合Couchbase Server同步,但使用的是nosql的数据库,所以弃用,但是后期可以研究研究。
ActiveAndroid是一个Active record模式的框架,几乎可以不用写任何SQL代码实现快速开发,就是它了!
简介
ActiveAndroid是一个active record模式的ORM框架,意味着不用写任何sql代码就能实现保存和检索SQLite数据库。
Active Record 模式
Active Record 模式出自 Martin Fowler 的《企业应用架构模式》一书。在 Active Record 模式中,对象中既有持久存储的数据,也有针对数据的操作。Active Record 模式把数据存取逻辑作为对象的一部分,处理对象的用户知道如何把数据写入数据库,以及从数据库中读出数据。
对象关系映射
对象关系映射(ORM)是一种技术手段,把程序中的对象和关系型数据库中的数据表连接起来。使用 ORM,程序中对象的属性和对象之间的关系可以通过一种简单的方法从数据库获取,无需直接编写 SQL 语句,也不过度依赖特定的数据库种类。
使用
1、获取类库
由于官方编译好的类库版本太久了,所以还是下载最新的源码使用gradle来构建jar类库,我已经编译好并且上传到附件了。
下载地址:http://files.cnblogs.com/files/leestar54/ActiveAndroid-jar.rar
下载完成,添加到libs即可,如果需要看文档和源码,则需要
2、配置
在AndroidManifest.xml的application节点添加2个meta-data字节点
<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.db,1。
如果使用了自定义的Application,记得要初始化噢!
public class MyApplication extends SomeLibraryApplication {
@Override
public void onCreate() {
super.onCreate();
ActiveAndroid.initialize(this);
}
}
3、创建数据库模型
非常简单~以往要写一大堆SQL代码啊,只需创建一个类继承Model,使用注释标注相关字段(见https://github.com/pardom/ActiveAndroid/blob/master/src/com/activeandroid/annotation/Column.java)
没有ID?ActiveAndroid 已经帮我们自动创建了,见代码
@Table(name = "Items")
public class Item extends Model {
// If name is omitted, then the field name is used.
@Column(name = "Name", index = true)//如果需要设置这字段为索引,添加index=true即可。
public String name; @Column(name = "Category")
public Category category;
//如果定义了自己的构造函数,记得还要定义一个无参构造函数。
public Item() {
super();
} public Item(String name, Category category) {
super();
this.name = name;
this.category = category;
}
}
有这么一种关系,Items属于一个Category并且Categories包含许多Items,如何表示?也很简单。
@Table(name = "Categories")
public class Category extends Model {
@Column(name = "Name")
public String name; // This method is optional, does not affect the foreign key creation.
public List<Item> items() {
return getMany(Item.class, "Category");
}
}
注意:
ActiveAndroid会去遍历所有的文件来寻找Model类,这样的效率非常低,所以最好在AndroidManifest中添加一个meta-data,告诉ActiveAndroid你的Model类
<meta-data
android:name="AA_MODELS"
android:value="com.myapp.model.Item, com.myapp.model.Category" />
同时,不要使用以下的列名
ABORT DEFAULT INNER REGEXP
ACTION DEFERRABLE INSERT REINDEX
ADD DEFERRED INSTEAD RELEASE
AFTER DELETE INTERSECT RENAME
ALL DESC INTO REPLACE
ALTER DETACH IS RESTRICT
ANALYZE DISTINCT ISNULL RIGHT
AND DROP JOIN ROLLBACK
AS EACH KEY ROW
ASC ELSE LEFT SAVEPOINT
ATTACH END LIKE SELECT
AUTOINCREMENT ESCAPE LIMIT SET
BEFORE EXCEPT MATCH TABLE
BEGIN EXCLUSIVE NATURAL TEMP
BETWEEN EXISTS NO TEMPORARY
BY EXPLAIN NOT THEN
CASCADE FAIL NOTNULL TO
CASE FOR NULL TRANSACTION
CAST FOREIGN OF TRIGGER
CHECK FROM OFFSET UNION
COLLATE FULL ON UNIQUE
COLUMN GLOB OR UPDATE
COMMIT GROUP ORDER USING
CONFLICT HAVING OUTER VACUUM
CONSTRAINT IF PLAN VALUES
CREATE IGNORE PRAGMA VIEW
CROSS IMMEDIATE PRIMARY VIRTUAL
CURRENT_DATE IN QUERY WHEN
CURRENT_TIME INDEX RAISE WHERE
CURRENT_TIMESTAMP INDEXED RECURSIVE WITH
DATABASE INITIALLY REFERENCES WITHOUT
ID
4、增删查改
//增、改
Category restaurants = new Category();
restaurants.name = "Restaurants";
restaurants.save();
Item item = new Item();
item.category = restaurants;
item.name = "Outback Steakhouse";
item.save(); //删
Item item = Item.load(Item.class, 1);
item.delete();
Item.delete(Item.class, 1);
new Delete().from(Item.class).where("Id = ?", 1).execute(); //查,类似Builder的操作,具体看源码即可
public static Item getRandom(Category category) {
return new Select()
.from(Item.class)
.where("Category = ?", category.getId())
.orderBy("RANDOM()")
.executeSingle();
}
//事务
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();
}
5、预填充数据库
如果之前已经有数据库了,那么只需2步即可导入
(1)复制sql数据库到项目的assets目录,例如/myapp/src/main/assets/prepop.db
(2)确保manifest的AA_DB_NAME值与数据库名称一致,<meta-data android:name="AA_DB_NAME" android:value="prepop.db" />
部署之后,该数据库就会被挪至应用的/data/data/myapp/databases目录,虽然这会导致最后应用中会有一份数据库副本,占用应用大小。
为了确保自己的数据库能与ActiveAndroid好好工作,还需添加一个android_metadata表
CREATE TABLE "android_metadata" ("locale" TEXT DEFAULT 'en_US')
INSERT INTO "android_metadata" VALUES ('en_US')
ActiveAndoird默认的主键标识名称为Id,所以如果models没有定义id列,要确保主键重命名为Id,但是如果是为了在ListView显示数据,建议设置主键列名为_id
@Table(name = "Items", id = "_id")
public class Item extends Model {
6、架构变动
有时候需要添加删除表的列
如果应用在开发阶段好办,直接在Model编辑删除之后重新安装即可。
如果是发布的产品,这时候就不能仅仅在model里面删除字段而已了,因为数据库已经生成了,这时候需要我们手动调整
(1)配置中AA_DB_VERSION 加1.
(2)新建一个<NewVersion>.sql,NewVersion就是AA_DB_VERSION 值,将文件添加到项目的assets/migrations目录
(3)ActiveAndroid将会执行NewVersion大于旧版本的SQL
示例:
在Items表中加入color列
2.sql
ALTER TABLE Items ADD COLUMN color INTEGER;
Android开源库--ActiveAndroid(active record模式的ORM数据库框架)的更多相关文章
- GitHub上排名前100的Android开源库介绍(来自github)
本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍,至于排名完全是根据 GitHub 搜索 Java 语言选择 (Best Match) 得到的结果,然后过滤了 ...
- GitHub Top 100的Android开源库
摘要: 本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍, 至于排名完全是根据GitHub搜索Java语言选择「Best M... 本项目主要对目前 GitH ...
- 我的Android进阶之旅】GitHub 上排名前 100 的 Android 开源库进行简单的介绍
GitHub Android Libraries Top 100 简介 本文转载于:https://github.com/Freelander/Android_Data/blob/master/And ...
- <Android开源库 ~ 1> GitHub Android Libraries Top 100 简介
转载自GitHub Android Libraries Top 100 简介 本项目主要对目前 GitHub 上排名前 100 的 Android 开源库进行简单的介绍, 至于排名完全是根据 GitH ...
- GitHub上排名前100的Android开源库介绍
GitHub上排名前100的Android开源库介绍 文章来源: http://www.open-open.com/news/view/1587067#6734290-qzone-1-31660-bf ...
- 【Java&Android开源库代码分析】のandroid-async-http の开盘
在<[Java&Android开源库代码剖析]のandroid-smart-image-view>一文中我们提到了android-async-http这个开源库,本文正 ...
- Android 开源库和项目 3
Android 开源库和项目 Android 开源库和项目 2 1.Matisse Android 图片选择器 -- 知乎开源 github 地址:https://github.com/zhihu/M ...
- Android 开源库获取途径整理
介绍眼下收藏 Android 开源库比較多的 GitHub 项目.站点.Twitter.App 及怎样获取最新的 Android 开源库. 微信号: 1. GitHub Android 开源项目汇总 ...
- 100个Github上Android开源库
项目名称 项目简介 1. react-native 这个是 Facebook 在 React.js Conf 2015 大会上推出的基于 JavaScript 的开源框架 React Native, ...
随机推荐
- img图片底部出现莫名的下边距问题
谷歌中这样是解释的: 图片底部的空隙实际上涉及行内元素的布局模型,图片默认的垂直对齐方式是基线,而基线的位置是与字体相关的.所以在某些时候,图片底部的空隙可能是 2px,而有时可能是 4px 或更多. ...
- javascript设计模式-抽象工厂模式
<!doctype html> <html lang="en"> <head> <meta charset="UTF-8&quo ...
- (转)Eclipse平台技术概述
转载:周金根 http://zhoujg.blog.51cto.com/1281471/516833 Eclipse:Eclipse平台技术概述 2010-10-19 13:35:00 标签:E ...
- 接口、抽象类、方法复写、类Equals方法重写
接口: /* * Java接口中的數據成員必須初始化,該成員有隱藏的final.satic.常量, * 一次賦值后不可在賦值 * 成員方法訪問修飾符必須是公共修飾符,可以顯示聲明也可以不聲明 * 成員 ...
- 评论 ”[实例] 设计基于JQM的WebApp“
点这里 DEMO 先上最近做的一个WebApp小应用,http://iwxy.me/m.html,大家可以先去玩玩儿,在移动终端访问查看最佳效果 实现的功能是微博上偶然看到的一个小测试,动物认识真实的 ...
- POJ 2081
#include <iostream> #define MAXN 500005 using namespace std; //unsigned _m[MAXN]; ]; int main( ...
- Xamarin for Visual Studio 3.11.666 稳定版 破解补丁 Version 3
前提概要 1.全新安装请参考 安装 Xamarin for Visual Studio. 2.本次补丁包含: ① Xamarin for Visual Studio 3.11.666 ② Xamari ...
- Codeforces Round #337 (Div. 2) C. Harmony Analysis 数学
C. Harmony Analysis The semester is already ending, so Danil made an effort and decided to visit a ...
- jmeter中线程之间传递参数
JMeter 变量作用域局限于所属线程.这样设计是经过深思熟虑的,目的是让测试线程能够独立运转.有时候用户可能需要在不同线程间(可能属于同一个线程组,也可能不属于同一个线程组)传递变量. 其中一种方法 ...
- MongoDB (十一) MongoDB 排序文档
sort() 方法 要在 MongoDB 中的文档进行排序,需要使用sort()方法. sort() 方法接受一个文档,其中包含的字段列表连同他们的排序顺序.要指定排序顺序1和-1. 1用于升序排列, ...