Android项目开发全程（二）--Afinal用法简单介绍

　　本篇博文接上篇的《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开发框架需要用到以下权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

　　以上是github上的Afinal整体介绍，下面介绍一下本项目中需要到的几个功能，由于本次项目很小，仅仅用到了Afinal中的一点点功能：

1、注解方式就可以进行UI绑定和事件绑定，无需使用findViewById和setClickListener等方法，别忘了让Activity继承FinalActivity。

 public class TestActivity extends FinalActivity {
     @ViewInject(id=R.id.bn_click, click="testClick") Button bnClick;
     @ViewInject(id=R.id.tv_show) TextView tvShow;
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         // TODO Auto-generated method stub
         super.onCreate(savedInstanceState);
         setContentView(R.layout.test_main);
     }
     public void testClick(View v){
         tvShow.setText("您点击了确定");
     }
 }

运行结果：　　　　　　　　　　　　　　　

　　   点击确定后-> 

2、FinalHttp的使用，接下来就要开挂了，还是用刚才的Activity，稍作修改让我们来做一下网络请求

　　get方法： 一行代码搞定，直接使用get方法提交请求地址，然后在相关的回调方法中进行结果操作。上面代码给出了三个回调方法

 public class TestActivity extends FinalActivity {
     FinalHttp fh;
     String url = "http://xiaohua.hao.360.cn/m/itxt?page=1";
     @ViewInject(id=R.id.bn_click, click="testClick") Button bnClick;
     @ViewInject(id=R.id.tv_show) TextView tvShow;
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         // TODO Auto-generated method stub
         super.onCreate(savedInstanceState);
         setContentView(R.layout.test_main);
         fh = new FinalHttp();
     }
     public void testClick(View v){
         fh.get(url, new AjaxCallBack<String>(){
             @Override
             public void onStart() {
                 // TODO Auto-generated method stub
                 super.onStart();
                 tvShow.setText("正在请求……");
             }

             @Override
             public void onLoading(long count, long current) {
                 // TODO Auto-generated method stub
                 super.onLoading(count, current);
                 //请求响应过程中会执行此方法，每隔1秒自动回调一次
                 tvShow.setText(current + "/" + count);
             }

             @Override
             public void onSuccess(String t) {
                 // TODO Auto-generated method stub
                 super.onSuccess(t);
                 tvShow.setText(t);
             }

             @Override
             public void onFailure(Throwable t, int errorNo, String strMsg) {
                 // TODO Auto-generated method stub
                 super.onFailure(t, errorNo, strMsg);
                 tvShow.setText("网络异常");
             }
         });
     }
 }

post方法：

 　　　 AjaxParams params = new AjaxParams();
       params.put("username", "testname");
       params.put("password", "123456");
       params.put("profile_picture", new File("/mnt/sdcard/test.jpg")); // 上传文件
       params.put("profile_picture2", inputStream); // 上传数据流
       params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流

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

　　① onStart()请求开始时回调此方法。

　　② onSuccess()请求成功时回调此方法，其中“t”为返回结果。

　　③ onFailure()请求失败时回调此方法。

　　④ onLoading()在请求响应过程中，每隔1秒回调一次此方法。

执行结果如下：

　　

3、FinalBitmap的使用。同样，加载网络图片也是就一行代码 fb.display(imageView,url)。

 public void loadingImg(View v){
         FinalBitmap fb = FinalBitmap.create(this);
         fb.display(ivImg, "http://pic4.nipic.com/20091120/805653_183746006558_2.jpg");
 }　

其中，loadingImg方法是用注解方式绑定在按钮上的事件，ivImg是ImageView控件。点击按钮后就会加载一张网络图片，结果如下：

　　

哈哈，是不是很简单，同时也很给力啊！

本项目目前设计到Afinal的一些用法就这几个，如果想了解更多可以参考：http://www.oschina.net/p/afinal

在项目开中还涉及到了另一个很给力的工具--Jackson，暂时先不介绍了，等在项目中需要到的时候再做介绍。

