xUtils 包含了很多实用的android工具。

xUtils 最初源于Afinal框架,进行了大量重构,使得xUtils支持大文件上传,更全面的http请求协议支持(10种谓词),拥有更加灵活的ORM,更多的事件注解支持且不受混淆影响...

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

  • 目前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快速开发框架需要有以下权限:

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

-libraryjars ./libs/android_utils.jar

-keep class com.lidroid.xutils.**{*;}
-keepattributes *Annotation*
-keep class * extends java.lang.annotation.Annotation { *; }

-keep class com.lidroid.** { *; }      #xutils包下所有类不要混淆,包括类里面的方法
-keep class * extends java.lang.annotation.Annotation { *; }   #注解包下的所有内容不要混淆,ViewUitls有用到

-keep class com.XXX.app.login.XXXFragment    #用到注解的地方也要加上来

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 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使用方法

  • 完全注解方式就可以进行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中注入:
@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)

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");
项目git地址https://github.com/wyouflf/xUtils
  • 实例:数据传递接口定义
    1. public interface IOAuthCallBack {
    2. public void getIOAuthCallBack(String result);
    3. }
  • 接口调用:
    1. new xUtilsPost().cancelOrder(
    2. PZTuanApplication.appUserName,
    3. orderId + "", new IOAuthCallBack() {
    4. public void getIOAuthCallBack(
    5. String result) {
    6. // TODO Auto-generated method stub
    7. try {
    8. JSONObject jo = new JSONObject(
    9. result);
    10. Message msg = cancelOrder
    11. .obtainMessage(id, jo);
    12. cancelOrder.sendMessage(msg);
    13. } catch (JSONException e) {
    14. // TODO Auto-generated catch
    15. // block
    16. e.printStackTrace();
    17. }
    18. }
    19. });
    
    
    实例,BitmapUtils:
    1. public class xUtilsImageLoader {//框架里面设置了缓存和异步操作,不用单独设置线程池和缓存机制(也可以自定义缓存路径)
    2. private BitmapUtils bitmapUtils;
    3. private Context mContext;
    4. public xUtilsImageLoader(Context context) {
    5. // TODO Auto-generated constructor stub
    6. this.mContext = context;
    7. bitmapUtils = new BitmapUtils(mContext);
    8. bitmapUtils.configDefaultLoadingImage(R.drawable.logo_new);//默认背景图片
    9. bitmapUtils.configDefaultLoadFailedImage(R.drawable.logo_new);//加载失败图片
    10. bitmapUtils.configDefaultBitmapConfig(Bitmap.Config.RGB_565);//设置图片压缩类型
    11. }
    12. /**
    13. *
    14. * @author sunglasses
    15. * @category 图片回调函数
    16. */
    17. public class CustomBitmapLoadCallBack extends
    18. DefaultBitmapLoadCallBack<ImageView> {
    19. @Override
    20. public void onLoading(ImageView container, String uri,
    21. BitmapDisplayConfig config, long total, long current) {
    22. }
    23. @Override
    24. public void onLoadCompleted(ImageView container, String uri,
    25. Bitmap bitmap, BitmapDisplayConfig config, BitmapLoadFrom from) {
    26. // super.onLoadCompleted(container, uri, bitmap, config, from);
    27. fadeInDisplay(container, bitmap);
    28. }
    29. @Override
    30. public void onLoadFailed(ImageView container, String uri,
    31. Drawable drawable) {
    32. // TODO Auto-generated method stub
    33. }
    34. }
    35. private static final ColorDrawable TRANSPARENT_DRAWABLE = new ColorDrawable(
    36. android.R.color.transparent);
    37. /**
    38. * @author sunglasses
    39. * @category 图片加载效果
    40. * @param imageView
    41. * @param bitmap
    42. */
    43. private void fadeInDisplay(ImageView imageView, Bitmap bitmap) {//目前流行的渐变效果
    44. final TransitionDrawable transitionDrawable = new TransitionDrawable(
    45. new Drawable[] { TRANSPARENT_DRAWABLE,
    46. new BitmapDrawable(imageView.getResources(), bitmap) });
    47. imageView.setImageDrawable(transitionDrawable);
    48. transitionDrawable.startTransition(500);
    49. }
    50. public void display(ImageView container,String url){//外部接口函数
    51. bitmapUtils.display(container, url,new CustomBitmapLoadCallBack());
    52. }
    53. }
  • 实例:HttpGet:
    1. public class xUtilsGet {//自动实现异步处理,自己不用处理
    2. public void getJson(String url,RequestParams params,final IOAuthCallBack iOAuthCallBack){
    3. HttpUtils http = new HttpUtils();
    4. http.configCurrentHttpCacheExpiry(1000 * 10);//设置超时时间
    5. http.send(HttpMethod.GET, url, params, new RequestCallBack<String>() {//接口回调
    6. @Override
    7. public void onFailure(HttpException arg0, String arg1) {
    8. // TODO Auto-generated method stub
    9. }
    10. @Override
    11. public void onSuccess(ResponseInfo<String> info) {
    12. // TODO Auto-generated method stub
    13. iOAuthCallBack.getIOAuthCallBack(info.result);//利用接口回调数据传输
    14. }
    15. });
    16. }
    17. public void getCataJson(int cityId,IOAuthCallBack iOAuthCallBack) {//外部接口函数
    18. String url = "http://xxxxxxxxxx";
    19. RequestParams params = new RequestParams();
    20. params.addQueryStringParameter("currentCityId", cityId+"");
    21. getJson(url,params,iOAuthCallBack);
    22. }
    23. }
  • 实例:HttpPost(和HttpGet类似):
    1. public class xUtilsPost {   //自动实现异步处理
    2. public void doPost(String url, RequestParams params,
    3. final IOAuthCallBack iOAuthCallBack) {
    4. HttpUtils http = new HttpUtils();
    5. http.configCurrentHttpCacheExpiry(1000 * 10);
    6. http.send(HttpMethod.POST, url, params, new RequestCallBack<String>() {
    7. @Override
    8. public void onFailure(HttpException arg0, String arg1) {
    9. // TODO Auto-generated method stub
    10. }
    11. @Override
    12. public void onSuccess(ResponseInfo<String> info) {
    13. // TODO Auto-generated method stub
    14. iOAuthCallBack.getIOAuthCallBack(info.result);
    15. }
    16. });
    17. }
    18. public void doPostLogin(int cityId, IOAuthCallBack iOAuthCallBack) {
    19. String url = "http://xxxxxxxxxxxx";
    20. RequestParams params = new RequestParams();
    21. params.addBodyParameter("currentCityId", cityId + "");
    22. params.addBodyParameter("path", "/apps/postCatch");
    23. doPost(url, params, iOAuthCallBack);
    24. }
    25. }

