android 框架 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显示图片的时候播放动画等（默认是渐变动画显示）。

什么是orm？

对象关系映射（英语：Object Relational Mapping，简称ORM，或O/RM，或O/R
mapping），是一种程序技术，用于实现面向对象编程语言里不同类型系统的数据之间的转换。从效果上说，它其实是创建了一个可在编程语言里使用的“虚拟对象数据库”。

什么是ioc？

控制反转（Inversion of Control，英文缩写为IoC）是一个重要的面向对象编程的法则来削减计算机程序的耦合问题，也是轻量级的Spring框架的核心。
控制反转一般分为两种类型，依赖注入（Dependency Injection，简称DI）和依赖查找（Dependency Lookup）。依赖注入应用比较广泛。

什么是java注解？

注解（Annotation），也叫元数据。一种代码级别的说明。它是JDK5.0及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。
作用分类：

①编写文档：通过代码里标识的元数据生成文档【生成文档doc文档】

②代码分析：通过代码里标识的元数据对代码进行分析【使用反射】

③编译检查：通过代码里标识的元数据让编译器能够实现基本的编译检查【Override】

FinalDB 使用如下

首先我们来创建一个测试实体类 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:

package com.devchina.ormdemo;

AfinalOrmDemoActivity.java

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配置一下：

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功能将忽略该属性）

FinalActivity使用方法

完全注解方式就可以进行UI绑定和事件绑定

无需findViewById和setClickListener等

public class AfinalDemoActivity extends FinalActivity {

//无需调用findViewById和setOnclickListener等

@ViewInject(id=R.id.button,click="btnClick") Button button;

@ViewInject(id=R.id.textView) TextView textView;

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.main);

}

public void btnClick(View v){

textView.setText("text set form button");

}

}

*在其他侵入式框架下使用（如ActionBarShelock）

protected void onCreate(Bundle savedInstanceState)
{

super.onCreate(savedInstanceState);

setContentView(view);

FinalActivity.initInjectedView(this);

}

*在Fragment中使用

public View onCreateView(LayoutInflater
inflater, ViewGroup container,

Bundle savedInstanceState) {

View viewRoot = inflater.inflate(R.layout.map_frame, container, false);

FinalActivity.initInjectedView(this,viewRoot);

}

FinalHttp使用方法

FinalHttp 是对 HttpClient再次封装，最简洁的就是增加了许多回调的方法，对Get 和 Post
请求进行了简化。另外一点就是FinalHttp加入线程池操作，默认的Http请求池连接为3。下面是为FinalHttp可配置的操作。

FinalHttp finalHttp = new FinalHttp();

finalHttp.addHeader("Accept-Charset", "UTF-8");//配置http请求头

finalHttp.configCharset("UTF-8");

finalHttp.configCookieStore(null);

finalHttp.configRequestExecutionRetryCount(3);//请求错误重试次数

finalHttp.configSSLSocketFactory(null);

finalHttp.configTimeout(5000);//超时时间

finalHttp.configUserAgent("Mozilla/5.0");//配置客户端信息

普通get方法

FinalHttp fh = new FinalHttp();

fh.get("http://www.yangfuhai.com", new AjaxCallBack(){

@Override

public void onLoading(long count, long current) { //每1秒钟自动被回调一次

textView.setText(current+"/"+count);

}

@Override

public void onSuccess(String t) {

textView.setText(t==null?"null":t);

}

@Override

public void onStart() {

//开始http请求的时候回调

}

@Override

public void onFailure(Throwable t, String strMsg) {

//加载失败的时候回调

}

});

使用FinalHttp上传文件 或者 提交数据 到服务器（post方法）

文件上传到服务器，服务器如何接收，请查看这里

AjaxParams params = new AjaxParams();

params.put("username", "michael yang");

params.put("password", "123456");

params.put("email", "test@tsz.net");

params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件

params.put("profile_picture2", inputStream); // 上传数据流

params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流

FinalHttp fh = new FinalHttp();