有了这两样工具，我们的开发工作就大大简化了很多，而且性能绝不比自己纯手工去写网络请求之类的方法性能差。当然，在实际的开发中我们不能这样暴力式的直接使用get和post方法，最好是做一下封装，这样的话既节省了工作量，减少重复代码，又保证了请求方式的规范性，在后续博文中会展开项目的详细介绍。

PS:本来打算只介绍上面这么多呢，因为在将要介绍到的项目中目前只用到上面这几个功能，不过有园友建议再介绍一下FinalDb，OK，再续上一段。

4、FinalDb的使用。

　　其实用Afinal操作数据也是非常方便的，仍然很好的体现着Afinal的风格，一行代码实现保存数据/读取数据。

　　首先建立一个实体对象，用来充当数据表角色。

 public class Note {
     private int id;//id属性必须要有
     private String title;
     private String content;

     /* getter and setter方法一定要有，应为FinalDb会通过setter方法赋值*/
     public int getId() {
         return id;
     }
     public String getTitle() {
         return title;
     }
     public String getContent() {
         return content;
     }
     public void setId(int id) {
         this.id = id;
     }
     public void setTitle(String title) {
         this.title = title;
     }
     public void setContent(String content) {
         this.content = content;
     }
 }

实体类建好了，再写一个测试Activity：

 public class DbTestActivity extends FinalActivity {
     FinalDb fd;
     Note note;
     @ViewInject(id=R.id.et_title) EditText etTitle;
     @ViewInject(id=R.id.et_content) EditText etContent;
     @ViewInject(id=R.id.txt_title) TextView txtTitle;
     @ViewInject(id=R.id.txt_content) TextView txtContent;
     @ViewInject(id=R.id.bn_save, click="saveData") Button bnSave;
     @ViewInject(id=R.id.bn_read, click="readData") Button bnRead;
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         // TODO Auto-generated method stub
         super.onCreate(savedInstanceState);
         setContentView(R.layout.activity_dbtest);
         fd = FinalDb.create(this);
     }

     //利用Afinal注解直接在按钮上绑定事件。
     public void saveData(View v){
         dbSave();
     }

     public void readData(View v){
         dbRead();
     }

     private void dbSave(){
         note = new Note();
         note.setTitle(etTitle.getText().toString());
         note.setContent(etContent.getText().toString());
         //利用FinalDb的save方法保存数据
         fd.save(note);
     }

     private void dbRead(){
         //利用FinalDb的findAll方法查询数据
         List<Note> noteList = fd.findAll(Note.class);
         txtTitle.setText("标题：" + noteList.get(0).getTitle());
         txtContent.setText("内容：" + noteList.get(0).getContent());
     }
 }

布局文件也很简单，也一并贴出来吧。

 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools"
     android:id="@+id/container"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
     android:orientation="vertical">

     <EditText
         android:id="@+id/et_title"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:hint="Input title"
         android:ems="10" >
         <requestFocus />
     </EditText>

     <EditText
         android:id="@+id/et_content"
         android:layout_width="match_parent"
         android:layout_height="wrap_content"
         android:hint="Input content"
         android:ems="10" >
     </EditText>

     <Button
         android:id="@+id/bn_save"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:text="保存到数据库" />

     <Button
         android:id="@+id/bn_read"
         android:layout_width="fill_parent"
         android:layout_height="wrap_content"
         android:text="读取数据" />

     <TextView
         android:id="@+id/txt_title"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="标题：" />

     <TextView
         android:id="@+id/txt_content"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="内容：" />

 </LinearLayout>

执行结果如图，在编辑框输入内容后，单击保存到数据库按钮，程序会执行fd.save方法（如左图），然后我们单击读取数据按钮，就会从数据库中读取出来数据，并显示在下面（如右图）

然后我们在验证一下，是否真的插入了数据库，关闭程序，重新打开后直接点击读取数据按钮，会看到仍然可以读取之前保存过的内容，由于在代码中，只取了数据表中的第一行内容，所以多次保存后仍然只显示第一次写入的数据。（由于手机目前没有root，所以无法直接通过eclipse的File Explorer查看数据库，敬请谅解！）

以上只是简单介绍了一下Afinal的几个用法，希望能起到抛砖引玉的作用，好了，步入正题，在下一遍博文中将要开始咱们的项目之旅......