xutils 3.0 post 使用

时间：2023-03-08 17:48:15

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中初始化

@Override

public 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

相关文章