Xutils使用手册（四）——网络请求

Xutils使用手册——网络请求

网络请求方法介绍

方法介绍

1，回调对象介绍

xutils提供了两种回调对象，即通用回调对象和缓存回调对象

通用的回调对象

//普通的网络请求回调对象，这个回调对象里没有提供缓存方法
        Callback.CommonCallback<String> commonCallback = new Callback.CommonCallback<String>() {
            @Override
            public void onCancelled(CancelledException cex) {
                //请求被取消时回调此方法
            }
 
            @Override
            public void onSuccess(String result) {
                //请求成功时回调方法，其中result参数为请求到的数据
            }
 
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                //请求过程中出现错误时回调此方法
            }
 
            @Override
            public void onFinished() {
                //整个请求过程结束的回调方法
            }
        };

缓存回调对象

//带缓存的网络请求对调对象，此回调对象提供了本地缓存机制，对于长时间不变的数据可以使用此对象
        Callback.CacheCallback<String> cacheCallback = new Callback.CacheCallback<String>() {
            /**
             * 此方法为本地加载回调方法，本地没有数据则不会调用此方法
             * @param result 缓存中得到的数据
             * @return true 如果缓存中有数据就不再进行网络请求
             *          false 得到缓存数据后仍进行网络请求
             */
            @Override
            public boolean onCache(String result) {
                return false;
            }
 
            @Override
            public void onSuccess(String result) {
            }
 
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
            }
 
            @Override
            public void onCancelled(CancelledException cex) {
            }
 
            @Override
            public void onFinished() {
            }
        };

进度实时回调对象

//带下载进度的回调方法
        Callback.ProgressCallback progressCallback=new Callback.ProgressCallback() {
            /**
             * 下载暂停时回调方法
             */
            @Override
            public void onWaiting() {
            }
 
            /**
             * 下载开始时回调的方法
             */
            @Override
            public void onStarted() {
            }
 
            /**
             * 下载进度实时回调的方法
             * @param total 文件总大小
             * @param current 当前已下载大小
             * @param isDownloading 当前下载状态
             */
            @Override
            public void onLoading(long total, long current, boolean isDownloading) {
            }
 
            @Override
            public void onSuccess(Object result) {
            }
 
            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
            }
 
            @Override
            public void onCancelled(CancelledException cex) {
            }
 
            @Override
            public void onFinished() {
            }
        };

2，请求参数对象介绍

RequestParams requestParams = new RequestParams("http://www.google.com");
        /**
         *  以下方法请根据需求进行设置，如果没有需求请不要随意进行设置
         */
        //设置请求代理
        {
            //设置代理地址和端口
            InetSocketAddress address = new InetSocketAddress("127.0.0.1", 8080);
            //创建代理对象
            //参数说明（代理方式：DIRECT 直接连接不使用代理、HTTP 代理或者 SOCKET 代理，端口对象）
            Proxy proxy = new Proxy(Proxy.Type.DIRECT, address);
            requestParams.setProxy(proxy);
        }
 
        //是否根据头信息自动命名文件
        {
            requestParams.setAutoRename(false);
        }
 
        //数据下载时是否使用断点续传
        {
            requestParams.setAutoResume(true);
        }
 
        //设置缓存文件夹、缓存容量以及缓存存活时间
        {
            requestParams.setCacheDirName("dir");
            requestParams.setCacheSize(1024l);
            requestParams.setCacheMaxAge(3l * 60 * 60 * 1000);//单位为毫秒
 
        }
 
        //下载文件时指定文件保存地址
        {
            requestParams.setSaveFilePath("filePath");
        }
 
        //如果需要获取下载进度的话，下载进度的刷新时间默认为300ms
        {
            requestParams.setLoadingUpdateMaxTimeSpan(1000);
        }
 
        /**
         * 以下为设置请求参数
         */
        //设置请求头
        requestParams.addHeader("user-agent","android-19");
        
        //通用的参数存放方法,此方法会根据参数信息自动判断参数提交方式
        requestParams.addParameter("name",new Object());
        //如果参数过长，请直接指定
        requestParams.addBodyParameter("name","long String");

3，发送请求

Callback.Cancelable request;
        //get请求
        request = x.http().get(requestParams, commonCallback);
        //post请求
        request = x.http().post(requestParams, commonCallback);
        //自定义请求方式，xutils提供了11中请求方式参数
        request = x.http().request(HttpMethod.GET, requestParams, commonCallback);
 
        if (!request.isCancelled())//判断当前请求是否中断
            request.cancel();//中断请求

到这里 常用的方法都已经介绍完毕了。

转载于:https://my.oschina.net/oschenxiaomo/blog/680813