開源專案之Android Afinal框架

yangxi_001發表於2014-07-11
Android框架

專案如圖：


本文參考網路！

Afinal是一個開源的android的orm和ioc應用開發框架，其特點是小巧靈活，程式碼入侵量少。在android應用開發中，通過Afinal的ioc框架，諸如ui繫結，事件繫結，通過註解可以自動繫結。通過Afinal的orm框架，無需任何配置資訊，一行程式碼就可以對android的sqlite資料庫進行增刪改查操作。同時，Afinal內嵌了finalHttp等簡單易用的工具，可以輕鬆的對http就行求情的操作。Afinal的宗旨是簡潔，快速。約定大於配置的方式。儘量一行程式碼完成所有事情。


Afinal框架的各個模組帶來了的便捷

1、FinalDB模組：android中的orm框架，一行程式碼就可以進行增刪改查。支援一對多，多對一等查詢。 
2、FinalActivity模組：android中的ioc框架，完全註解方式就可以進行UI繫結和事件繫結。無需findViewById和setClickListener等。 
3、FinalHttp模組：通過httpclient進行封裝http資料請求，支援ajax方式載入。 
4、FinalBitmap模組：通過FinalBitmap，imageview載入bitmap的時候無需考慮bitmap載入過程中出現的oom和android容器快速滑動時候出現的圖片錯位等現象。FinalBitmap可以配置執行緒載入執行緒數量，快取大小，快取路徑，載入顯示動畫等。FinalBitmap的記憶體管理使用lru演算法，沒有使用弱引用（android2.3以後google已經不建議使用弱引用，android2.3後強行回收軟引用和弱引用，詳情檢視android官方文件），更好的管理bitmap記憶體。FinalBitmap可以自定義下載器，用來擴充套件其他協議顯示網路圖片，比如ftp等。同時可以自定義bitmap顯示器，在imageview顯示圖片的時候播放動畫等（預設是漸變動畫顯示）。


將Afinal框架帶進你的工程的過程

1.下載Afinal的jar包。推薦到GIT上下載（https://github.com/yangfuhai/afinal），這裡不僅提供了Afinal 的jar包，還包括Afinal的原始碼以及詳細API。 
2.將下載後的jar包新增到Android工程裡面。相信大家都會，不過也可能會遇到當新增了Afinal包後，繼承FinalActivity的Activity會報java.lang.classNotFound這種錯誤，這種情況你最好將Afinal 包直接拷貝到Android工程的lib資料夾裡面。這時你看Android的Dependencies包裡面如果有了Afinal包就再次執行APK應該就不會有錯了。 
3.一個依賴Afinal包的工程還需要新增它所需要的許可權：我們在AndroidManifest.xml檔案裡面新增如下許可權：

[java] view plaincopy
  1. <uses-permission android:name="android.permission.INTERNET" />  
[java] view plaincopy
  1.  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />  


Afinal框架的各個模組的具體使用

FinalDB使用方法：

[java] view plaincopy
  1. FinalDb db = FinalDb.create(this);  
  2.    
  3. User user = new User();  
  4.   
  5. user.setEmail("mail@tsz.net");  
  6.   
  7. user.setId(1);  
  8.   
  9. user.setName("michael yang");  
  10.   
  11.   
  12. db.save(user);  

FinalActivity使用方法：

[java] view plaincopy
  1. public class AfinalDemoActivity extends FinalActivity {  
  2.      //無需呼叫findViewById和setOnclickListener等  
  3.     @ViewInject(id=R.id.button,click="btnClick") Button button;  
  4.     @ViewInject(id=R.id.textView) TextView textView;  
  5.           
  6.     public void onCreate(Bundle savedInstanceState) {  
  7.         super.onCreate(savedInstanceState);  
  8.         setContentView(R.layout.main);  
  9.     }  
  10.     public void btnClick(View v){  
  11.         textView.setText("text set form button");  
  12.     }  
  13. }  

FinalHttp使用方法：

