文档章节

开源项目:XUtil详解

SuShine
 SuShine
发布于 2015/10/14 11:27
字数 2010
阅读 924
收藏 3
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" />


一、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)


二、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();

三、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));
四、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();
  }

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

本文转载自:http://blog.csdn.net/kun5069073/article/details/45645663

SuShine
粉丝 130
博文 598
码字总数 158700
作品 0
朝阳
后端工程师
私信 提问
加载中

评论(1)

448522141
448522141
79
android 7种网络连接方式《IT蓝豹》

本项目由作者 王永飞 精心为初学者准备的学习项目。 android 几种网络连接方式,本项目适合初学者学习网络知识。 项目中用到一下几种网络请求方式: (1):HttpClient 方式获取网络数据 (2...

抉择很难
2015/11/13
92
0
问题请教,xutil框架

@Jack_1900 你好,想跟你请教个问题: 你好,最近学习利用xutil框架进行开发,dbutil封装了jdbc,但是它的数据库连接的URl是在哪里配置的呢,xutil实现的机制是什么呢...

limiaoneu
2015/09/26
233
0
android 7种网络连接方式--IT蓝豹

本项目由作者 王永飞 精心为初学者准备的学习项目。 android 几种网络连接方式,本项目适合初学者学习网络知识。 项目中用到一下几种网络请求方式: (1):HttpClient 方式获取网络数据 (2...

抉择很难
2015/11/12
32
0
Android哪个开发框架最好用?

如题。。Android哪个开发框架最好用?AndBase?XUtil? 。。。。。。。。。等等???????????

开源中国原谅帽派送员
2018/05/08
3.3K
1
xutil怎么实现断点上传

@艾东磊 你好,想跟你请教个问题:xutil断点续传怎么实现的,万分感谢

飞黄腾达5858
2014/12/23
1K
2

没有更多内容

加载失败,请刷新页面

加载更多

在Linux下使用linuxdeployqt发布Qt程序

目录 一、简介 二、安装linuxdeployqt 三、配置 qt 的环境变量 四、打包应用程序 五、编写linux桌面图标启动(可选步骤) 六、编写开机脚本 runApp.sh 七、打包成deb包 八、扩展 回到顶部 一...

shzwork
24分钟前
4
0
Linux进程管理

计算机硬件层面之上是操作系统,狭义的操作系统主要指系统内核,内核有以下作用:进程管理、文件系统、网络管理、内存管理、驱动程序、安全功能。内核可以将用户无法操作的底层硬件接口进行抽...

lhdzw
昨天
4
0
Java13的新特性

Java语言特性系列 Java5的新特性 Java6的新特性 Java7的新特性 Java8的新特性 Java9的新特性 Java10的新特性 Java11的新特性 Java12的新特性 Java13的新特性 Java14的新特性 序 本文主要讲述...

go4it
昨天
7
0
IDEA 配置Springboot项目热部署

实现的方式概述 注意以下的热部署方式在IDEA是默认没有打开自动编译的,手动编译需要快捷键(Ctrl+Shift+F9),自动编译的修改配置如下:(注意刷新不要太快,会有1-2秒延迟) File-Settings-C...

小强的进阶之路
昨天
10
0
免费数据分析工具:secsoso

前段时间思考了理想数据分析平台,之后我们根据这个思路开发了spl语言并提供了一个数据分析平台,这个平台主要用在搜索ES,数据库索引中的数据。但后来发现对文件的事后处理也是个非常重要的...

赛克蓝德
昨天
12
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部