開源項目:XUtil詳解

xUtils簡介
xUtils 包含了不少實用的android工具。
xUtils 最初源於Afinal框架,進行了大量重構,使得xUtils支持大文件上傳,更全面的http請求協議支持(10種謂詞),擁有更加靈活的ORM,更多的事件註解支持且不受混淆影響...

xUitls最低兼容android 2.2 (api level 8)

目前xUtils主要有四大模塊:
ViewUtils模塊:
android中的ioc框架,徹底註解方式就能夠進行UI,資源和事件綁定;
新的事件綁定方式,使用混淆工具混淆後仍可正常工做;
目前支持經常使用的20種事件綁定,參見ViewCommonEventListener類和包com.lidroid.xutils.view.annotation.event。

HttpUtils模塊:
支持同步,異步方式的請求;
支持大文件上傳,上傳大文件不會oom;
支持GET,POST,PUT,MOVE,COPY,DELETE,HEAD,OPTIONS,TRACE,CONNECT 請求;
下載支持301/302重定向,支持設置是否根據Content-Disposition重命名下載的文件;
返回文本內容的請求(默認只啓用了GET請求)支持緩存,可設置默認過時時間和針對當前請求的過時時間。

BitmapUtils模塊:
加載bitmap的時候無需考慮bitmap加載過程當中出現的oom和android容器快速滑動時候出現的圖片錯位等現象;
支持加載網絡圖片和本地圖片;
內存管理使用lru算法,更好的管理bitmap內存;
可配置線程加載線程數量,緩存大小,緩存路徑,加載顯示動畫等...

DbUtils模塊:
android中的orm框架,一行代碼就能夠進行增刪改查;
支持事務,默認關閉;
可經過註解自定義表名,列名,外鍵,惟一性約束,NOT NULL約束,CHECK約束等(須要混淆的時候請註解表名和列名);
支持綁定外鍵,保存實體時外鍵關聯實體自動保存或更新;
自動加載外鍵關聯實體,支持延時加載;
支持鏈式表達查詢,更直觀的查詢語義,參考下面的介紹或sample中的例子。



XUtil使用方法:

使用xUtils快速開發框架須要有如下權限:
<uses-permissionandroid:name="android.permission.INTERNET" />
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE" />


1、ViewUtils使用方法:
徹底註解方式就能夠進行UI綁定和事件綁定。
無需findViewById和setClickListener等。
1.view註解
// xUtils的view註解要求必須提供id,以使代碼混淆不受影響。
@ViewInject ( R . id . textView )  TextView textView;
//@ViewInject(vale=R.id.textView, parentId=R.id.parentView)
//TextView textView;

@ResInject(id = R.string.label, type = ResType.String)
private String label;

2.監聽的註解
// 取消了以前使用方法名綁定事件的方式,使用id綁定不受混淆影響
// 支持綁定多個id 
@OnClick({R.id.id1, R.id.id2, R.id.id3})
// or @OnClick(value={R.id.id1, R.id.id2, R.id.id3}, parentId={R.id.pid1, R.id.pid2, R.id.pid3})
// 更多事件支持參見ViewCommonEventListener類和包com.lidroid.xutils.view.annotation.event。
@OnClick(R.id.test_button)
public void testButtonClick(View v){     
            // 方法簽名必須和接口中的要求一致
}
註解完後,必須在activity或者fragment中注入view與事件

3.注入view與事件
//在Activity中注入:
@Override
public void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
  setContentView(R.layout.main);
  ViewUtils.inject(this);//注入view和事件...
  textView.setText("some text...");
}

//在Fragment中注入:
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState){
  View view = inflater.inflate(R.layout.bitmap_fragment, container,false);// 加載fragment佈局
  ViewUtils.inject(this, view);//注入view和事件
}

//在PreferenceFragment中注入:
public void onActivityCreated(Bundle savedInstanceState){
super.onActivityCreated(savedInstanceState);
  ViewUtils.inject(this, getPreferenceScreen());//注入view和事件
}

// 其餘重載
// inject(View view);
// inject(Activity activity)
// inject(PreferenceActivity preferenceActivity)
// inject(Object handler, View view)
// inject(Object handler, Activity activity)
// inject(Object handler, PreferenceGroup preferenceGroup)
// inject(Object handler, PreferenceActivity preferenceActivity)


2、HttpUtils使用方法:
1.GET方式提交數據
         //RequestParams params = new RequestParams(); // 默認編碼UTF-8
        //params.addHeader("name", "value");
        //params.addQueryStringParameter("name", "value");

        HttpUtils http = new HttpUtils();
        http.configCurrentHttpCacheExpiry(1000 * 10);
        http.send(HttpRequest.HttpMethod.GET,
                " http://www.baidu.com",
                //params,
                new RequestCallBack<String>() {

                    @Override
                    public void onStart() {
                        resultText.setText("conn...");
                    }

                    @Override
                    public void onLoading(long total, long current, boolean isUploading) {
                        resultText.setText(current + "/" + total);
                    }

                    @Override
                    public void onSuccess(ResponseInfo<String> responseInfo) {
                        resultText.setText("response:" + responseInfo.result);
                    }


                    @Override
                    public void onFailure(HttpException error, String msg) {
                        resultText.setText(msg);
                    }
                });
