Android Xutils 框架

(转)

目录(?)[-]

1. xUtils简介
2. 目前xUtils主要有四大模块
3. 使用xUtils快速开发框架需要有以下权限
4. 混淆时注意事项
5. DbUtils使用方法
6. ViewUtils使用方法
7. HttpUtils使用方法
1. 普通get方法
2. 使用HttpUtils上传文件 或者 提交数据 到服务器post方法
3. 使用HttpUtils下载文件
8. BitmapUtils 使用方法
9. 其他更多示例代码见sample文件夹中的代码
1. 输出日志 LogUtils

xUtils简介

• xUtils 包含了很多实用的android工具。
• xUtils 源于Afinal框架，对Afinal进行了大量重构，使得xUtils支持大文件上传，更全面的http请求协议支持，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响...
• xUitls最低兼容android 2.2 (api level 8)

目前xUtils主要有四大模块：

• DbUtils模块：

  • android中的orm框架，一行代码就可以进行增删改查；
  • 支持事务，默认关闭；
  • 可通过注解自定义表名，列名，外键，唯一性约束，NOT NULL约束，CHECK约束等（需要混淆的时候请注解表名和列名）；
  • 支持绑定外键，保存实体时外键关联实体自动保存或更新；
  • 自动加载外键关联实体，支持延时加载；
  • 支持链式表达查询，更直观的查询语义，参考下面的介绍或sample中的例子。

• ViewUtils模块：

  • android中的ioc框架，完全注解方式就可以进行UI绑定和事件绑定；
  • 新的事件绑定方式，使用混淆工具混淆后仍可正常工作；
  • 目前支持常用的11种事件绑定，参见ViewCommonEventListener类和包com.lidroid.xutils.view.annotation.event。

• HttpUtils模块：

  • 支持同步，异步方式的请求；
  • 支持大文件上传，上传大文件不会oom；
  • 支持GET，POST，PUT，MOVE，COPY，DELETE，HEAD请求；
  • 下载支持301/302重定向，支持设置是否根据Content-Disposition重命名下载的文件；
  • 返回文本内容的GET请求支持缓存，可设置默认过期时间和针对当前请求的过期时间。

• BitmapUtils模块：

  • 加载bitmap的时候无需考虑bitmap加载过程中出现的oom和android容器快速滑动时候出现的图片错位等现象；
  • 支持加载网络图片和本地图片；
  • 内存管理使用lru算法，更好的管理bitmap内存；
  • 可配置线程加载线程数量，缓存大小，缓存路径，加载显示动画等...

---

使用xUtils快速开发框架需要有以下权限：

<uses-permission android:name="android.permission.INTERNET" /> 

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> 

---

混淆时注意事项：

• 添加Android默认混淆配置${sdk.dir}/tools/proguard/proguard-android.txt
• 不要混淆xUtils中的注解类型，添加混淆配置：-keep class * extends java.lang.annotation.Annotation { *; }
• 对使用DbUtils模块持久化的实体类不要混淆，或者注解所有表和列名称@Table(name="xxx")，@Id(column="xxx")，@Column(column="xxx"),@Foreign(column="xxx",foreign="xxx")；

---

DbUtils使用方法：

DbUtils db = DbUtils.create(this);User user = new User(); //这里需要注意的是User对象必须有id属性，或者有通过@ID注解的属性user.setEmail("wyouflf@qq.com");user.setName("wyouflf");db.save(user); // 使用saveBindingId保存实体时会为实体的id赋值...// 查找Parent entity = db.findById(Parent.class, parent.getId());List<Parent> list = db.findAll(Parent.class);//通过类型查找Parent Parent = db.findFirst(Selector.from(Parent.class).where("name","=","test"));// IS NULLParent Parent = db.findFirst(Selector.from(Parent.class).where("name","=", null));// IS NOT NULLParent Parent = db.findFirst(Selector.from(Parent.class).where("name","!=", null));// WHERE id<54 AND (age>20 OR age<30) ORDER BY id LIMIT pageSize OFFSET pageOffsetList<Parent> list = db.findAll(Selector.from(Parent.class)                                   .where("id" ,"<", 54)                                   .and(WhereBuilder.b("age", ">", 20).or("age", " < ", 30))                                   .orderBy("id")                                   .limit(pageSize)                                   .offset(pageSize * pageIndex));// op为"in"时，最后一个参数必须是数组或Iterable的实现类(例如List等)Parent test = db.findFirst(Selector.from(Parent.class).where("id", "in", new int[]{1, 2, 3}));// op为"between"时，最后一个参数必须是数组或Iterable的实现类(例如List等)Parent test = db.findFirst(Selector.from(Parent.class).where("id", "between", new String[]{"1", "5"}));DbModel dbModel = db.findDbModelAll(Selector.from(Parent.class).select("name"));//select("name")只取出name列List<DbModel> dbModels = db.findDbModelAll(Selector.from(Parent.class).groupBy("name").select("name", "count(name)"));...List<DbModel> dbModels = db.findDbModelAll(sql); // 自定义sql查询db.execNonQuery(sql) // 执行自定义sql...

