android快速开发框架afinal（数据库篇）

今天给你们介绍下#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

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

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自动给咱们建立了数据库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配置一下：

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又自动给咱们建立了表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://my.oschina.net/yangfuhai/blog/87459