• xUtils 包含了很多实用的android工具.
• xUtils 支持超大文件(超过2G)上传，更全面的http请求协议支持(11种谓词)，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响...
• xUtils 最低兼容Android 4.0 (api level 14). (Android 2.3?)
• xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:
  1. HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略.
  2. 支持标准的Cookie策略, 区分domain, path...
  3. 事件注解去除不常用的功能, 提高性能.
  4. 数据库api简化提高性能, 达到和greenDao一致的性能.
  5. 图片绑定支持gif(受系统兼容性影响, 部分gif文件只能静态显示), webp; 支持圆角, 圆形, 方形等裁剪, 支持自动旋转...

二、配置

使用Gradle构建时添加一下依赖即可:

compile 'org.xutils:xutils:3.3.40'

三、View绑定

事件注解如下：

四、图片加载

加载网络或本地bitmap的时候无需担心再遇到OOM的现象，管理bitmap的内存采用了LRU算法，同时也能避免列表滑动过程中发生图片错位等得现象。加载网络图片时，还可以配置运行线程的数量，缓存路径等。。。通过BitmapUtils的各种构造器，可以很方便的创建出本地缓存路径和缓存的大小，以及内存缓存的大小。

       ImageOptions   imageOptions = new ImageOptions.Builder().setSize(DensityUtil.dip2px(120), DensityUtil.dip2px(120)).setRadius(DensityUtil.dip2px(5))// 如果ImageView的大小不是定义为wrap_content, 不要crop..setCrop(true) // 很多时候设置了合适的scaleType也不需要它.// 加载中或错误图片的ScaleType//.setPlaceholderScaleType(ImageView.ScaleType.MATRIX).setImageScaleType(ImageView.ScaleType.CENTER_CROP).setLoadingDrawableId(R.mipmap.ic_launcher).setFailureDrawableId(R.mipmap.ic_launcher).build();x.image().bind(imageView, url, imageOptions);// assets filex.image().bind(imageView, "assets://test.gif", imageOptions);// local filex.image().bind(imageView, new File("/sdcard/test.gif").toURI().toString(), imageOptions);x.image().bind(imageView, "/sdcard/test.gif", imageOptions);x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);x.image().bind(imageView, "file:/sdcard/test.gif", imageOptions);x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback<Drawable>() {...});x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback<Drawable>() {...});x.image().loadFile(url, imageOptions, new Callback.CommonCallback<File>() {...});

五、网络请求

1、完整版

  RequestParams params = new RequestParams("https://www.baidu.com/");