ViewUtils使用方法

• 完全注解方式就可以进行UI绑定和事件绑定。
• 无需findViewById和setClickListener等。

// 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;// 取消了之前使用方法名绑定事件的方式，使用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中注入：@Overridepublic void onCreate(Bundle savedInstanceState) {    super.onCreate(savedInstanceState);    setContentView(R.layout.main);    ViewUtils.inject(this); //注入view和事件    ...    textView.setText("some text...");    ...}//在Fragment中注入：@Overridepublic 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)

---

HttpUtils使用方法：

普通get方法

HttpUtils http = new HttpUtils();http.send(HttpRequest.HttpMethod.GET,    "http://www.lidroid.com",    new RequestCallBack<String>(){        @Override        public void onLoading(long total, long current, boolean isUploading) {            testTextView.setText(current + "/" + total);        }        @Override        public void onSuccess(ResponseInfo<String> responseInfo) {            textView.setText(responseInfo.result);        }        @Override        public void onStart() {        }        @Override        public void onFailure(HttpException error, String msg) {        }});

---

使用HttpUtils上传文件 或者 提交数据 到服务器（post方法）

RequestParams params = new RequestParams();params.addHeader("name", "value");params.addQueryStringParameter("name", "value");// 只包含字符串参数时默认使用BodyParamsEntity，// 类似于UrlEncodedFormEntity（"application/x-www-form-urlencoded"）。params.addBodyParameter("name", "value");// 加入文件参数后默认使用MultipartEntity（"multipart/form-data"），// 如需"multipart/related"，xUtils中提供的MultipartEntity支持设置subType为"related"。// 使用params.setBodyEntity(httpEntity)可设置更多类型的HttpEntity（如：// MultipartEntity,BodyParamsEntity,FileUploadEntity,InputStreamUploadEntity,StringEntity）。// 例如发送json参数：params.setBodyEntity(new StringEntity(jsonStr,charset));params.addBodyParameter("file", new File("path"));...HttpUtils http = new HttpUtils();http.send(HttpRequest.HttpMethod.POST,    "uploadUrl....",    params,    new RequestCallBack<String>() {        @Override        public void onStart() {            testTextView.setText("conn...");        }        @Override        public void onLoading(long total, long current, boolean isUploading) {            if (isUploading) {                testTextView.setText("upload: " + current + "/" + total);            } else {                testTextView.setText("reply: " + current + "/" + total);            }        }        @Override        public void onSuccess(ResponseInfo<String> responseInfo) {            testTextView.setText("reply: " + responseInfo.result);        }        @Override        public void onFailure(HttpException error, String msg) {            testTextView.setText(error.getExceptionCode() + ":" + msg);        }});

---

使用HttpUtils下载文件：

• 支持断点续传，随时停止下载任务，开始任务

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, // 如果目标文件存在，接着未完成的部分继续下载。服务器不支持RANGE时将从新下载。    true, // 如果从请求返回信息中获取到文件名，下载完成后自动重命名。    new RequestCallBack<File>() {        @Override        public void onStart() {            testTextView.setText("conn...");        }        @Override        public void onLoading(long total, long current, boolean isUploading) {            testTextView.setText(current + "/" + total);        }        @Override        public void onSuccess(ResponseInfo<File> responseInfo) {            testTextView.setText("downloaded:" + responseInfo.result.getPath());        }        @Override        public void onFailure(HttpException error, String msg) {            testTextView.setText(msg);        }});...//调用cancel()方法停止下载handler.cancel();

