Retrifit的基本用法
这里要说一下的是,服务器提供的接口通常是可以根据功能来进行归类的,比如新增用户、修改用户数据、查询用户数据这几个接口可以归为一类,上架新书、销售图书、查询可提供的图书也可以归为一类。将服务器接口归类可以让代码结构变得更加合理。
添加依赖
implementation 'com.squareup.retrofit2:retrofit2:2.6.1'
implementation 'com.squareup.retrofit2:converter-gson:2.6.1'
对服务器接口进行归类
由于我在apache服务器上只有一个获取JSON数据的接口,因此只需要定义一个接口文件。
interface AppService {
@GET("get_data.json")
fun getAppData():Call<List<App>>
}
通常的接口文件建议以具体功能为开头,并以Service结尾,这是一种比较好的命名习惯。
这里的注解意味着:当调用getAppData方法时Retrifit会发起一条GET请求,请求地址就在注解中传入的具体参数。
注意!这里只需要传入相对地址即可,根地址在稍后进行设置。
第二个是返回类型必须声明成Retrofit内置的Call类型,并且通过泛型指定服务器响应的数据应该转换为什么对象。
使用接口
为了方便使用,这里添加了一个按钮。
binding.getAppDataBtn.setOnClickListener {
val retrofit = Retrofit.Builder()
.baseUrl("http://10.0.2.2/") //指定了根路径
.addConverterFactory(GsonConverterFactory.create()) //指定Retrofit解析时所使用的转换库
.build()
val appService = retrofit.create(AppService::class.java) //调用create传入具体的接口
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()
}
})
}
有了动态接口代理就可以随意调用接口中定义的所有方法。
这里调用了getAppData后就会返回一个Call<List< App>>对象,这时再调用其enqueue方法,Retrofit就会根据注解中的网络地址去进行网络请求。
服务器响应的数据会回调到enqueue方法中传入的CallBack里面。
需要注意的是:再发起请求时,Retrofit会开启子线程,当回调到Callback后又自动切换为主线程,整个操作都不用考虑线程切换的问题。
在CallBack的onResponse方法中,调用response.body()会得到解析后的对象。
最后进行遍历即可。