fh.post("http://www.yangfuhai.com", params, new AjaxCallBack(){

@Override

public void onLoading(long count, long current) {

textView.setText(current+"/"+count);

}

@Override

public void onSuccess(String t) {

textView.setText(t==null?"null":t);

}

});

使用FinalHttp下载文件：

支持断点续传，随时停止下载任务 或者 开始任务

FinalHttp fh = new FinalHttp();

//调用download方法开始下载

HttpHandler handler = fh.download("http://www.xxx.com/下载路径/xxx.apk", //这里是下载的路径

true,//true:断点续传 false:不断点续传（全新下载）

"/mnt/sdcard/testapk.apk", //这是保存到本地的路径

new AjaxCallBack() {

@Override

public void onLoading(long count, long current) {

textView.setText("下载进度："+current+"/"+count);

}

@Override

public void onSuccess(File t) {

textView.setText(t==null?"null":t.getAbsoluteFile().toString());

}

});

//调用stop()方法停止下载

handler.stop();

公共方法

public void getDataByPost(Context context,
String URL, final HttpOnStartInter startInter,

final HttpSuccessInter successInter, final HttpOnFailInter failInter) {//自定义的3个接口，用于回调

if (!WifiUtil.isConnectivity(context)) {

return;

}

FinalHttp http = new FinalHttp();

http.post(URL, new AjaxCallBack<String>() {

@Override

public void onStart() {

startInter.httpOnStart();//交互中

}

@Override

public void onSuccess(String t) {

successInter.httpOnSuccess(t);//成功

}

@Override

public void onFailure(Throwable t, int errorNo, String strMsg) {

failInter.httpOnFail();//失败

}

});

}

FinalBitmap 使用方法

加载网络图片就一行代码 fb.display(imageView,url) ,更多的display重载请看帮助文档

private GridView gridView;

private FinalBitmap fb;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.images);

gridView = (GridView) findViewById(R.id.gridView);

gridView.setAdapter(mAdapter);

fb = FinalBitmap.create(this);//初始化FinalBitmap模块

fb.configLoadingImage(R.drawable.downloading);

//这里可以进行其他十几项的配置，也可以不用配置，配置之后必须调用init()函数,才生效

//fb.configBitmapLoadThreadSize(int size)

//fb.configBitmapMaxHeight(bitmapHeight)

}

///////////////////////////adapter getView////////////////////////////////////////////

public View getView(int position, View convertView, ViewGroup parent) {

ImageView iv;

if(convertView == null){

convertView = View.inflate(BitmapCacheActivity.this,R.layout.image_item, null);

iv = (ImageView) convertView.findViewById(R.id.imageView);

iv.setScaleType(ScaleType.CENTER_CROP);

convertView.setTag(iv);

}else{

iv = (ImageView) convertView.getTag();

}

//bitmap加载就这一行代码，display还有其他重载，详情查看源码

fb.display(iv,Images.imageUrls[position]);

AfinalBitmap配置调用

代码：

初始化代码

bitmap = FinalBitmap.create(this.getApplicationContext()); 初始化

bitmap.configBitmapLoadThreadSize(3);定义线程数量

bitmap.configDiskCachePath(this.getApplicationContext().getFilesDir().toString());设置缓存目录；

bitmap.configDiskCacheSize(1024 * 1024 * 10);设置缓存大小

bitmap.configLoadingImage(R.drawable.news_default);设置加载图片

2、调用代码

bitmap.display(imageView, newsinfoa.getImageUrl());第一个参数为iamgeview组件，第二个为加载的url地址

//第一种方式：image为要显示图片的控件

bitmap.display(iv, uri);

//第二种方式：loadingBitmap为正在加载时显示的图片

//bitmap.display(iv, uri, loadingBitmap);

//第三种方式：loadingBitmap为加载中图片，failBitmap为加载失败图片

// bitmap.display(iv, uri, loadingBitmap, failBitmap);

//第四种方式：我们也可以设置加载图片的大小

//bitmap.display(iv, uri, 100, 100);

//第五种方式：设置加载图片的大小以及加载中和加载失败的图片

//bitmap.display(iv, uri, 100, 100, loadingBitmap, failBitmap);