Android開發框架 afinal

Android快速開發框架Afinal已經遷移至github,地址是:https://github.com/yangfuhai/afina 

Afinal是一個orm、ioc框架,遵循約定大於配置原則,無需任何配置即可完成所有工作,但也可以通過配置達到個人的個性化需求。Afinal提倡代碼快速簡潔,儘量一行代碼完成的事情不會用兩行。

Afinal裏面目前包含了四大組件:
FinalHttp:用於請求http數據,直接ajax方式請求,文件上傳, 斷點續傳下載文件等
FinalBitmap:用於顯示bitmap圖片,而無需考慮線程併發和oom等問題。
FinalActivity:完全可以通過註解方式綁定控件和事件,無需編寫代碼。
FinalDb:android中sqlite的orm框架,一行代碼搞定增刪改查。

目前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" />

  • 第一個是訪問網絡

  • 第二個是訪問sdcard

  • 訪問網絡是請求網絡圖片的時候需要或者是http數據請求時候需要,訪問sdcard是圖片緩存的需要。


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

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


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();

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

Afinal 0.5 發佈,Android快速開發框架


此次更新內容如下:

1、finalDb 修復排序查詢的bug
2、FinalDB 添加dropDb方法 (感謝 kvgnt 在github上push代碼)
3、FinalBitmap 重新設計了 緩存框架,加載圖片速度明顯提升
4、FinalBitmap 支持任何view的圖片加載,不在僅僅只是imageview(非imageView設置加載完成後設置其背景,用在常用語一些佈局文件背景中)
5、FinalBtimap 支持加載本地圖片,不僅僅只是網絡圖片
6、FinalBitmap 添加弱引用的支持(永遠不會oom,這個開關由用戶配置)
7、FinalHttp 添加出現網絡異常的時候,返回網絡異常編號,方便用戶進行自己的業務邏輯


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章