开发框架XUtils的更多相关文章

  1. Android 最火的快速开发框架XUtils

    参考:http://www.oschina.net/p/xutils 项目git地址https://github.com/wyouflf/xUtils 目录(?)[-] 最近搜了一些框架供初学者学习比 ...

  2. Android 快速开发框架XUtils

    转载自:http://www.apkbus.com/forum.php?mod=viewthread&tid=241060&highlight=xUtils 最近搜了一些框架供初学者学 ...

  3. 【转】Android 最火的快速开发框架XUtils

    原文:http://blog.csdn.net/rain_butterfly/article/details/37812371 最近搜了一些框架供初学者学习,比较了一下XUtils是目前git上比较活 ...

  4. Android 最火开发框架 xUtils

    xUtils简介 xUtils3 api变化较多, 已转至 https://github.com/wyouflf/xUtils3 xUtils 2.x对Android 6.0兼容不是很好, 请尽快升级 ...

  5. android高速开发框架xUtils

    xUtils简单介绍 xUtils 包括了非常多有用的android工具. xUtils 支持大文件上传,更全面的http请求协议支持(10种谓词).拥有更加灵活的ORM,很多其它的事件注解支持且不受 ...

  6. Android 最火的高速开发框架xUtils

    Github下载地址:https://github.com/wyouflf/xUtils xUtils简单介绍 xUtils 包括了非常多有用的Android工具. xUtils 最初源于Afinal ...

  7. xutils 框架

    1. android快速开发框架xUtils xUtils简介 xUtils 包含了很多实用的android工具. xUtils 支持大文件上传,更全面的http请求协议支持(10种谓词),拥有更加灵 ...

  8. 【转】Android 最火框架XUtils之注解机制详解

    原文:http://blog.csdn.net/rain_butterfly/article/details/37931031 在上一篇文章Android 最火的快速开发框架XUtils中简单介绍了x ...

  9. Android 最火框架XUtils之注解机制具体解释

    在上一篇文章Android 最火的高速开发框架XUtils中简介了xUtils的基本用法,这篇文章说一下xUtils里面的注解原理. 先来看一下xUtils里面demo的代码: @ViewInject ...