Callback.Cancelable cancelable= x.http().get(params,new Callback.CommonCallback<String>() {@Overridepublic void onSuccess(String result) {Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();}@Overridepublic void onError(Throwable ex, boolean isOnCallback) {//Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();if (ex instanceof HttpException) { // 网络错误HttpException httpEx = (HttpException) ex;int responseCode = httpEx.getCode();String responseMsg = httpEx.getMessage();String errorResult = httpEx.getResult();// ...} else { // 其他错误// ...}Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();}@Overridepublic void onCancelled(CancelledException cex) {Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();}@Overridepublic void onFinished() {}});// cancelable.cancel(); // 取消请求

post请求：

        RequestParams params = new RequestParams("https://www.baidu.com/");params.addBodyParameter("key",value);Callback.Cancelable cancelable= x.http().post(params,new Callback.CommonCallback<String>() {@Overridepublic void onSuccess(String result) {Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();}@Overridepublic void onError(Throwable ex, boolean isOnCallback) {Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();}@Overridepublic void onCancelled(CancelledException cex) {Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();}@Overridepublic void onFinished() {}});// cancelable.cancel(); // 取消请求

2、简洁版

get请求：

RequestParams params = new RequestParams("https://www.baidu.com/");params.setSslSocketFactory(...); // 设置sslparams.addQueryStringParameter("wd", "xUtils");x.http().get(params, new Callback.CommonCallback<String>() {@Overridepublic void onSuccess(String result) {Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();}@Overridepublic void onError(Throwable ex, boolean isOnCallback) {Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();}@Overridepublic void onCancelled(CancelledException cex) {Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();}@Overridepublic void onFinished() {}});

post请求：

        RequestParams params = new RequestParams("https://www.baidu.com/");params.addBodyParameter("key",value);x.http().post(params,new Callback.CommonCallback<String>() {@Overridepublic void onSuccess(String result) {Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();}@Overridepublic void onError(Throwable ex, boolean isOnCallback) {Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();}@Overridepublic void onCancelled(CancelledException cex) {Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();}@Overridepublic void onFinished() {}});

大家应该发现了，两种版本不就是一样的吗？对，区别就在于，完整版可以通过 Callback.Cancelable接口取消网络请求，而简洁版就不可以

3、带有缓存版

RequsetParams params = new RequsetParams();
// 默认缓存存活时间, 单位:毫秒.(如果服务没有返回有效的max-age或Expires)
params.setCacheMaxAge(1000 * 60);
Callback.Cancelable cancelable// 使用CacheCallback, xUtils将为该请求缓存数据.= x.http().get(params, new Callback.CacheCallback<String>() {private boolean hasError = false;private String result = null;@Overridepublic boolean onCache(String result) {// 得到缓存数据, 缓存过期后不会进入这个方法.// 如果服务端没有返回过期时间, 参考params.setCacheMaxAge(maxAge)方法.//// * 客户端会根据服务端返回的 header 中 max-age 或 expires 来确定本地缓存是否给 onCache 方法.//   如果服务端没有返回 max-age 或 expires, 那么缓存将一直保存, 除非这里自己定义了返回false的//   逻辑, 那么xUtils将请求新数据, 来覆盖它.//// * 如果信任该缓存返回 true, 将不再请求网络;//   返回 false 继续请求网络, 但会在请求头中加上ETag, Last-Modified等信息,//   如果服务端返回304, 则表示数据没有更新, 不继续加载数据.//this.result = result;return false; // true: 信任缓存数据, 不在发起网络请求; false不信任缓存数据.}@Overridepublic void onSuccess(String result) {// 注意: 如果服务返回304 或 onCache 选择了信任缓存, 这时result为null.if (result != null) {this.result = result;}}@Overridepublic void onError(Throwable ex, boolean isOnCallback) {hasError = true;Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();if (ex instanceof HttpException) { // 网络错误HttpException httpEx = (HttpException) ex;int responseCode = httpEx.getCode();String responseMsg = httpEx.getMessage();String errorResult = httpEx.getResult();// ...} else { // 其他错误// ...}}@Overridepublic void onCancelled(CancelledException cex) {Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();}@Overridepublic void onFinished() {if (!hasError && result != null) {// 成功获取数据Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();}}
});

1、初始化配置

DbManager.DaoConfig daoConfig = new DbManager.DaoConfig().setDbName("test.db")// 不设置dbDir时, 默认存储在app的私有目录..setDbDir(new File("/sdcard")) // "sdcard"的写法并非最佳实践, 这里为了简单, 先这样写了..setDbVersion(2).setDbOpenListener(new DbManager.DbOpenListener() {@Overridepublic void onDbOpened(DbManager db) {// 开启WAL, 对写入加速提升巨大db.getDatabase().enableWriteAheadLogging();}}).setDbUpgradeListener(new DbManager.DbUpgradeListener() {@Overridepublic void onUpgrade(DbManager db, int oldVersion, int newVersion) {// TODO: ...// db.addColumn(...);// db.dropTable(...);// ...// or// db.dropDb();}});

2、增

  DbManager db = x.getDb(daoConfig);
//单个插入对象Parent parent = new Parent();try {db.save(parent);} catch (DbException ex) {ex.printStackTrace();}// 批量插入对象List<Parent> parentList = new ArrayList<Parent>();for (int i = 0; i < 1000; i++) {Parent parent = new Parent();parent.setAdmin(true);parent.setDate(new java.sql.Date(1234));parent.setTime(new Date());parent.setEmail(i + "_@qq.com");parentList.add(parent);}start = System.currentTimeMillis();try {db.save(parentList);} catch (DbException ex) {ex.printStackTrace();}

3、删

     List<Parent> parentList = new ArrayList<Parent>();Parent parent = new Parent();//挨个删try {db.delete(parent);} catch (DbException ex) {ex.printStackTrace();}//批量删try {db.delete(parentList);} catch (DbException ex) {ex.printStackTrace();}

4、改

       // test update 更新对象的数据parent.name = "hahaha123";parent.setEmail("wyouflf@gmail.com");db.update(parent);db.update(parent, "name", "email");db.update(Parent.class,WhereBuilder.b("id", "=", 1).and("isAdmin", "=", true),new KeyValue("name", "test_name"), new KeyValue("isAdmin", false));

5、查

        //根据关键词获取一定有序的集合List<Parent> parentList = new ArrayList<Parent>();try {parentList = db.selector(Parent.class).orderBy("id", true).limit(1000).findAll();} catch (DbException ex) {ex.printStackTrace();}//获取第一个。。。。Parent test = db.selector(Parent.class).where("id", "in", new int[]{1, 3, 6}).findFirst();// long count = db.selector(Parent.class).where("id", "in", new int[]{1, 3, 6}).count();// Parent test = db.selector(Parent.class).where("id", "between", new String[]{"1", "5"}).findFirst();//获取该对象的全部数据List<Child> children = db.selector(Child.class).findAll();//选择所有满足条件的对象List<Parent> list = db.selector(Parent.class).where("id", "<", 54).and("time", ">", calendar.getTime()).orderBy("id").limit(10).findAll();//按照一定排序获取全部List<DbModel> dbModels = db.selector(Parent.class).groupBy("name").select("name", "count(name) as count").findAll();

上面都说完了，还要咋总结~~~

就一句话，xutils3，给力！！！