AFinal-開源android應用框架簡介

正文

1. 官方網站

開源中國社區AFinal項目

2. 簡介

Afinal 是一個android的sqlite orm 和 ioc 框架。 同時封裝了android中的http框架，使其更加簡單易用；使用finalBitmap，無需考慮bitmap在android
中加載的時候oom的問題和快速滑動的時候圖片加載位置錯位等問題。 Afinal的宗旨是簡潔，快速。約定大於配置的方式。盡量一行代碼完成所有事情。

什麼是orm？

對象關系映射（英語：Object Relational Mapping，簡稱ORM，或O/RM，或O/R mapping），是一種程序技術，用於實現面向對象編程語言裡不同類型系統的數據之間的轉換。從效果上說，它其實是創建了一個可在編程語言裡使用的“虛擬對象數據庫”。
詳情見 這裡

什麼是ioc？

控制反轉（Inversion of Control，英文縮寫為IoC）是一個重要的面向對象編程的法則來削減計算機程序的耦合問題，也是輕量級的Spring框架的核心。 控制反轉一般分為兩種類型，依賴注入（Dependency Injection，簡稱DI）和依賴查找（Dependency Lookup）。依賴注入應用比較廣泛。
詳情見 這裡

3.目前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顯示圖片的時候播放動畫等（默認是漸變動畫顯示）。

什麼是ajax？

AJAX即“Asynchronous Javascript And XML”（異步JavaScript和XML），是指一種創建交互式網頁應用的網頁開發技術。通過在後台與服務器進行少量數據交換，AJAX 可以使網頁實現異步更新。這意味著可以在不重新加載整個網頁的情況下，對網頁的某部分進行更新。
詳情見 這裡

什麼是LRU算法？

LRU是Least Recently Used 近期最少使用算法。內存管理的一種頁面置換算法，對於在內存中但又不用的數據塊（內存塊）叫做LRU，操作系統會根據哪些數據屬於LRU而將其移出內存而騰出空間來加載另外的數據。
詳情見 這裡

4.FinalDB使用方法

關於finalDb的更多介紹，請點擊這裡

    FinalDb db = FinalDb.create(this);
    User user = new User(); //這裡需要注意的是User對象必須有id屬性，或者有通過@ID注解的屬性
    user.setEmail("[email protected]");
    user.setName("michael yang");
    db.save(user);

5. 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");
    }
}

什麼是java注解？

注解（Annotation），也叫元數據。一種代碼級別的說明。它是JDK5.0及以後版本引入的一個特性，與類、接口、枚舉是在同一個層次。它可以聲明在包、類、字段、方法、局部變量、方法參數等的前面，用來對這些元素進行說明，注釋。 作用分類：
①編寫文檔：通過代碼裡標識的元數據生成文檔【生成文檔doc文檔】
② 代碼分析：通過代碼裡標識的元數據對代碼進行分析【使用反射】
③編譯檢查：通過代碼裡標識的元數據讓編譯器能夠實現基本的編譯檢查【Override】

詳情見 這裡

6.FinalHttp使用方法

普通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", "[email protected]");
  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();

7.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]);

8.未完待續

《AFinal-開源android應用框架DB模塊詳解》敬請關注~~~