ActiveAndroid是一个开源的数据库框架,使我们在Android中使用数据库变得更为简单,今天我们就来看看这个数据库框架的使用。
1.引入ActiveAndroid
首先创建我们自己的项目,在我们的项目中引入ActiveAndroid,引入ActiveAndroid需要我们要在gradle
文件添加如下代码,
repositories {
mavenCentral()
maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
}
compile 'com.michaelpardo:activeandroid:3.1.0-SNAPSHOT'
2.创建表及数据库
2.1. 数据库的配置及初始化
默认情况下创建的数据库名称为Application.db,如果我们需要修改数据库名称以及进行版本管理需要在在清单文件中配置数据库名称和数据库版本号:
<application
android:name=".MyApp"
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<meta-data android:name="AA_DB_NAME" android:value="user.db" />
<meta-data android:name="AA_DB_VERSION" android:value="1" />
</application>
通过mete-data来配置数据库名称和数据库版本号,其中AA_DB_NAME
为数据库名称,AA_DB_VERSION
为数据库版本号,默认为1。大家都知道版本号对于一个数据来说非常重要,数据库的版本升级离不开版本号。对数据库进行升级,在文章结尾咱们再说.
2.2 创建存储的Model类
在这里我们需要写一个类继承自Model这个类,如下:
@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",你也可以为其设置一个Model类中的ID参数
2.在每一个属性名的上方都有一个@Column注解,该注解表示该字段是表中的一个字段,不加这个注解表示该字段不是表中的字段。
3.增删改查
完成以上步骤之后,接下来我们就可以来看看数据库中的增删改查操作了。
3.1增
添加数据,我们只需要new一个实体类出来,然后调用这个实体类的save
方法即可,此方法来自于实体类继承自Model类。OK,那我们来看一个简单的插入操作:
UserEntity userEntity = new UserEntity(56, "李四", "lisi");
userEntity.save();
创建一个UserEntity的实例,然后调用该实例的save方法即可。数据已经添加到表中后,这个save方法有一个返回值,这个返回值表示当前插入的数据的id。
3.2删
针对删除操作,ActiveAndroid提供了两种解决方案,一种是已知id,用户需要按id对数据进行删除,如下:
UserEntity.delete(UserEntity.class, 4);
表示删除_id为4的数据。
第二种条件删除方式:
Delete delete = new Delete();
delete.from(UserEntity.class).where("age='89'").and("nickname='李四'").execute();
表示删除age=89并且nickname=李四的数据,当然还有各种左连接右连接ActiveAndroid也都是支持的。
3.3改
Update update = new Update(UserEntity.class);
update.set("nickname='王五'").where("age='89'").execute();
修改也是很简单的,上面这两行代码表示将age为89的数据中的nickname改为王五。这里不支持and语句,如果有多个查询条件可以一起放在where语句中执行,如下:
Update update = new Update(UserEntity.class);
update.set("nickname='王五'").where("age='89' and nickname='zhangsan'").execute();
3.4查
Select select = new Select();
List<UserEntity> list = select.from(UserEntity.class).execute();
for (UserEntity userEntity : list) {
Log.d("google_lenve_fb", "select: " + userEntity.toString());
}
上面代码表示查询user_table表中所有的数据,查询结果直接返回一个List集合。我们可以直接遍历这个List集合并将其显示出来。查询条件也支持where以及各种左连接,右连接分页查询等。如下:
List<UserEntity> list = select.from(UserEntity.class)
.where("").and("").as("")
.groupBy("").having("").offset("").limit("")
.execute();
4.数据库升级
使用ActiveAndroid进行数据库升级相较于上面的操作有点绕,假设我需要给数据库中的表添加一个字段该怎么做呢?有以下三个步骤:
1. 首先我需要修改我在上面定义的实体类,假设我想在添加一个性别字段,那我需要修改实体类如下:
@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
。针对我上面数据库升级的情况(添加一个字段),我的迁移脚本内容如下:
ALTER TABLE user_table ADD COLUMN nickname;
OK,完成以上三步,新字段就可以成功的添加到表中了。