ActiveAndroid是一个开源的数据库框架,使我们在Android中使用数据库变得更为简单,今天我们就来看看这个数据库框架的使用。
1.引入ActiveAndroid
首先创建我们自己的项目,在我们的项目中引入ActiveAndroid,引入ActiveAndroid需要我们修改两个地方,一个全局gradle文件,还有一个是局部gradle文件,修改方式如下:
全局gradle文件,在jcenter()下方添加如下代码:
mavenCentral() maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
局部gradle文件修改:
compile ‘com.michaelpardo:activeandroid:3.1.0-SNAPSHOT‘
2.创建表及数据库
2.1. 表的创建
将ActiveAndroid引入到我们的项目中后,我们就可以开始使用这个东东了,如果大家使用Java中的Hibernate数据库框架,就会觉得ActiveAndroid很简单了。在这里我们需要写一个类继承自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"
2.在每一个属性名的上方都有一个@Column注解,该注解表示该字段是表中的一个字段,不加这个注解表示该字段不是表中的字段。
2.2. 数据库名称的修改以及版本的配置
默认情况下创建的数据库名称为Application.db,如果我们需要修改数据库名称以及进行版本管理需要在清单文件中添加如下节点:
<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. 首先我需要修改我在上面定义的实体类,假设我想在添加一个性别字段,那我需要修改实体类如下:
@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,完成以上三步,我的新字段就可以成功的添加到我的表中了。
3.增删改查
完成以上步骤之后,接下来我们就可以来看看数据库中的增删改查操作了。
3.1增
添加数据太easy了,我只需要new一个实体类出来,然后调用这个实体类的save方法即可,咦,我的实体类哪来的save方法呢?别忘了,我的实体类继承自Model类哦。OK,那我们来看一个简单的插入操作:
UserEntity userEntity = new UserEntity(56, "李四", "lisi"); userEntity.save();
创建一个UserEntity的实例,然后调用该实例的save方法即可。然后我们来看看数据库:
OK,数据已经添加到表中了。当然,这个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还是很好用的,极大的方便了我们的数据库操作,简化了代码操作,加上ActiveAndroid对版本升级较完美的支持,使得它更加的灵活。
但是大家也知道,这种框架之所以方便是在牺牲一部分性能的条件下获得的,执行效率肯定不如我们自己写的CRUD语句,所以筒子们在工作中要根据自己的实际情况来选择是否用该框架。
以上。