Android网络技术——Retrofit网络库

Android网络技术——Retrofit网络库

---

Retrofit网络库是在OkHttp的基础上增加了注解、接口等方式进一步开发出来的应用层网络通信库，而OkHttp侧重的是底层通信的实现（Retrofit侧重的是上层接口的封装），使得我们可以用更加面向对象的思维进行网络操作。

一、添加依赖

dependencies {
	implementation("com.squareup.retrofit2:retrofit:2.6.1")
    implementation("com.squareup.retrofit2:converter-gson:2.6.1")
}

• 第1条依赖：Retrofit网络库
• 第2条依赖：Retrofit的转换库，它是借助GSON来解析JSON数据的

二、解析json数据的类

class App(val id: String, val name: String, val version: String)

由于Retrofit会借助GSON将JSON数据转换成对象，因此这里同样需要新增一个类用于存放返回的字段，比如App类，并加入id、name和version这3个字段。

三、创建接口

interface AppService {
	 @GET("get_data.json")
	 fun getAppData(): Call<List<App>>
}

通常Retrofit的接口文件建议以具体的功能种类名开头，并以Service结尾
注：

1. 在getAppData()方法上面添加的注解，这里使用了一个@GET注解，表示当调用getAppData()方法时Retrofit会发起一条GET请求，请求的地址就是我们在@GET注解中传入的具体参数。（这里只需要传入请求地址的相对路径即可，根路径我们会在稍后设置。）
2. getAppData()方法的返回值必须声明成Retrofit中内置的Call类型，并通过泛型来指定服务器响应的数据应该转换成什么对象。由于服务器响应的是一个包含App数据的JSON数组，因此这里我们将泛型声明成List<App>。

四、简单使用

class MainActivity : AppCompatActivity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          setContentView(R.layout.activity_main)
          getAppDataBtn.setOnClickListener {
              val retrofit = Retrofit.Builder()
                  .baseUrl("http://10.0.2.2/")
                  .addConverterFactory(GsonConverterFactory.create())
                  .build()
              val appService = retrofit.create(AppService::class.java)
              appService.getAppData().enqueue(object : Callback<List<App>> {
                  override fun onResponse(call: Call<List<App>>,
                                          response: Response<List<App>>) {
                      val list = response.body()
                      if (list != null) {
                          for (app in list) {
                              Log.d("MainActivity", "id is ${app.id}")
                              Log.d("MainActivity", "name is ${app.name}")
                              Log.d("MainActivity", "version is ${app.version}")
                          }
                      }
                  }
                  override fun onFailure(call: Call<List<App>>, t: Throwable) {
                      t.printStackTrace()
                  }
              })
          }
      }
  }

• 首先使用了Retrofit.Builder来构建一个Retrofit对象，其中baseUrl()方法用于指定所有Retrofit请求的根路径，addConverterFactory()方法用于指定Retrofit在解析数据时所使用的转换库，这里指定成GsonConverterFactory。注意这两个方法都是必须调用的。
• 有了Retrofit对象之后，我们就可以调用它的create()方法，并传入具体Service接口所对应的Class类型，创建一个该接口的动态代理对象。
• 当调用了AppService的getAppData()方法时，会返回一个Call<List>对象，这时我们再调用一下它的enqueue()方法，Retrofit就会根据注解中配置的服务器接口地址去进行网络请求了，服务器响应的数据会回调到enqueue()方法中传入的Callback实现里面。需要注意的是，当发起请求的时候，Retrofit会自动在内部开启子线程，当数据回调到Callback中之后，Retrofit又会自动切换回主线程，整个操作过程中我们都不用考虑线程切换问题。在Callback的onResponse()方法中，调用response.body()方法将会得到Retrofit解析后的对象，也就是List类型的数据，最后遍历List，将其中的数据打印出来即可。