今天给大家介绍下#afinal#来操作android的数据库sqlite。
#afinal#是一个android的orm、ioc快速开发框架,里面包含了四大功能:空间的id绑定和事件绑定功能;网络图片的显示功能(里面包含了强大的缓存框架);数据库sqlite的操作功能;http数据的读取功能(支持ajax方式读取);
#afinal#开源网址:https://github.com/yangfuhai/afinal
这篇文章主要是介绍afinal的功能之一FinalDb组件,其他组件请关注我的博客吧,以后将会一一介绍:
# afinal#的FinalDb组件是android的一个轻量级的orm框架,使用简单,一行代码就可以完成数据库的各种操作功能。
首先我们来创建一个测试实体类 User.java
01 | package com.devchina.ormdemo; |
03 | import java.util.Date; |
10 | private Date registerDate; |
17 | public void setId( int id) { |
20 | public String getName() { |
23 | public void setName(String name) { |
26 | public String getEmail() { |
29 | public void setEmail(String email) { |
32 | public Date getRegisterDate() { |
35 | public void setRegisterDate(Date registerDate) { |
36 | this .registerDate = registerDate; |
38 | public Double getMoney() { |
41 | public void setMoney(Double money) { |
这个实体类要注意一点就是getter和setter是不能省略的哦,,,,因为afinal的finalDb最终会调用setter去给实体类的属性赋值。
现在实体类创建完毕了,我们来写我们的第一个demo:
AfinalOrmDemoActivity.java
01 | package com.devchina.ormdemo; |
03 | import java.util.Date; |
04 | import java.util.List; |
06 | import net.tsz.afinal.FinalActivity; |
07 | import net.tsz.afinal.FinalDb; |
08 | import net.tsz.afinal.annotation.view.ViewInject; |
09 | import android.os.Bundle; |
10 | import android.util.Log; |
11 | import android.widget.TextView; |
13 | public class AfinalOrmDemoActivity extends FinalActivity { |
16 | @ViewInject (id=R.id.textView) TextView textView; |
19 | public void onCreate(Bundle savedInstanceState) { |
20 | super .onCreate(savedInstanceState); |
21 | setContentView(R.layout.main); |
23 | FinalDb db = FinalDb.create( this ); |
25 | User user = new User(); |
26 | user.setEmail( "afinal@tsz.net" ); |
28 | user.setRegisterDate( new Date()); |
32 | List<User> userList = db.findAll(User. class ); |
34 | Log.e( "AfinalOrmDemoActivity" , "用户数量:" + (userList!= null ?userList.size(): 0 )); |
36 | textView.setText(userList.get( 0 ).getName()+ ":" +user.getRegisterDate()); |
很简单吧,就一个FinalDb db = FinalDb.create(this),然后db.save(user);就可以把我们定义的实体类保存到数据库去啦。我们来看输出日志:
什么?就这样就保存到sqlite数据库里面去了?可是我们还没有创建数据库,也没有创建表呀?怎么可能?
这里,我要跟大家说的是afinal自己去创建啦,简单吧。
我们来看下adt的File Exploer 查看database目录,下面确实有一个afinal.db文件,如下图:
我们把afinal.db导出来后,通过sqlite数据库打开afinal.db,如下图:
![](http://static.oschina.net/uploads/space/2012/1106/225135_rb2m_111634.png)
同时afinal自动给我们创建来表:com_devchina_ormdemo_User,由此看出afinal会以类名为表名自动创建表:我们再过来看下表的数据:
![](https://i-blog.csdnimg.cn/blog_migrate/c97ead398a46ee341634ccd2b366bd7b.png)
到这里,相信大家能明白了,原理afinal自动给我们创建了数据库afinal.db同时给我们创建了表com_devchina_ormdemo_User,保存的时候,afinal自动把数据保存到sqlite表里面去了。
这时候,估计大家的疑问又起来了
afinal自动创建了数据库afinal.db,同时自动创建了表com_devchina_ormdemo_User。可是,我们不想创建数据库afinal.db,也不想让我们的表示com_devchina_ormdemo_User,那我们应该怎么办呢?
这一些呀,afinal都已经想好了。
接下来,我们来介绍下afinal的orm注解功能。
第一个,配置数据库中的表名 net.tsz.afinal.annotation.sqlite.Table,我们来给user,java配置一下:
01 | package com.devchina.ormdemo; |
03 | import java.util.Date; |
05 | import net.tsz.afinal.annotation.sqlite.Table; |
07 | @Table (name= "user_test" ) |
13 | private Date registerDate; |
这里和上边唯一不同的是 多了一个注解 @Table(name="user_test"),只要我们配置了这个以后,我们再来看下afinal创建的数据库和表:
![](http://static.oschina.net/uploads/space/2012/1106/225317_JNS5_111634.png)
由此,我们可以看出来,afinal又自动给我们创建了表user_test,但是要注意的是com_devchina_ormdemo_User这个表afinal并没有去删除,所以这里也要提醒下大家,我们在重新设计了类的结构或者属性的时候,先手动删除掉直接的数据,否则就会有垃圾数据保存在数据库里面,当然,不删除也可以,不会有任何的影响。
在上面的讲述中,细心的朋友可能会注意到了一个问题,afinal自动把user的id的这个属性当做了主键。而且自动增长。
可是,可是在我们的开发过程中,我们的user可能没有id这个属性啊,可能是userId,或者又可能是其他我们喜欢的属性,那怎么办呢?
没有关系:afinal有给我们准备了另一个注解:net.tsz.afinal.annotation.sqlite.Id,通过这个,我们就可以给我们的实体类定义主键啦
afinal的主键机制是:
当给某个属性添加注解@id的时候,该属性就是主键(一个类中只有一个主键),保存在数据库中的列名为属性的名称,@Id(column="userId")给属性添加注解的时候,保存在数据库的列名是userId,当这个属性没有的时候,afinal自动回去该类查找_id属性,_id属性也没有的时候,afinal就会自动去查找id属性。如果连id属性也没有,那么afinal就报错啦,afinal的orm规则中,表示必须有主键的,而且只能有一个(目前暂时不支持复合主键)。
回到刚才的问题,afinal给我们自动创建数据库afinal.db,可是,我们不想创建让数据库名是afinal.db,那怎么办呢?
afinal的创建时候有多个方法的重载。
在create的方法中,
isDebug表示是否是debug模式,debug模式中,使用afinal操作数据库的时候就会答应SQL语句的log,
dbName就是数据库的名称啦。
所以这里,我们传入我们自己想要的数据库名称就行了。
其实afinal的FinalDb模块中,还有很多其他的功能,比如一对多,多对一的配置和注解等等。等待大家挖掘了。
afinal的orm注解中有:
Id------->注解注解
Property------>属性注解
Table------->数据表注解
ManyToOne-------->多对一注解
OneToMany--------->一对多注解
Transient------->忽略属性注解(如果该属性添加这个注解,afinal的orm功能将忽略该属性)
源代下载地址:
http://download.csdn.net/detail/michael_yy/4740088
里面没有jar包,自己去afinal的广发网站下载最新jar包