AFinal-開源android應用程式框架簡介

標籤：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(){@Overridepublic void onLoading(long count, long current) {    textView.setText(current+"/"+count);}@Overridepublic 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模組詳解》敬請關注~~~

AFinal-開源android應用程式框架簡介