xUtils 3.0 post使用详解-白红宇

xUtils 3.0 post使用详解

阅读量：5999 次

发布时间：2019-06-20

本文共 4045 字，大约阅读时间需要 13 分钟。

github：

xUtils3简介

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

xUtils 支持超大文件(超过2G)上传，更全面的http请求协议支持(11种谓词)，拥有更加灵活的ORM，更多的事件注解支持且不受混淆影响...

xUtils 最低兼容Android 4.0 (api level 14). ()

xUtils3变化较多所以建立了新的项目不在旧版(github.com/wyouflf/xUtils)上继续维护, 相对于旧版本:
1. HTTP实现替换HttpClient为UrlConnection, 自动解析回调泛型, 更安全的断点续传策略.
2. 支持标准的Cookie策略, 区分domain, path...
3. 事件注解去除不常用的功能, 提高性能.
4. 数据库api简化提高性能, 达到和greenDao一致的性能.
5. 图片绑定支持gif, webp; 支持圆角, 圆形, 方形等裁剪, 支持自动旋转

使用前配置

需要的权限

初始化

// 在application的onCreate中初始化@Overridepublic void onCreate() {    super.onCreate();    x.Ext.init(this);    x.Ext.setDebug(true); // 是否输出debug日志}

POST 请求

/** * 自定义实体参数类请参考: * 请求注解 {
    @link org.xutils.http.annotation.HttpRequest} * 请求注解处理模板接口 {
    @link org.xutils.http.app.ParamsBuilder} * * 需要自定义类型作为callback的泛型时, 参考: * 响应注解 {
    @link org.xutils.http.annotation.HttpResponse} * 响应注解处理模板接口 {
    @link org.xutils.http.app.ResponseParser} * * 示例: 查看 org.xutils.sample.http 包里的代码 */RequestParams params = new RequestParams (url);

// 有上传文件时使用multipart表单, 否则上传原始文件流.// params.setMultipart(true);// 上传文件方式 1// params.uploadFile = new File("/sdcard/test.txt");// 上传文件方式 2 params.addBodyParameter("uploadFile", new File("/sdcard/test.txt"));Callback.Cancelable cancelable       = x.http().post(params,       /**        * 1. callback的泛型:        * callback参数默认支持的泛型类型参见{
     @link org.xutils.http.loader.LoaderFactory},        * 例如: 指定泛型为File则可实现文件下载, 使用params.setSaveFilePath(path)指定文件保存的全路径.        * 默认支持断点续传(采用了文件锁和尾端校验续传文件的一致性).        * 其他常用类型可以自己在LoaderFactory中注册,        * 也可以使用{
     @link org.xutils.http.annotation.HttpResponse}        * 将注解HttpResponse加到自定义返回值类型上, 实现自定义ResponseParser接口来统一转换.        * 如果返回值是json形式, 那么利用第三方的json工具将十分容易定义自己的ResponseParser.        * 如示例代码{
     @link org.xutils.sample.http.BaiduResponse}, 可直接使用BaiduResponse作为        * callback的泛型.        *        * 2. callback的组合:        * 可以用基类或接口组合个种类的Callback, 见{
     @link org.xutils.common.Callback}.        * 例如:        * a. 组合使用CacheCallback将使请求检测缓存或将结果存入缓存(仅GET请求生效).        * b. 组合使用PrepareCallback的prepare方法将为callback提供一次后台执行耗时任务的机会,        * 然后将结果给onCache或onSuccess.        * c. 组合使用ProgressCallback将提供进度回调.        * ...(可参考{
     @link org.xutils.image.ImageLoader}        * 或 示例代码中的 {
     @link org.xutils.sample.download.DownloadCallback})        *        * 3. 请求过程拦截或记录日志: 参考 {
     @link org.xutils.http.app.RequestTracker}        *        * 4. 请求Header获取: 参考 {
     @link org.xutils.http.app.InterceptRequestListener}        *        * 5. 其他(线程池, 超时, 重定向, 重试, 代理等): 参考 {
     @link org.xutils.http.RequestParams        *        **/       new Callback.CommonCallback
     
      () {           @Override           public void onSuccess(String result) {               Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();           }           @Override           public 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();           }           @Override           public void onCancelled(CancelledException cex) {               Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();           }           @Override           public void onFinished() {           }       });// cancelable.cancel(); // 取消// 如果需要记录请求的日志, 可使用RequestTracker接口(优先级依次降低, 找到一个实现后会忽略后面的):// 1. 自定义Callback同时实现RequestTracker接口;// 2. 自定义ResponseParser同时实现RequestTracker接口;// 3. 在LoaderFactory注册.