2.POST方式上傳文件或者提交數據 到服務器
        // 設置請求參數的編碼
        //RequestParams params = new RequestParams("GBK");
        RequestParams params = new RequestParams();  // 默認編碼UTF-8

        //params.addQueryStringParameter("qmsg", "你好");
       // 添加數據
        //params.addBodyParameter("msg", "測試");

         // 添加文件
        params.addBodyParameter("file", new File("/sdcard/test.zip"));
         // 繼續添加文件
        //params.addBodyParameter("testfile", new File("/sdcard/test2.zip"));
   
         // 用於非multipart表單的單文件上傳
        //params.setBodyEntity(new FileUploadEntity(new File("/sdcard/test.zip"), "binary/octet-stream"));

         // 用於非multipart表單的流上傳
        //params.setBodyEntity(new InputStreamUploadEntity(stream ,length));

        HttpUtils http = new HttpUtils();

         // 設置返回文本的編碼, 默認編碼UTF-8
        //http.configResponseTextCharset("GBK");

         // 自動管理 cookie
        http.configCookieStore(preferencesCookieStore);

       http.send(HttpRequest.HttpMethod.POST,
                "http://192.168.1.5:8080/UploadServlet",
                params,
                new RequestCallBack<String>() {
                    @Override
                    public void onStart() {
                      //開始
                        resultText.setText("conn...");
                    }
                    @Override
                    public void onLoading(long total, long current, boolean isUploading) {
                      //進度
                        if (isUploading) {
                            resultText.setText("upload: " + current + "/" + total);
                        } else {
                            resultText.setText("reply: " + current + "/" + total);
                        }
                    }
                    @Override
                    public void onSuccess(ResponseInfo<String> responseInfo) {
                      //成功  返回的結果:responseInfo.result
                        resultText.setText("reply: " + responseInfo.result);
                    }
                    @Override
                    public void onFailure(HttpException error, String msg) {
                      //失敗  錯誤信息:msg
                        resultText.setText(msg);
                    }
                });
