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