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("[e-mail]");
        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", "[e-mail]");
  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);