---

BitmapUtils 使用方法

BitmapUtils bitmapUtils = new BitmapUtils(this);// 加载网络图片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(new PauseOnScrollListener(bitmapUtils, false, true));listView.setOnScrollListener(new PauseOnScrollListener(bitmapUtils, false, true, customListener));

输出日志 LogUtils

// 自动添加TAG，格式： className.methodName(L:lineNumber)// 可设置全局的LogUtils.allowD = false，LogUtils.allowI = false...，控制是否输出log。// 自定义log输出LogUtils.customLogger = new xxxLogger();LogUtils.d("wyouflf");

• 关于作者

  • Email：wyouflf@qq.com,wyouflf@gmail.com
  近来有一些其他网站盗用本博客内容，希望尊重作者。如有问题请留言，转载注明出处。 http://blog.csdn.net/rain_butterfly/article/details/37812371 参考：http://www.oschina.net/p/xutils

• 项目git地址https://github.com/wyouflf/xUtils

  实例：数据传递接口定义

  1 public interface IOAuthCallBack {  2     public void getIOAuthCallBack(String result);  3 }  

• 接口调用：

  [java] view plain copy print ?
  1. newxUtilsPost().cancelOrder(
  2. PZTuanApplication.appUserName,
  3. orderId+"",newIOAuthCallBack(){
  5. publicvoidgetIOAuthCallBack(
  6. Stringresult){
  7. //TODOAuto-generatedmethodstub
  8. try{
  9. JSONObjectjo=newJSONObject(
  10. result);
  11. Messagemsg=cancelOrder
  12. .obtainMessage(id,jo);
  13. cancelOrder.sendMessage(msg);
  14. }catch(JSONExceptione){
  15. //TODOAuto-generatedcatch
  16. //block
  17. e.printStackTrace();
  18. }
  20. }
  21. });

  实例，BitmapUtils：

• [java] view plain copy print ?
  1. publicclassxUtilsImageLoader{//框架里面设置了缓存和异步操作，不用单独设置线程池和缓存机制（也可以自定义缓存路径）
  3. privateBitmapUtilsbitmapUtils;
  4. privateContextmContext;
  6. publicxUtilsImageLoader(Contextcontext){
  7. //TODOAuto-generatedconstructorstub
  8. this.mContext=context;
  9. bitmapUtils=newBitmapUtils(mContext);
  10. bitmapUtils.configDefaultLoadingImage(R.drawable.logo_new);//默认背景图片
  11. bitmapUtils.configDefaultLoadFailedImage(R.drawable.logo_new);//加载失败图片
  12. bitmapUtils.configDefaultBitmapConfig(Bitmap.Config.RGB_565);//设置图片压缩类型
  14. }
  15. /**
  16. *
  17. *@authorsunglasses
  18. *@category图片回调函数
  19. */
  20. publicclassCustomBitmapLoadCallBackextends
  21. DefaultBitmapLoadCallBack<ImageView>{
  23. @Override
  24. publicvoidonLoading(ImageViewcontainer,Stringuri,
  25. BitmapDisplayConfigconfig,longtotal,longcurrent){
  26. }
  28. @Override
  29. publicvoidonLoadCompleted(ImageViewcontainer,Stringuri,
  30. Bitmapbitmap,BitmapDisplayConfigconfig,BitmapLoadFromfrom){
  31. //super.onLoadCompleted(container,uri,bitmap,config,from);
  32. fadeInDisplay(container,bitmap);
  33. }
  35. @Override
  36. publicvoidonLoadFailed(ImageViewcontainer,Stringuri,
  37. Drawabledrawable){
  38. //TODOAuto-generatedmethodstub
  39. }
  40. }
  42. privatestaticfinalColorDrawableTRANSPARENT_DRAWABLE=newColorDrawable(
  43. android.R.color.transparent);
  44. /**
  45. *@authorsunglasses
  46. *@category图片加载效果
  47. *@paramimageView
  48. *@parambitmap
  49. */
  50. privatevoidfadeInDisplay(ImageViewimageView,Bitmapbitmap){//目前流行的渐变效果
  51. finalTransitionDrawabletransitionDrawable=newTransitionDrawable(
  52. newDrawable[]{TRANSPARENT_DRAWABLE,
  53. newBitmapDrawable(imageView.getResources(),bitmap)});
  54. imageView.setImageDrawable(transitionDrawable);
  55. transitionDrawable.startTransition(500);
  56. }
  57. publicvoiddisplay(ImageViewcontainer,Stringurl){//外部接口函数
  58. bitmapUtils.display(container,url,newCustomBitmapLoadCallBack());
  59. }
  60. }

