xUtils3.0使用介绍：网络模块

XUtils3.0的网络请求方法和之前也了比较多的不同，但是整体思路基本一样

网络请求事例：

1. 简单的网络请求事例
2. 上传文件upload事例
3. 文件下载事例
4. 缓存使用示例
5. 回调callback介绍

一：简单的网络请求事例

1，get请求：

 RequestParams params = new RequestParams("https://www.baidu.com/s");
    params.setSslSocketFactory(...); // 设置ssl
    params.addQueryStringParameter("wd", "xUtils");// 加到url里的参数, http://xxxx/s?wd=xUtils
    x.http().get(params, 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();
        }

        @Override
        public void onCancelled(CancelledException cex) {
            Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
        }

        @Override
        public void onFinished() {

        }
    });

2，post请求：

 RequestParams params = new RequestParams("https://www.baidu.com/s");
   params.addBodyParameter("wd", "xUtils");// 添加到请求body体的参数, 只有POST, PUT, PATCH, DELETE请求支持.
    x.http().post(params, 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();
        }

        @Override
        public void onCancelled(CancelledException cex) {
            Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
        }

        @Override
        public void onFinished() {

        }
    });

二：上传文件upload事例

据说xUtils 支持超大文件(超过2G)上传~~~~，这里的事例是post请求通过表单上传

RequestParams params = new RequestParams("http://172.16.6.26:8080/fileupload1/servlet/FileUploadServlet");
//       params.addQueryStringParameter("username", "wingli");// 加到url里的参数, http://xxxx/s?wd=xUtils
         params.addBodyParameter("username", "wingli");// 添加到请求body体的参数, 只有POST, PUT, PATCH, DELETE请求支持.       
        params.setMultipart(true);//使用multipart表单上传文件
        params.addBodyParameter("file",new File("/sdcard/1.avi"),null); // 如果文件没有扩展名, 最好设置contentType参数.
        params.addBodyParameter("file",new File("/sdcard/2.jpg"),null); // 如果文件没有扩展名, 最好设置contentType参数.
        params.addBodyParameter("file",new File("/sdcard/3.jpg"),null); // 如果文件没有扩展名, 最好设置contentType参数.
//        try {
//            params.addBodyParameter("file",
//                    new FileInputStream(new File("/sdcard/1.avi")),"avi",
//                    // 测试中文文件名
//                    "你+& \" 好.avi"); // InputStream参数获取不到文件名, 最好设置, 除非服务端不关心这个参数.
//        } catch (FileNotFoundException ex) {
//            ex.printStackTrace();
//        }
        x.http().post(params, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                System.out.println("onSuccess="+result);
            }
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                System.out.println("onError="+ex);
            }
            @Override
            public void onCancelled(CancelledException cex) { }
            @Override
            public void onFinished() {}
        });
    }

三：文件下载事例

文件下载支持断点下载，调用cancelable.cancel();即可暂停下载。
在这之前研究了一下utils3的demo，感觉配合数据库使用比较方便，特别是断点下载的时候

RequestParams params = new RequestParams("http://172.16.6.26:8080/1.avi");
        params.setAutoResume(true);//设置是否在下载是自动断点续传
        params.setAutoRename(false);//设置是否根据头信息自动命名文件
        params.setSaveFilePath("/sdcard/xutils/xUtils_1.avi");
        params.setExecutor(new PriorityExecutor(2, true));//自定义线程池,有效的值范围[1, 3], 设置为3时, 可能阻塞图片加载.
        params.setCancelFast(true);//是否可以被立即停止.
        cancelable = x.http().get(params, new Callback.ProgressCallback<File>() {
            @Override
            public void onCancelled(CancelledException arg0) {
                System.out.println("onCancelled");
            }

            @Override
            public void onError(Throwable arg0, boolean arg1) {
                // TODO Auto-generated method stub
                System.out.println("onError"+arg0);
            }

            @Override
            public void onFinished() {
                // TODO Auto-generated method stub
                System.out.println("onFinished");
            }

            @Override
            public void onSuccess(File arg0) {
                // TODO Auto-generated method stub
                System.out.println("onSuccess");
            }

            @Override
            public void onLoading(long total, long current, boolean isDownloading) {
                if (isDownloading) {
                    tv.setText(""+(current*100/total)); 
                }
            }

            @Override
            public void onStarted() {
                // TODO Auto-generated method stub
            }

            @Override
            public void onWaiting() {
                // TODO Auto-generated method stub
            }

        });
cancelable.cancel();//暂停下载

四：缓存使用示例

这里设置的是缓存一小时

RequestParams params = new RequestParams("http://www.baidu.com");
        params.setCacheMaxAge(3600*1000); // 默认缓存存活时间, 单位:毫秒.(如果服务没有返回有效的max-age或Expires)
        x.http().get(params, new CacheCallback<String>() {// 使用CacheCallback, xUtils将为该请求缓存数据.
            @Override
            public void onCancelled(CancelledException arg0) {}
            @Override
            public void onFinished() {}
            @Override
            public void onError(Throwable arg0, boolean arg1) {}
            @Override
            public void onSuccess(String arg0) {
                // 注意: 如果服务返回304或 onCache 选择了信任缓存, 这里将不会被调用,
                // 但是 onFinished 总会被调用.
            }
            @Override
            public boolean onCache(String arg0) {
                // 得到缓存数据, 缓存过期后不会进入这个方法.
                // 如果服务端没有返回过期时间, 参考params.setCacheMaxAge(maxAge)方法.
                //
                // * 客户端会根据服务端返回的 header 中 max-age 或 expires 来确定本地缓存是否给 onCache 方法.
                //   如果服务端没有返回 max-age 或 expires, 那么缓存将一直保存, 除非这里自己定义了返回false的
                //   逻辑, 那么xUtils将请求新数据, 来覆盖它.
                //
                // * 如果信任该缓存返回 true, 将不再请求网络;
                //   返回 false 继续请求网络, 但会在请求头中加上ETag, Last-Modified等信息,
                //   如果服务端返回304, 则表示数据没有更新, 不继续加载数据.

                return true;// true: 信任缓存数据, 不在发起网络请求; false不信任缓存数据.
            }
        });

五：回调callback介绍

/**
* 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.RequestInterceptListener}
*
* 5. 其他(线程池, 超时, 重定向, 重试, 代理等): 参考 {@link org.xutils.http.RequestParams}
*
**/