今天给大家介绍下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

1. packagecom.devchina.ormdemo;
3. importjava.util.Date;
5. publicclassUser{
7. privateintid;
8. privateStringname;
9. privateStringemail;
10. privateDateregisterDate;
11. privateDoublemoney;
13. /////////////getterandsetter不能省略哦///////////////
14. publicintgetId(){
15. returnid;
16. }
17. publicvoidsetId(intid){
18. this.id=id;
19. }
20. publicStringgetName(){
21. returnname;
22. }
23. publicvoidsetName(Stringname){
24. this.name=name;
25. }
26. publicStringgetEmail(){
27. returnemail;
28. }
29. publicvoidsetEmail(Stringemail){
30. this.email=email;
31. }
32. publicDategetRegisterDate(){
33. returnregisterDate;
34. }
35. publicvoidsetRegisterDate(DateregisterDate){
36. this.registerDate=registerDate;
37. }
38. publicDoublegetMoney(){
39. returnmoney;
40. }
41. publicvoidsetMoney(Doublemoney){
42. this.money=money;
43. }
47. }

package com.devchina.ormdemo;import java.util.Date;public class User {private int id;private String name;private String email;private Date registerDate;private Double money;/////////////getter and setter 不能省略哦///////////////public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public Date getRegisterDate() {return registerDate;}public void setRegisterDate(Date registerDate) {this.registerDate = registerDate;}public Double getMoney() {return money;}public void setMoney(Double money) {this.money = money;}}

这个实体类要注意一点就是getter和setter是不能省略的哦，，，，因为afinal的finalDb最终会调用setter去给实体类的属性赋值。

现在实体类创建完毕了，我们来写我们的第一个demo:

AfinalOrmDemoActivity.java

1. packagecom.devchina.ormdemo;
3. importjava.util.Date;
4. importjava.util.List;
6. importnet.tsz.afinal.FinalActivity;
7. importnet.tsz.afinal.FinalDb;
8. importnet.tsz.afinal.annotation.view.ViewInject;
9. importandroid.os.Bundle;
10. importandroid.util.Log;
11. importandroid.widget.TextView;
13. publicclassAfinalOrmDemoActivityextendsFinalActivity{
16. @ViewInject(id=R.id.textView)TextViewtextView;//这里使用了afinal的ioc功能，以后将会讲到
18. @Override
19. publicvoidonCreate(BundlesavedInstanceState){
20. super.onCreate(savedInstanceState);
21. setContentView(R.layout.main);
23. FinalDbdb=FinalDb.create(this);
25. Useruser=newUser();
26. user.setEmail("afinal@tsz.net");
27. user.setName("探索者");
28. user.setRegisterDate(newDate());
30. db.save(user);
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());
37. }
38. }

package com.devchina.ormdemo;import java.util.Date;import java.util.List;import net.tsz.afinal.FinalActivity;import net.tsz.afinal.FinalDb;import net.tsz.afinal.annotation.view.ViewInject;import android.os.Bundle;import android.util.Log;import android.widget.TextView;public class AfinalOrmDemoActivity extends FinalActivity {@ViewInject(id=R.id.textView) TextView textView; //这里使用了afinal的ioc功能，以后将会讲到    @Override    public void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.main);                FinalDb db = FinalDb.create(this);                User user = new User();        user.setEmail("afinal@tsz.net");        user.setName("探索者");        user.setRegisterDate(new Date());                db.save(user);                List<User> userList = db.findAll(User.class);//查询所有的用户                Log.e("AfinalOrmDemoActivity", "用户数量："+ (userList!=null?userList.size():0));                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，如下图：

同时afinal自动给我们创建来表：com_devchina_ormdemo_User，由此看出afinal会以类名为表名自动创建表：我们再过来看下表的数据：

到这里，相信大家能明白了，原理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配置一下：

[java] view plain copy print ?

1. packagecom.devchina.ormdemo;
3. importjava.util.Date;
5. importnet.tsz.afinal.annotation.sqlite.Table;
7. @Table(name="user_test")
8. publicclassUser{
10. privateintid;
11. privateStringname;
12. privateStringemail;
13. privateDateregisterDate;
14. privateDoublemoney;
16. /////////////getterandsetter///////////////
17. //代码太长，略gettersetter，开发中不能省略
18. }

package com.devchina.ormdemo;import java.util.Date;import net.tsz.afinal.annotation.sqlite.Table;@Table(name="user_test")public class User {private int id;private String name;private String email;private Date registerDate;private Double money;/////////////getter and setter/////////////////代码太长，略getter setter，开发中不能省略}

这里和上边唯一不同的是 多了一个注解@Table(name="user_test")，只要我们配置了这个以后，我们再来看下afinal创建的数据库和表：

由此，我们可以看出来，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包

更多相关文章

1. Android系统配置数据库注释(settings.db)
2. Android开发——Android搜索框架（二）
3. [Android] ACTION_GET_CONTENT与ACTION_PICK的区别
4. Android(安卓)UI系列 - 布局 - 目录
5. android Manifest.xml选项-android:ConfigChanges
6. linearLayout 和 relativeLayout的属性区别
7. Android(安卓)属性动画（Property Animation） 完全解析 （下）
8. Android修改字体样式
9. android EditText使用指南

随机推荐

1. Android(安卓)IPC框架分析 Binder，Service
2. Android内存分析和优化
3. Android:手机扫描局域网所有ip，并进行sock
4. Android如何通过https协议下载自己的http
5. 关于android的屏幕常亮和完全关闭程序
6. Android： 绘制的文本如何排版
7. Android Studio主要目录及文件简介
8. Android 下移植WIFI 驱动
9. 在Android模拟机上跑javaeye android 客
10. Cocos2d-x for android 使用Box2d报错解