Retrofit入门篇——how to use

作为一名Android开发者，如果你没有听说过Retrofit网络请求框架，那真的是太不应该了。好吧，这篇文章的目的就是普及基本知识了。
首先，Retrofit是由Square开发出来的一套网络请求底层框架，可以理解为OKHttp的加强版(PS:OKHttp也是他家的)。本质上网络请求的工作是由OkHttp完成，而 Retrofit 仅负责网络请求接口的封装。它的一个最大的特点是通过大量的设计模式对代码进行解耦，同时支持同步、异步和RxJava,以及可以配置不同的反序列化工具来解析数据，如json、xml等

简单介绍完Retrofit之后，想必你还是一头雾水对吧，下面通过一个简单的小例子来讲解一下。

首先，你要进行网络请求，必须要有对应的服务器对吧，但是呢，要移动端开发人员去搭建一个后台环境也太麻烦了，于是乎可以利用SpringBoot快速搭建一个本地服务器来进行数据交互.

• IntelliJ IDEA直接创建一个Spring Assistant项目(这个应该不用教了吧~实在不会可以google一下)

public class Response<T> {
    private int code;
    private int count;
    private String msg;
    private T data;

    public Response(int code, int count, String msg, T data) {
        this.code = code;
        this.count = count;
        this.msg = msg;
        this.data = data;
    }

    public T getData() {
        return data;
    }

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

    public int getCode() {
        return code;
    }

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

    public String getMsg() {
        return msg;
    }

    public void setMsg(String msg) {
        this.msg = msg;
    }

    public int getCount() {
        return count;
    }

    public void setCount(int count) {
        this.count = count;
    }
}

@RestController
public class HelloController {
    @RequestMapping("getAuthCode")
    public Response getAuthCode(String phone, int type) {
        return new Response(0,0,"succes",phone+",i know you want authcode!");
    }
}

直接运行SpringXXXApplication，后台就成功运行了

• Android Studio新建项目

1.配置Gradle，添加依赖

    // Okhttp
    implementation 'com.squareup.okhttp3:okhttp:3.7.0'
    // Retrofit
    implementation 'com.squareup.retrofit2:retrofit:2.1.0'

别忘了要在AndroidManifest申请网络权限哟

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

2.新建一个接口ApiService.java，通过注解的方式配置网络请求参数

public interface ApiService {
    @GET("getAuthCode")
    Call<ResponseBody> getAuthCode(@Query("phone") String phone, @Query("type") int type);
}

3.在MainActivity里面进行网络请求

private void requestRetrofit() {
        Retrofit retrofit = new Retrofit.Builder().baseUrl("http://192.168.20.227:8080/").build();
        ApiService apiService = retrofit.create(ApiService.class);
        Call<ResponseBody> call = apiService.getAuthCode("183****2568",0);
        call.enqueue(new Callback<ResponseBody>() {
            @Override
            public void onResponse(Call<ResponseBody> call, retrofit2.Response<ResponseBody> response) {
                try {
                    Log.e("MainActivity",response.body().string().toString());
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

            @Override
            public void onFailure(Call<ResponseBody> call, Throwable t) {
                t.printStackTrace();
            }
        });
    }

okay，这样就可以直接运行项目了，你会看到如下log

E/MainActivity: {"code":0,"count":0,"msg":"succes","data":"183****2568,okay,i know you want authcode!"}

这样就完成了最基本的Retrofit网络请求了。