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的幾個用法，希望能起到拋磚引玉的作用，好了，步入正題，在下一遍博文中將要開始咱們的項目之旅......