• 实例：HttpGet：

• [java] view plain copy print ?
  1. publicclassxUtilsGet{//自动实现异步处理，自己不用处理
  3. publicvoidgetJson(Stringurl,RequestParamsparams,finalIOAuthCallBackiOAuthCallBack){
  5. HttpUtilshttp=newHttpUtils();
  6. http.configCurrentHttpCacheExpiry(1000*10);//设置超时时间
  7. http.send(HttpMethod.GET,url,params,newRequestCallBack<String>(){//接口回调
  9. @Override
  10. publicvoidonFailure(HttpExceptionarg0,Stringarg1){
  11. //TODOAuto-generatedmethodstub
  12. }
  14. @Override
  15. publicvoidonSuccess(ResponseInfo<String>info){
  16. //TODOAuto-generatedmethodstub
  17. iOAuthCallBack.getIOAuthCallBack(info.result);//利用接口回调数据传输
  18. }
  19. });
  20. }
  21. publicvoidgetCataJson(intcityId,IOAuthCallBackiOAuthCallBack){//外部接口函数
  22. Stringurl="http://xxxxxxxxxx";
  23. RequestParamsparams=newRequestParams();
  24. params.addQueryStringParameter("currentCityId",cityId+"");
  25. getJson(url,params,iOAuthCallBack);
  26. }
  27. }

• 实例：HttpPost（和HttpGet类似）：

• [java] view plain copy print ?
  1. publicclassxUtilsPost{//自动实现异步处理
  3. publicvoiddoPost(Stringurl,RequestParamsparams,
  4. finalIOAuthCallBackiOAuthCallBack){
  6. HttpUtilshttp=newHttpUtils();
  7. http.configCurrentHttpCacheExpiry(1000*10);
  8. http.send(HttpMethod.POST,url,params,newRequestCallBack<String>(){
  10. @Override
  11. publicvoidonFailure(HttpExceptionarg0,Stringarg1){
  12. //TODOAuto-generatedmethodstub
  13. }
  15. @Override
  16. publicvoidonSuccess(ResponseInfo<String>info){
  17. //TODOAuto-generatedmethodstub
  18. iOAuthCallBack.getIOAuthCallBack(info.result);
  19. }
  20. });
  21. }
  23. publicvoiddoPostLogin(intcityId,IOAuthCallBackiOAuthCallBack){
  24. Stringurl="http://xxxxxxxxxxxx";
  25. RequestParamsparams=newRequestParams();
  26. params.addBodyParameter("currentCityId",cityId+"");
  27. params.addBodyParameter("path","/apps/postCatch");
  28. doPost(url,params,iOAuthCallBack);
  29. }
  30. }

更多相关文章

1. Android应用开发提高系列（5）――Android动态加载（下）――加载已安装A
2. Android 图片高效加载
3. Android Bitmap 的加载和 Cache 缓存 笔记
4. Android ButterKnife注解框架使用

随机推荐

1. android 编译碰到的问题及解决办法:(ubun
2. (android)向sdcard中添加文件出现Failed
3. Android(安卓)IPC机制（三）使用AIDL实现
4. Android开发环境及Hello World程序
5. 使用ContentProvider读取短信，备份短信
6. 你的Android库是否还在Application中初始
7. Android9.0 默认是禁止所有的http java.i
8. Android(安卓)应用软件开发（十）Handler使用
9. 获取手机屏幕大小
10. android DIY 2