玩转Android之数据库框架ActiveAndroid的使用

ActiveAndroid是一个开源的数据库框架，使我们在Android中使用数据库变得更为简单，今天我们就来看看这个数据库框架的使用。

1.引入ActiveAndroid

首先创建我们自己的项目，在我们的项目中引入ActiveAndroid，引入ActiveAndroid需要我们修改两个地方，一个全局gradle文件，还有一个是局部gradle文件，修改方式如下：

全局gradle文件，在jcenter()下方添加如下代码：

[java] view plain copy print ?

mavenCentral()
maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }

局部gradle文件修改：

[java] view plain copy print ?

compile 'com.michaelpardo:activeandroid:3.1.0-SNAPSHOT'

2.创建表及数据库

2.1. 表的创建

将ActiveAndroid引入到我们的项目中后，我们就可以开始使用这个东东了，如果大家使用Java中的hibernate数据库框架，就会觉得ActiveAndroid很简单了。在这里我们需要写一个类继承自Model这个类，如下：

[java] view plain copy print ?

@Table(name = "user_table", id = "_id")
public class UserEntity extends Model {
@Column
private String username;
@Column
private int age;
@Column
private String nickname;
public UserEntity() {
}
public UserEntity(int age, String nickname, String username) {
this.age = age;
this.nickname = nickname;
this.username = username;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public String getNickname() {
return nickname;
}
public void setNickname(String nickname) {
this.nickname = nickname;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
}

这里有几个地方需要解释一下：

1.类名上的@Table注解中有两个值，分别是name="user_table"以及id="_id"，其中name="user_table"表示一会生成的表的名称为user_table，不写的话默认为实体类的名称，id="_id"表示表的id字段的名称，默认为Id，但是我们在Android开发中一般将表中的id字段名称定义为_id，所以这里设置id="_id"

2.在每一个属性名的上方都有一个@Column注解，该注解表示该字段是表中的一个字段，不加这个注解表示该字段不是表中的字段。

2.2. 数据库名称的修改以及版本的配置

默认情况下创建的数据库名称为Application.db，如果我们需要修改数据库名称以及进行版本管理需要在清单文件中添加如下节点：

[java] view plain copy print ?

<meta-data android:name="AA_DB_NAME" android:value="Pickrand.db" />
<meta-data android:name="AA_DB_VERSION" android:value="5" />

其中AA_DB_NAME表示数据库的名称，AA_DB_VERSION表示数据库的版本号，做android开发的筒子们都知道版本号对于一个数据来说非常重要，数据库的版本升级离不开版本号。

2.3数据库升级以及表的修改

使用ActiveAndroid进行数据库升级稍微有一点点麻烦（个人觉得），假设我需要给数据库中的表添加一个字段该怎么做呢？有以下三个步骤：

1. 首先我需要修改我在上面定义的实体类，假设我想在添加一个性别字段，那我需要修改实体类如下：

[java] view plain copy print ?

@Table(name = "user_table", id = "_id")
public class UserEntity extends Model {
@Column
private String username;
@Column
private int age;
@Column
private String nickname;
@Column//性别字段，新添加的字段
private String gender;
......
......
......
}

2. 在清单文件中修改数据库的版本号，新的版本号是原版本号加1，比如原来的版本号是1，那我现在改为2

3.添加迁移脚本，最后我还需要添加一个数据库迁移脚本。在我项目的assets文件夹中添加一个子文件夹叫做migrations，在这个字文件夹中添加迁移脚本，脚本的名称为当前数据库最新版本号.sql，假设我最新的数据库版本号为2，那么我的迁移脚本的名称就为2.sql。针对我上面数据库升级的情况（添加一个字段），我的迁移脚本内容如下：

[java] view plain copy print ?