从零开始学Retrofit（一）——第一个demo

为什么使用Retrofit

在之前做项目的时候，使用的是Volley做网络请求，因为是接手一个学长的项目，底层封装已经做好了，可是在出现新需求要调用时有着诸多不便，一是虽然做了封装，但在调用时结构不清晰；二是每个接口地址都保存在一个专门的api类，只要多一个功能，就要在该类中添加一个api，尽管很多内容十分相似，所以耦合性很高。而接触到Retrofit后让我眼前一亮，使用Retrofit可以完美解决上述问题。Retrofit使用了目前比较流行的链式调用，结构十分清晰，并且将api封装成接口，通过注解的方式声明api的信息，Retrofit也提供了很多注解来适应不同的需求来降低耦合性。

第一个例子

我使用的是xampp搭建的本地服务器，php+mysql+Apache的结构。

1. 创建服务端api，在xampp安装目录下的htdocs文件夹中新建目录/test/test.php文件，文件内容如下，即输出一个json字符串：

    <?php
        $array = array('msg' => "request success!");
        echo json_encode($array);
    ?>

也就是要请求的api就是http://localhost/test/test.php ，localhost就是本机地址加上Apache的端口号。

2. 打开AS，添加依赖
   

//Retrofit2所需要的包
compile 'com.squareup.retrofit2:retrofit:2.2.0'
//ConverterFactory的Gson依赖包
compile 'com.squareup.retrofit2:converter-gson:2.2.0'

两个项目的传送门，如果更新了，直接将版本号替换成最新的版本号就行了

Retrofit项目地址

Gson项目地址

注意这里Retrofit与Gson的版本号要一样，否则会出错。

3. 定义api接口与返回对象，将之前的api封装成java中的接口，并根据返回的信息，创建一个用于保存信息的bean。

  public interface HelloService {
      @GET("test/test.php")
      Call<ResponseInfo> testHttpGet();
  }
  class ResponseInfo {
      String msg;
  }

这里使用了@GET注解，表示get请求，@GET后的内容便是请求地址，有人要问了，请求地址不是http://localhost/test/test.php 吗？前面的内容哪去了？别急别急，我们可以把前面不变的部分作为baseUrl在初始化Retrofit的时候传进去，这样将url拼装一下就是实际的url地址了。

4. 调用Retrofit，终于到最关键的一步了，url有了，也封装成接口了，怎么通过Retrofit访问url呢？看下面代码：

    public class MainActivity extends AppCompatActivity {
        private Button btn_req;
        private TextView tv_info;
        private final static String BASE_URL = "http://192.168.1.2:80/";//服务器的IP地址与端口号
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            btn_req = (Button) findViewById(R.id.button);
            tv_info = (TextView) findViewById(R.id.tv_info);
    
            btn_req.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    doRequest();
                }
            });
        }
    
        private void doRequest() {
            //创建Retrofit实例
            Retrofit retrofit = new Retrofit.Builder()
                      .baseUrl(BASE_URL)
                      //将返回值转换成bean
                      .addConverterFactory(GsonConverterFactory.create())
                      .build();
            //创建调用接口
            HelloService helloService = retrofit.create(HelloService.class);
            //调用接口方法，访问url
            Call<ResponseInfo> call = helloService.testHttpGet();
            //请求处理
            call.enqueue(new Callback<ResponseInfo>() {
                @Override
                //请求成功
                public void onResponse(Call<ResponseInfo> call, Response<ResponseInfo> response) {
                    tv_info.setText(response.body().msg);
                }
    
                @Override
                //请求失败
                public void onFailure(Call<ResponseInfo> call, Throwable t) {
                    tv_info.setText(t.getMessage());
                }
            });
        }
    }

运行结果

结果

参考资料

Android网络请求库 - Say hello to retrofit