Android Retrofit2使用教程-小白篇

如果你还不是很清楚retrofit是干嘛的，那我简单地用一句大白话来说明：它就是用来进行网络请求的。
Retrofit使用注解的方式将我们的HTTP请求转变为一个接口。

我个人崇尚“先学会基本用法，再学会高级用法，最后采取了解原理”，下面我会手把手教导你如何使用Retrofit2进行最简单的HTTP Get请求。

这里，我们使用一个手机归属地查询的API进行测试：
http://cx.shouji.360.cn/phonearea.php?number=13188888888

这是360提供的API，不需要开发者账号，API_KEY什么的，因此很方便。
使用百度的API测试工具测试结果如下：

可见该查询接口返回的是JSON格式，返回的两个键值分别是code和data。

一、新建项目，添加依赖

项目名为RetrofitDemo，为了防止大家疏忽，先在AndroidManifest.xml把网络权限添加上吧：

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

然后在app->build.gradle的dependencies中添加如下依赖：

   compile 'com.squareup.retrofit2:retrofit:2.3.0'
   compile 'com.squareup.retrofit2:converter-gson:2.3.0'

如何不知道retrofit2的最新版本，可以在file->Project Structure->modules(app)的dependencies标签页->选择‘+’号搜索添加依赖，如图：

输入retrofi搜索，注意选中retrofit2而不时retrofit

同样的步骤搜索converter-gson，注意要选retrofit2:converter-gson，不要选错了

可见这两个库的目前的最新版本是2.3.0

添加完毕后在app->build.gradle中的dependencies中自然会出现如下依赖：

创建实体类和Retrofit接口

我们使用Gson解析API查询返回的JSON格式，先根据API的返回结果创建实体类PhoneResult.class和PhoneData.class

PhoneResult.class：对应返回的Json对象，具有code和data两个键

public class PhoneResult {
    private int code;
    private PhoneData data;

    public void setData(PhoneData data) {
        this.data = data;
    }

    public void setCode(int code) {
        this.code = code;
    }

    public PhoneData getData() {
        return data;
    }

    public int getCode() {
        return code;
    }
}

PhoneData.class：data键对应的Json对象，包含手机号所属省份、城市和供应商

public class PhoneData {
    private String province;
    private String city;
    private String sp;

    public void setSp(String sp) {
        this.sp = sp;
    }

    public void setProvince(String province) {
        this.province = province;
    }

    public void setCity(String city) {
        this.city = city;
    }

    public String getSp() {
        return sp;
    }

    public String getProvince() {
        return province;
    }

    public String getCity() {
        return city;
    }
}

Retrofit使用接口和注解的形式来发起请求的，因此接下来定义请求接口
ApiService.java：注释应该写得比较详细了，就不细说了

public interface ApiService {

    /**
     * 请求API是：http://cx.shouji.360.cn/phonearea.php?number=13188888888
     * 把资源定位的部分放在GET注解内，注意该部分不能以/作为开头
     * Call指明请求返回的数据将装换为PhoneResult
     * getPhoneResult方法是发起请求时回调的方法，参数number对应API请求中的number参数
     */
    @GET("phonearea.php")
    Call getPhoneResult(@Query("number")String number);

}

三、发起请求

MainActivity.class

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;

import retrofit2.Call;
import retrofit2.Callback;
import retrofit2.Response;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

public class MainActivity extends AppCompatActivity {

    //输入手机号
    EditText et;
    //发起请求的按钮
    Button btn;
    //显示请求结果
    TextView tv;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        btn = (Button) findViewById(R.id.btn);
        et = (EditText) findViewById(R.id.et);
        tv = (TextView) findViewById(R.id.tv);

        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Retrofit retrofit = new Retrofit.Builder()
                        .addConverterFactory(GsonConverterFactory.create())
                        //注意这里是请求的主机名,必须以/结尾
                        .baseUrl("http://cx.shouji.360.cn/")
                        .build();
                //生成ApiService的实例
                ApiService apiService = retrofit.create(ApiService.class);
                Call call = apiService.getPhoneResult(et.getText().toString());
                //发起网络请求
                call.enqueue(new Callback() {
                    @Override
                    public void onResponse(Call call, Response response) {
                        //请求成功
                        PhoneResult result = response.body();
                        PhoneData data = result.getData();
                        tv.setText(data.getProvince() + " " + data.getCity() + " " + data.getSp());
                    }

                    @Override
                    public void onFailure(Call call, Throwable t) {

                    }
                });

            }
        });

    }
}

运行结果如下：

好了，关于Retrofit2进行Get请求的小白教程就说到这了，以后有空再把Retrofit2更详尽的使用方法和原理补充完吧。

源码下载