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快速開發框架需要有以下權限：
|
1
2
|
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
|
-
第一個是訪問網絡
-
第二個是訪問sdcard
-
訪問網絡是請求網絡圖片的時候需要或者是http數據請求時候需要，訪問sdcard是圖片緩存的需要。
FinalDB使用方法
關於finalDb的更多介紹，請點擊這裏
|
1
2
3
4
5
|
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等
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
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方法
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
|
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方法）
文件上傳到服務器，服務器如何接收，請查看這裏
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
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下載文件：
-
支持斷點續傳，隨時停止下載任務 或者 開始任務
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
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重載請看幫助文檔
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
|
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]);
|
