关于xUtils用法的总结

先还是按照常规来个xUtils的简介

xUtils是源于Afinal框架的一个android快速开发框架，它对Afinal进行了大量重构，使得xUtils支持大文件上传，更全面的http请求协议支持，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响。

      xUtils主要包括四个部分：View，Db, Http, Bitmap 四个模块。 

View 模块主要的功能是通过注解绑定 UI，资源，事件。

Db 模块是一个数据库 orm 框架， 简单的语句就能进行数据的操作。

Http 模块主要访问网络，支持同步，异步方式的请求，支持文件的下载。

Bitmap 模块是加载图片以及图片的处理， 支持加载本地，网络图片。而且支持图片的内存和本地缓存。

目前xUtils主要有四大模块：

• DbUtils模块：

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

• 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内存；
  • 可配置线程加载线程数量，缓存大小，缓存路径，加载显示动画等...

这部分内容参考xUtils作者对xUtils的介绍 https://github.com/wyouflf/xUtils

接下来详细介绍xUtils的使用

在使用之前，先得添加以下权限

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

DBUtils：

先来看一下具体的设计流程图

                          

对于数据库，无非就是增删改查，正如上文提到的DBUtils就是采用 orm（对象关系映射Object Relational Mapping）框架，一行代码就可以进行增删改查，关于不知道什么是ORM的请参考http://www.cnblogs.com/tonybinlj/archive/2008/01/10/1032728.html

使用DBUtils主要涉及到下面几个方法：

delete； findAll； findById； saveOrUpdate；// 当数据库没有时保存， 存在时修改。 update；

下面是详细的用法

DbUtils db = DbUtils.create(this);
User user = new User(); //这里需要注意的是User对象必须有id属性，或者有通过@ID注解的属性
user.setEmail("[email protected]");
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 NULL
Parent Parent = db.findFirst(Selector.from(Parent.class).where("name","=", null));
// IS NOT NULL
Parent 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 pageOffset
List<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

对于ViewUtils大家可以参考https://github.com/wyouflf/xUtils，我在此并不做详细的介绍，我想给大家介绍另一个东西

butterknife，与ViewUtils类似的是都是使用注释的方式注入进行UI绑定，但是butterknife与ViewUtils不同的是它并不是使用反射的方式，而是使用APT的方式生成辅助类，这样在性能上比使用反射有所提升，它主要的开销只是在编译时刻做的注释处理。而且对于butterknife还有相应的插件，使用起来非常方便

具体使用可以参考http://stormzhang.com/openandroid/android/2014/01/12/android-butterknife/

如果想对butterknife作更加深入的了解请参考我之前写的一篇文章ButterKnife源码解析

关于butterknife插件使用可以参考：8 个最优秀的 Android Studio 插件之 Android ButterKnife Zelezny，当然这篇文章中也有其他几个不错的插件，有几个是收费的，如果有兴趣可以自己去探索。

HttpUtils

还是先上一张图

流程图：

          

类图：

        

详细用法：

1.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) {
        }
});

2.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);
        }
});

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, // 如果目标文件存在，接着未完成的部分继续下载。服务器不支持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();
...

有兴趣的还可以去了解下Volley框架具体参考 Android中的Volley框架解析、 Volley 源码解析，这里引用一段别人的总结

和 Volley 框架相比

相同点：

• 1.采用了网络数据缓存机制。
• 2.通过 handler 进行线程通信

不同点：

• 1. Volley 的 Http 请求在 android 2.3 版本之前是通过 HttpClient，在之后的版本是通过 URLHttpConnection。xUtils 都是通过 HttpClient 请求网络（bitmap 模块图片下载是通过 URLHttpConnection）。 URLHttpConnection 默认支持 GZIP 压缩，api 操作简单。
• 2.Volley 将 Http 请求数据先缓存进 byte[]， 然后是分配给不同的请求转化为需要的格式。xUtils 是直接转化为想要的格式。 Volley：扩展性好， 但是不能存在大数据请求，否则就 OOM。xUtils：不缓存入 byte[] 支持大数据的请求， 速度比 Volley 稍快，但扩展性就低。
• 4.Volley 访问网络数据时直接开启固定个数线程访问网络， 在 run 方法中执行死循环， 阻塞等待请求队列。 xUtils 是开启线程池来管理线程。
• 1. 缓存失效策略， volley 的所有网络数据支持从 http 响应头中控制是否缓存和读取缓存失效时间，每个请求可以控制是否缓存和缓存失效时间。 Xutils 网络数据请求是统一自定义缓存失效时间。

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));

想要更详细的了解xUtils框架，请参考我之前的文章xUtils 源码解析

其实android有很多很实用的框架，平时多学习几个，码代码会高效很多，bug也会少很多，而且有兴趣去看看这些优秀框架的源码也是一种很大的提升。