随机推荐

  1. Java-J2SE学习笔记-查找一个String中,subString的出现次数

    1.查找一个String中,subString的出现次数 2.代码 package Test; public class TestStringContain { public static void ...

  2. 如何用虚拟机装SQL Server

    更新(2016.3.14) 看来之前还是写的太简了,来问的同学有点多. 所以还是详细一些吧. 大概步骤 装好Virtual Box这个软件,免费的 下载window server 2003系统镜像,然 ...

  3. POSIX、XNU

    POSIX 表示可移植操作系统接口(Portable Operating System Interface ,缩写为 POSIX ),POSIX标准定义了操作系统应该为应用程序提供的接口标准,是IEE ...

  4. 传统三层结构和MVC之于贫血模式和充血模式以及领域建模

      相信很多人跟我一样,一开始在使用贫血模式的三层结构:抽象出来一个贫血的实体封装,然后把对模型的所有操作,分离出来,分离到BLL层去,然后DALL层负责把这些操作和数据库产生映射,负责读写删改的操作 ...

  5. 【资料分享】 OpenCV精华收藏

    OpenCV精华收藏 SkySeraph Dec.29th 2010  HQU Email:zgzhaobo@gmail.com    QQ:452728574 Latest Modified Dat ...

  6. Angular service

    <!DOCTYPE html> <html lang="en" ng-app="myApp"> <head> <met ...

  7. HDU 2852 KiKi's K-Number 树状数组 + 二分

    一共最多才100000个数,并且数值范围0~100000. 树状数组 C[i] 记录数值为 i 的数有多少个. 删除时如果Query( a ) - Query( a - 1 ) == 0 则该数不存在 ...

  8. iReport —— 使用 JavaBean 作为数据源

    在制作报表时,想直接使用Java代码提供数据. 网上找了一些文章,很多都是用Servlet做的.我不是想通过浏览器来观察它的输出.我想使用iReport的动态连接直接预览. 结合一些资料,加上自己的摸 ...

  9. [原]POJ-1631-Bridging signals-( 水LIS-O(nlogn) -DP)

    题目大意:求最长上升子序列(LIS)长度,序列最大数不超过40000.因为只有上升排列的接口才不相交. 思路:普通的 O(n^2)的做法肯定会超时:因此,dp[ ] 记录长度为 i+1 的子序列中最末 ...

  10. 利用SOLR搭建企业搜索平台 之——solr的查询语法

      1. 首先假设我的数据里fields有:name, tel, address 预设的搜寻是name这个字段, 如果要搜寻的数据刚好就是 name 这个字段,就不需要指定搜寻字段名称. 2. 查询规 ...