[java] view plaincopy
  1. FinalHttp fh = new FinalHttp();  
  2. fh.get("http://www.yangfuhai.com", new AjaxCallBack(){  
  3.     @Override  
  4.     public void onLoading(long count, long current) { //每1秒鐘自動被回撥一次  
  5.             textView.setText(current+"/"+count);  
  6.     }  
  7.     @Override  
  8.     public void onSuccess(String t) {  
  9.             textView.setText(t==null?"null":t);  
  10.     }  
  11.     @Override  
  12.     public void onStart() {  
  13.         //開始http請求的時候回撥  
  14.     }  
  15.     @Override  
  16.     public void onFailure(Throwable t, String strMsg) {  
  17.         //載入失敗的時候回撥  
  18.     }  
  19. });  

上傳檔案 或者提交資料：

[java] view plaincopy
  1. AjaxParams params = new AjaxParams();  
  2.  params.put("username", "michael yang");  
  3.  params.put("password", "123456");  
  4.  params.put("email", "test@tsz.net");  
  5.  params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上傳檔案  
  6.  params.put("profile_picture2", inputStream); // 上傳資料流  
  7.  params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交位元組流  
  8.  FinalHttp fh = new FinalHttp();  
  9.  fh.post("http://www.yangfuhai.com", params, new AjaxCallBack(){  
  10.         @Override  
  11.         public void onLoading(long count, long current) {  
  12.                 textView.setText(current+"/"+count);  
  13.         }  
  14.         @Override  
  15.         public void onSuccess(String t) {  
  16.             textView.setText(t==null?"null":t);  
  17.         }  
  18.  });  

使用FinalHttp下載檔案：

[java] view plaincopy
  1. FinalHttp fh = new FinalHttp();    
  2. fh.download("http://www.xxx.com/下載路徑/xxx.apk", "/mnt/sdcard/testapk.apk", new AjaxCallBack() {    
  3.                 @Override    
  4.                 public void onLoading(long count, long current) {    
  5.                      textView.setText("下載進度："+current+"/"+count);    
  6.                 }    
  7.     
  8.                 @Override    
  9.                 public void onSuccess(File t) {    
  10.                     textView.setText(t==null?"null":t.getAbsoluteFile().toString());    
  11.                 }    
  12.     
  13.             });    

[java] view plaincopy
  1.   
FinalBitmap 使用方法 (載入網路圖片就一行程式碼 fb.display(imageView,url))：

[java] view plaincopy
  1.  private GridView gridView;  
  2. private FinalBitmap fb;  
  3. @Override  
  4. protected void onCreate(Bundle savedInstanceState) {  
  5.     super.onCreate(savedInstanceState);  
  6.     setContentView(R.layout.images);  
  7.       
  8.     gridView = (GridView) findViewById(R.id.gridView);  
  9.     gridView.setAdapter(mAdapter);  
  10.       
  11.     fb = new FinalBitmap(this).init();//必須呼叫init初始化FinalBitmap模組  
  12.     fb.configLoadingImage(R.drawable.downloading);  
  13.     //這裡可以進行其他十幾項的配置，也可以不用配置，配置之後必須呼叫init()函式,才生效  
  14.     //fb.configBitmapLoadThreadSize(int size)  
  15.     //fb.configBitmapMaxHeight(bitmapHeight)  
  16. }  
[java] view plaincopy
  1. ///////////////////////////adapter getView////////////////////////////////////////////  
  2.   
  3. public View getView(int position, View convertView, ViewGroup parent) {  
  4.     ImageView iv;  
  5.     if(convertView == null){  
  6.         convertView = View.inflate(BitmapCacheActivity.this,R.layout.image_item, null);  
  7.         iv = (ImageView) convertView.findViewById(R.id.imageView);  
  8.         iv.setScaleType(ScaleType.CENTER_CROP);  
  9.         convertView.setTag(iv);  
  10.     }else{  
  11.         iv = (ImageView) convertView.getTag();  
  12.     }  
  13.     //bitmap載入就這一行程式碼，display還有其他過載，詳情檢視原始碼  
  14.     fb.display(iv,Images.imageUrls[position]);  
  15.     return convertView;  
  16. }  

相關文章