Android Afinal使用与总结

Afinal简介

• Afinal 是一个android的sqlite orm 和 ioc 框架。同时封装了android中的http框架，使其更加简单易用；
• 使用finalBitmap，无需考虑bitmap在android中加载的时候oom的问题和快速滑动的时候图片加载位置错位等问题。
• Afinal的宗旨是简洁，快速。约定大于配置的方式。尽量一行代码完成所有事情。

目前Afinal主要有四大模块：

FinalDB模块：android中的orm框架，一行代码就可以进行增删改查。支持一对多，多对一等查询。
FinalActivity模块：android中的ioc框架，完全注解方式就可以进行UI绑定和事件绑定。无需findViewById和setClickListener等。
FinalHttp模块：通过httpclient进行封装http数据请求，支持ajax方式加载。

FinalBitmap模块：通过FinalBitmap，imageview加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象。FinalBitmap可以配置线程加载线程数量，缓存大小，缓存路径，加载显示动画等。FinalBitmap的内存管理使用lru算法，没有使用弱引用（android2.3以后google已经不建议使用弱引用，android2.3后强行回收软引用和弱引用，详情查看android官方文档），更好的管理bitmap内存。FinalBitmap可以自定义下载器，用来扩展其他协议显示网络图片，比如ftp等。同时可以自定义bitmap显示器，在imageview显示图片的时候播放动画等（默认是渐变动画显示）。

Afinal 更多信息可以参考：https://github.com/yangfuhai/afinal

这里我要使用的是它的FinalDB模块，下面通过一个简单Demo来展示一下。

Book实体定义如下：

package com.example.afinaltest.entity;

import net.tsz.afinal.annotation.sqlite.Table;

@Table(name="book")
public class Book {
	private int id;
	private String name;
	private String isbn;
	private float price;
	
	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 getIsbn() {
		return isbn;
	}
	public void setIsbn(String isbn) {
		this.isbn = isbn;
	}
	public float getPrice() {
		return price;
	}
	public void setPrice(float price) {
		this.price = price;
	}
	
	@Override
	public String toString() {
		return "Book [id=" + id + ", name=" + name + ", isbn=" + isbn
				+ ", price=" + price + "]";
	}
	
}

这个实体类要注意一点就是getter和setter是不能省略的，因为afinal的finalDb最终会调用setter去给实体类的属性赋值。注解 @Table(name="book")表示我们希望将Book实体映射到book表中，Book类的属性会映射成对应表中的字段。

以下类中展示FinalDb的CRUD功能

package com.example.afinaltest;

import java.util.List;
import com.example.afinaltest.entity.Book;
import net.tsz.afinal.FinalDb;
import android.app.Activity;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;

public class MainActivity extends Activity implements OnClickListener {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);
		
		findView();
	}

	private void findView() {
		
		Button bt_database = (Button) findViewById(R.id.bt_database);
		Button bt_insert = (Button) findViewById(R.id.bt_insert);
		Button bt_query = (Button) findViewById(R.id.bt_query);
		Button bt_update = (Button) findViewById(R.id.bt_update);
		Button bt_delete = (Button) findViewById(R.id.bt_delete);
		
		bt_database.setOnClickListener(this);
		bt_insert.setOnClickListener(this);
		bt_query.setOnClickListener(this);
		bt_update.setOnClickListener(this);
		bt_delete.setOnClickListener(this);
	}

	@Override
	public void onClick(View v) {
		
		FinalDb finalDb = null;
		switch (v.getId()) {
		case R.id.bt_database:
			
			finalDb = FinalDb.create(this, "cart");	//创建数据库
			
			break;
		case R.id.bt_insert:
			
			finalDb = FinalDb.create(this, "cart");
			
			Book book = new Book();//这里需要注意的是User对象必须有id属性，或者有通过@ID注解的属性
			book.setName("设计模式");
			book.setIsbn("ISBN1000");
			book.setPrice(48.9f);
			
			finalDb.save(book);
			
			book = new Book();
			book.setName("大话设计模式");
			book.setIsbn("ISBN2000");
			book.setPrice(88.9f);
			
			finalDb.save(book);
			
			book = new Book();
			book.setName("研磨设计模式");
			book.setIsbn("ISBN3000");
			book.setPrice(58.9f);
			
			finalDb.save(book);
			
			book = new Book();
			book.setName("深入Java虚拟机");
			book.setIsbn("ISBN4000");
			book.setPrice(78.5f);
			
			finalDb.save(book);
			
			break;
		case R.id.bt_query:
			
			finalDb = FinalDb.create(this, "cart");
			List<Book> list = finalDb.findAllByWhere(Book.class, "name like '%设计模式'");
			
			for(int i=0;list!=null && i<list.size();i++){
				System.out.println(list.get(i));
			}
			
			break;
			
		case R.id.bt_update:
			
			finalDb = FinalDb.create(this, "cart");
			
			Book entity = new Book();
			entity.setName("设计模式");
			entity.setIsbn("ISBN1000");
			entity.setPrice(108.9f);
			
//			finalDb.update(entity);
			finalDb.update(entity, "name like '%设计模式'");
			break;
			
		case R.id.bt_delete:
			
			finalDb = FinalDb.create(this, "cart");
			
//			finalDb.delete(entity);
			finalDb.deleteById(Book.class, 1);
//			finalDb.deleteByWhere(Book.class, "name like '%设计模式'");
			
			break;
		default:
			break;
		}
	}

}

FinalDB优点
android中的orm框架，一行代码就可以进行增删改查。支持一对多，多对一等查询。

FinalDb的缺点

目前暂时不支持复合主键，并且对SQL语句的支持也非常有限，一些比较复杂的业务逻辑实现非常麻烦！

推荐github上一个开源项目 xUtils，它基于Afinal框架，进行了大量重构，使得xUtils支持大文件上传，更全面的http请求协议支持(10种谓词)，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响

xUtils：https://github.com/wyouflf/xUtils