Android网络框架xUtils的Http网络数据请求操作

xUtils:当前比较火的框架，并且用处也是比较多。

一．目前xUtils主要有四大模块：

DbUtils模块：用于数据库的操作，也是需要注解方式指定表名和列名；
ViewUtils模块：注解方式就可以进行UI，资源和事件绑定；
HttpUtils模块：用于网络数据的请求；
BitmapUtils模块：用于图片的下载和绑定视图；

本文主要讲解xUtils中的Http网络数据请求操作。

使用：
AndroidStudio使用xUtils之前添加依赖就可以了：

    compile 'org.xutils:xutils:3.3.38'

GitHub中的源码地址：https://github.com/wyouflf/xUtils3

二．使用示例

（一）添加依赖语句

compile 'org.xutils:xutils:3.3.38'

（二）添加权限

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

（三）在自己的Application中的onCreate方法里注册xutils

x.Ext.init(this);

这里要记得在AndroidManifest中添加Application中的name。

（四）设计布局activity_main.xml文件

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">


    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onClick="btn1"
        android:text="btn1" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onClick="btn2"
        android:text="btn2" />

    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onClick="btn3"
        android:text="btn3" />

</LinearLayout>

（五）java代码设计

package fuxi.xutils;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Toast;

import org.xutils.common.Callback;
import org.xutils.http.RequestParams;
import org.xutils.x;

/**
 * xUtils中的HttpUtils的使用示例
 */

public class HttpUtilsDemo extends AppCompatActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main2);
    }

    /**
     * get的方式请求网络字符串数据
     * 这里请求的是html百度网页的源码数据
     */
    public void btn1(View view) {
        //设置Url地址
        RequestParams entity = new RequestParams("https://www.baidu.com");
        //数据请求，这里先要设置回到的call接口对象,数据在接口对象的方法中获取
        x.http().get(entity, call);

    }

    /**
     * get的方式请求网络json字符串数据
     * 传入一些键值对的值
     * 这里演示的是ShowAPI网站中的示例
     */
    public void btn2(View view) {
        //设置Url地址
        RequestParams entity = new RequestParams("http://route.showapi.com/341-3?");
        entity.addQueryStringParameter("showapi_appid", "13074");
        entity.addQueryStringParameter("showapi_sign", "ea5b4bf2e140498bb772d1bf2a51a7a0");
        //数据请求，这里先要设置回到的call接口对象,数据在接口对象的方法中获取
        x.http().get(entity, call);
    }

    /**
     * get的方式请求网络数据
     * 这里使用的是有缓存的数据的请求
     */
    public void btn3(View view) {
        RequestParams entity = new RequestParams("https://www.baidu.com");
        // 默认缓存存活时间, 单位:毫秒.(如果服务没有返回有效的max-age或Expires)
        entity.setCacheMaxAge(1000 * 60);
        // 使用CacheCallback, xUtils将为该请求缓存数据.
        Callback.Cancelable cancelable = x.http().get(entity, new Callback.CacheCallback<String>() {

            private boolean hasError = false;
            private String result = null;

            @Override
            public boolean onCache(String result) {
                // 得到缓存数据, 缓存过期后不会进入这个方法.
                // * 如果信任该缓存返回 true, 将不再请求网络;
                //   返回 false 继续请求网络, 但会在请求头中加上ETag, Last-Modified等信息,
                //   如果服务端返回304, 则表示数据没有更新, 不继续加载数据.
                this.result = result;
                return false; // true: 信任缓存数据, 不在发起网络请求; false不信任缓存数据.
            }

            @Override
            public void onSuccess(String result) {
                // 注意: 如果服务返回304 或 onCache 选择了信任缓存, 这时result为null.
                if (result != null) {
                    this.result = result;
                }
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                hasError = true;
                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() {
                if (!hasError && result != null) {
                    // 成功获取数据
                    Toast.makeText(x.app(), "finish" + result, Toast.LENGTH_LONG).show();
                }
            }
        });


    }

    /**
     * 网络请求时的callBack回调对象
     */
    Callback.CommonCallback call = 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(Callback.CancelledException cex) {
            Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
        }

        @Override
        public void onFinished() {

        }
    };


}

程序运行后的界面：

点击第一个按钮，请求到的百度页面的源码数据：

点击第二个按钮获取到json数据：

点击第三个按钮请求到，有缓存的百度网页源码数据

      上面就是简单的示例演示，Post请求比较复杂一些。
      并且这个xUtils框架工具一直在更新，我看网上大部分的用法都已经过时了。有点纠结的就是原作者的标注解释也不多！

      这里请求到了json数据就可以就行处理获取到对应的数据，一般还有使用gson网络框架解析成Bean对象。