简介
在 Android 开发中,网络请求是一个极为关键的部分。Retrofit 作为一个强大的网络请求库,能够简化开发流程,提供高效的网络请求能力。
Retrofit 是一个建立在 OkHttp 基础之上的网络请求库,能够将我们定义的 Java 接口转化为相应的 HTTP请求,Retrofit 是适用于 Android 和 Java 的类型安全 HTTP 客户端。通过Retrofit,我们可以轻松发起网络请求,还能将服务器返回的数据转换为所需的格式,如 JSON。
简单使用
1. 在 APP 目录下的 build.gradle 里添加依赖
// retrofit
// https://github.com/square/retrofit
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
// 使用 gson 解析 json
// https://github.com/google/gson
implementation 'com.google.code.gson:gson:2.9.0'
// 适配 retrofit 使用 gson 解析
// 版本要和 retrofit 一样
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
2. 在 AndroidManifest.xml 里添加网络权限
<uses-permission android:name="android.permission.INTERNET"/>
3. NetworkModule.kt 创建 Retrofit 实例
object NetworkModule {
/**
* TODO 创建 Retrofit 实例
*/
fun createRetrofit(okHttpClient: OkHttpClient) : Retrofit{
// 返回一个 retrofit 实例
return Retrofit.Builder()
.client(okHttpClient) // 让 retrofit 使用 okhttp
.baseUrl("http://v.juhe.cn/") // api 地址
.addConverterFactory(GsonConverterFactory.create(GsonBuilder().create()))// 使用 gson 解析 json
.build()
}
/**
* TODO 创建 OkHttpClient 实例
*/
fun createOkHttpClient() : OkHttpClient{
// 返回一个 OkHttpClient 实例
return OkHttpClient.Builder()
.connectTimeout(30, TimeUnit.SECONDS)// 设置连接超时时间
.writeTimeout(10, TimeUnit.SECONDS)
.readTimeout(10, TimeUnit.SECONDS)
.build()
}
}
4. NetworkService.kt 创建网络请求的 Service。是一个接口类
interface NetworkService {
@GET("toutiao/index")
suspend fun getNewsService(
@Query(value = "key") key : String
) : NewsEntity
/**
* TODO 通过 Retrofit 创建一个 NetworkService 实例
*/
companion object{
fun createService() : NetworkService {
return NetworkModule.createRetrofit(NetworkModule.createOkHttpClient())
.create(NetworkService::class.java) // TODO 返回一个 NetworkService 的实例
}
}
}
NewsEntity 是一个实体类,解析返回的数据。Result.kt 是一个具体的数据类,可根据返回的数据进行细化。
class NewsEntity {
var reason : String? = null //返回说明
//var result : Result? = null // 返回结果
var error_code : Int = 0 // 返回码
}
5. MainActivity.kt 进行网络请求
class MainActivity : AppCompatActivity() {
private lateinit var networkRequest : TextView
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
networkRequest = findViewById(R.id.network_request)
// TODO 点击发送网络请求
networkRequest.setOnClickListener{
// TODO 网络请求为耗时操作,放到协程作用域里进行
lifecycleScope.launch {
val networkService = NetworkService.createService()
val newsEntity = networkService.getNewsService("40279bee66d427555ce361fe49387a8e")
Log.d("HL", newsEntity.reason.toString())
}
}
}
}
网络请求是异步操作,需要在协程里进行。这里使用 lifecycleScope.launch{ ...} 进行。使用 Lifecycle 添加如下依赖。
implementation ("androidx.lifecycle:lifecycle-livedata-ktx:2.6.1")
请求的数据是聚合数据上的新闻头条API 接口,请求地址为: "http://v.juhe.cn/toutiao/index?key=40279bee66d427555ce361fe49387a8e"。由于是使用的 http 请求头,所以需要在 AndroidManifest.xml 里添加 android:usesCleartextTraffic="true",更改网络安全配置。
最后,通过打印 Log 的方式,查看请求是否成功。
Log.d("HL", newsEntity.reason.toString())
文章来源:https://www.toymoban.com/news/detail-829043.html
对应的 Java 版本实现:Android---Retrofit实现网络请求:Java 版 文章来源地址https://www.toymoban.com/news/detail-829043.html
到了这里,关于Android---Retrofit实现网络请求:Kotlin版的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!