3.支持斷點續傳,隨時中止下載任務,開始任務
HttpUtils http = new HttpUtils();

  HttpHandler handler = http.download(
    "http://apache.dataguru.cn/httpcomponents/httpclient/source/httpcomponents-client-4.2.5-src.zip",
    "/sdcard/httpcomponents-client-4.2.5-src.zip", 
     true,  //boolean autoResume:若是目標文件存在,接着未完成的部分繼續下載。服務器不支持RANGE時將重新下載。
     true,  //boolean autoRename:若是從請求返回信息中獲取到文件名,下載完成後自動重命名。
     new RequestCallBack<File>() {
     @Override
     public void onStart() {
       // 開始
      resultText.setText("conn...");
     }
     @Override
     public void onLoading(long total, long current, boolean isUploading) {
       // 進度
      if (isUploading) {
       resultText.setText("upload: " + current + "/" + total);
      } else {
       resultText.setText("reply: " + current + "/" + total);
      }
     }
     @Override
     public void onSuccess(ResponseInfo<File> responseInfo) {
       // 成功 返回的結果:responseInfo.result
      resultText.setText("reply: " + responseInfo.result);
     }
     @Override
     public void onFailure(HttpException error, String msg) {
       // 失敗 錯誤信息:msg
      resultText.setText(msg);
     }
  // 調用cancel()方法中止下載
    handler.cancel();

3、BitmapUtils 使用方法:
      //BitmapUtils能夠說單例的 ,頁能夠根據須要重載多個獲取實例
      BitmapUtils bitmapUtils =newBitmapUtils(this);// 
        //設置默認加載圖片
        bitmapUtils.configDefaultLoadingImage(R.drawable.ic_launcher);
         //設置失敗後加載的圖片
        bitmapUtils.configDefaultLoadFailedImage(R.drawable.bitmap);
         //設置Bitmap參數
        bitmapUtils.configDefaultBitmapConfig(Bitmap.Config.RGB_565);
         //內存緩存是否可用
        //bitmapUtils.configMemoryCacheEnabled(false);
         //硬盤緩存是否可用
        //bitmapUtils.configDiskCacheEnabled(false);
        //
        //bitmapUtils.configDefaultAutoRotation(true);
         //尺寸縮放動畫
        //ScaleAnimation animation = new ScaleAnimation(0.0f, 1.0f, 0.0f, 1.0f,
        //        Animation.RELATIVE_TO_SELF, 0.5f, Animation.RELATIVE_TO_SELF, 0.5f);
        //animation.setDuration(800);
         //設置默認圖片加載動畫
        //bitmapUtils.configDefaultImageLoadAnimation(animation);
         // 設置最大寬高, 不設置時更具控件屬性自適應.
        bitmapUtils.configDefaultBitmapMaxSize(BitmapCommonUtils.getScreenSize(getActivity()).scaleDown(3));
         // 滑動時加載圖片,快速滑動時不加載圖片
        //imageListView.setOnScrollListener(new PauseOnScrollListener(bitmapUtils, false, true));


        //加載網絡圖片
        bitmapUtils.display(testImageView,"http://bbs.lidroid.com/static/image/common/logo.png");
         // 加載本地圖片(路徑以/開頭, 絕對路徑)
        bitmapUtils.display(testImageView,"/sdcard/test.jpg");
         // 加載assets中的圖片(路徑以assets開頭)
        bitmapUtils.display(testImageView,"assets/img/wallpaper.jpg");

         // 使用ListView等容器展現圖片時可經過PauseOnScrollListener控制滑動和快速滑動過程當中時候暫停加載圖片
        listView.setOnScrollListener(newPauseOnScrollListener(bitmapUtils,false,true));
        listView.setOnScrollListener(newPauseOnScrollListener(bitmapUtils,false,true, customListener));
4、DbUtils使用方法:
實體類必須有id( @Id )的字段
實體類的如何定義?模仿下面定義的實體類
實體類:
package com.example.dbdemo;
import java.util.Date;
import com.lidroid.xutils.db.annotation.Column;
import com.lidroid.xutils.db.annotation.Finder;
import com.lidroid.xutils.db.annotation.Id;
import com.lidroid.xutils.db.annotation.Table;
import com.lidroid.xutils.db.annotation.Transient;
import com.lidroid.xutils.db.sqlite.FinderLazyLoader;
@Table(name = "person")// 建議加上註解, 混淆後表名不受影響
public class Person {
  //必須有的屬性
 @Id
 private int id;
 @Column(column = "name")
 private String name;
 
 @Column(column = "email")
 private String email;
 
 @Column(column = "isAdmin")
    private boolean isAdmin;

     @Column(column = "time")
    private Date time;
 // Transient使這個列被忽略,不存入數據庫
 @Transient
 private String willIgnore;
 // 靜態字段也不會存入數據庫
 private static String staticFieldWillIgnore;

  @Finder(valueColumn = "id", targetColumn = "parentId")
 public FinderLazyLoader<Child> children;  // 關聯對象多時建議使用這種方式,延遲加載效率較高。
 
 // @Finder(valueColumn = "id",targetColumn = "parentId")
 // public Child children;
 // @Finder(valueColumn = "id", targetColumn = "parentId")
 // private List<Child> children;
 public String getName() {
  return name;
 }
 public void setName(String name) {
  this.name = name;
 }
 public String getEmail() {
  return email;
 }
 public void setEmail(String email) {
  this.email = email;
 }
 public int getId() {
  return id;
 }
 public void setId(int id) {
  this.id = id;
 }
 public String getWillIgnore() {
  return willIgnore;
 }
 public void setWillIgnore(String willIgnore) {
  this.willIgnore = willIgnore;
 }
 public boolean isAdmin() {
  return isAdmin;
 }
 public void setAdmin(boolean isAdmin) {
  this.isAdmin = isAdmin;
 }
 public Date getTime() {
  return time;
 }
 public void setTime(Date time) {
  this.time = time;
 }
 
 
}

方法調用:
//  DbUtils 的建立有多個create方法,根據各自需求
DbUtils dbUtils = DbUtils.create(this, "demo.db");
  dbUtils.configAllowTransaction(true);
  dbUtils.configDebug(true);
 
 
  Person p= new Person();
  p.setEmail("3333");
  p.setName("makk");
  p.setAdmin(true);
 
  p.setTime(new Date());
 
  Child child = new Child();
  child.name = "child' name";
 
  try {
   dbUtils.save(p);
// 保存對象關聯數據庫生成的id
// dbUtils.saveBindingId(p);
    //其餘操做
   //刪除
   dbUtils.delete(p);
    //更新
   dbUtils.update(p, "name","email");
    //查找
   dbUtils.findAll(Selector.from(Person.class).where("id", "in", new int[] { 1, 3, 6 }));
  } catch (DbException e) {
   e.printStackTrace();
  }

5、輸出日誌 LogUtils:
// 自動添加TAG,格式: className.methodName(L:lineNumber)
// 可設置全局的LogUtils.allowD = false,LogUtils.allowI = false...,控制是否輸出log。
// 自定義log輸出LogUtils.customLogger = new xxxLogger();
LogUtils.d("wyouflf");
相關文章
相關標籤/搜索