你的位置:首页 > 操作系统

[操作系统]xUtils 3.0 post使用详解


 

github:https://github.com/wyouflf/xUtils3

xUtils3简介

  • 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, webp; 支持圆角, 圆形, 方形等裁剪, 支持自动旋转

 

使用前配置

需要的权限
<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

初始化
// 在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<String>() {      @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注册.

 

 

混淆:

proguard-project中加入: 

 -libraryjars libs/xUtils-3.1.14.jar 

   -keep class com.lidroid.** { *; } 

   -keepattributes Signature