Compose 新闻App（一）网络框架搭建
- 前言
- 正文
- 一、项目创建
- 二、依赖配置
- 三、数据API
- 四、网络框架构建
- 五、项目配置
- 六、网络请求
- 七、源码
前言
要去学习新的知识，光是简单的使用还是不够的，最好是有一个项目让你去了解和学习，在开发中去增加你的使用，并且以后回头来看很快就能用上，哪怕你现在用不上，知识的储备是非常要必要的，能给你的未来更多机会。
正文
最近觉得Compose很有意思，想要去写一个关于Compose的系列文章，做一个简单的新闻App，话不多说，我们新建一个项目吧。
一、项目创建
这里选择的是Empty Compose Activity，点击Next。
就命名GoodNews吧，开发语言就是Kotlin，我这里用的是当前最新版本的AS，点击Finish完成项目创建。
二、依赖配置
作为一个新闻App，新闻数据的获取是通过网络API，那么我们需要先构建一个网络框架。之前用Java写网络框架时是通过Okhttp、Retrofit、rxJava、那么在Kotlin中就使用Retrofit和协程来操作，在app的build.gradle的dependencies{}闭包中添加如下代码：
代码语言：javascript复制 //Retrofit
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
//LiveData、ViewModel
implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'
implementation 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.3.1'
implementation 'androidx.lifecycle:lifecycle-livedata-ktx:2.4.0-alpha02'
然后Sync Now。
三、数据API
现在免费的API数据接口实在太少了，聚合的每天免费次数也只供测试的，因为我重新找了一个API接口，就是天行数据，点击进入完成注册登录以及实名制。
然后我们可以进入我的控制台
点击这里申请接口，这里我选择了一个抗击疫情的接口，点击申请，可以看到这里有免费的调用次数，建议开发者使用自己的Key去调用。
下面回到我的控制台，然后是我申请的接口，找到抗击疫情，点击立即调试。
在这里可以看到请求地址和请求参数，我们点击测试请求按钮。
这里我们就拿到了返回的数据，通过返回的数据去构建Kotlin的Data类。
这里我推荐一个AS插件，很好用，点击File，然后Settings… ，选择Plugins，输入Generate Kotlin data classes from JSON
安装好插件之后，我们来使用它。在com.llw.goodnews包下新建一个bean包，鼠标右键点击Generate class from GSON。
输入数据类名称，然后将JSON格式数据粘贴到下方，点击OK。
生成了这么多个数据类，我们看一下EpidemicNews
它里面包裹了一个列表NewslistItem，你看到类都是这种情况，数据是很多的，所以每一层都有一个data类。现在数据有了，下面就是通过这个接口去进行网络请求了。
四、网络框架构建
做网络请求肯定不能够随便写，要考虑实用性，这个网络框架我也是在《第一行代码》中学到的，建议有些不知道的地方可以看看这本书，这里就拿来用，稍微有一点变化，不过不大。在com.llw.goodnews包下新建一个network包，包下新建一个ServiceCreator类，代码如下：
代码语言：javascript复制object ServiceCreator {
private const val baseUrl = "http://api.tianapi.com"
private fun getRetrofit() : Retrofit =
Retrofit.Builder()
.baseUrl(baseUrl)
.addConverterFactory(GsonConverterFactory.create())
.build()
fun <T> create(serviceClass: Class<T>): T = getRetrofit().create(serviceClass)
inline fun <reified T> create(): T = create(T::class.java)
}这里的代码就很简单了，通过网络地址构建一个Retrofit，然后根据传入的Service去访问接口，这里还有一个内联函数。
下面我们来构建这个服务接口，在此之前先在com.llw.goodnews包下新建一个utils包，包下新建一个Constant的类，里面的代码如下：
代码语言：javascript复制object Constant {
/**
* 天行数据Key，请使用自己的Key
*/
const val API_KEY = "d8bc937c366fcd1629e00f19105db258"
/**
* 请求接口成功状态码
*/
const val CODE = 200
/**
* 请求接口成功状态描述
*/
const val SUCCESS = "success"
}这里就是一个常量类，我们在请求API接口时会用到的一些不变的值就放这里。然后我们在network包下新建一个ApiService接口，代码如下：
代码语言：javascript复制interface ApiService {
/**
* 获取新闻数据
*/
@GET("/ncov/index?key=$API_KEY")
fun getEpidemicNews(): Call<EpidemicNews>
}下面我们在network包下新建一个发起请求的NetworkRequest类，代码如下：
代码语言：javascript复制object NetworkRequest {
/**
* 创建服务
*/
private val service = ServiceCreator.create(ApiService::class.java)
//通过await()函数将getNews()函数也声明成挂起函数。使用协程
suspend fun getEpidemicNews() = service.getEpidemicNews().await()
/**
* Retrofit网络返回处理
*/
private suspend fun <T> Call<T>.await(): T = suspendCoroutine {
enqueue(object : Callback<T> {
//正常返回
override fun onResponse(call: Call<T>, response: Response<T>) {
val body = response.body()
if (body != null) it.resume(body)
else it.resumeWithException(RuntimeException("response body is null"))
}
//异常返回
override fun onFailure(call: Call<T>, t: Throwable) {
it.resumeWithException(t)
}
})
}
}这段代码解释一下：首先我们使用ServiceCreator创建了一个ApiService接口的动态代理对象，然后定义了一个getEpidemicNews函数，调用刚刚在ApiService中定义的getEpidemicNews方法，以发起疫情新闻数据请求。这里简化了Retrofit回调的写法，这里定义了一个await()函数，它是一个挂起函数，我们给它声明了一个泛型T，并将await()函数定义成了Call< T >的扩展函数，这样所有返回值是Call类型的Retrofit网络请求接口都可以直接调用await()函数了。 接着，await()函数中使用了suspendCoroutine函数来挂起当前协程，并且由于扩展函数的原因，我们现在拥有了Call对象的上下文，那么这里就可以直接调用enqueue()方法让Retrofit发起网络请求。
最后我们在存储库中发起数据请求，在com.llw.goodnews下创建一个repository包，包下新建一个BaseRepository，里面的代码如下：
代码语言：javascript复制open class BaseRepository {
fun <T> fire(context: CoroutineContext, block: suspend () -> Result<T>) =
liveData(context) {
val result = try {
block()
} catch (e: Exception) {
Result.failure(e)
}
//通知数据变化
emit(result)
}
}这里的fire()函数，按照liveData()函数的参数接收标准定义的一个高阶函数。在fire()函数的内部会先调用一下liveData()函数，然后在liveData()函数的代码块中统一进行try catch处理，并在try语句中调用传入的Lambda表达式中的代码，最终Lambda表达式的执行结果并调用emit()方法发射出去。
然后我们在repository包下再新建一个EpidemicNewsRepository类，用于请求疫情新闻数据，继承自BaseRepository，里面的代码如下：
代码语言：javascript复制object EpidemicNewsRepository : BaseRepository() {
fun getEpidemicNews() = fire(Dispatchers.IO) {
val epidemicNews = NetworkRequest.getEpidemicNews()
if (epidemicNews.code == CODE) Result.success(epidemicNews)
else Result.failure(RuntimeException("getNews response code is ${epidemicNews.code} msg is ${epidemicNews.msg}"))
}
}这里我们调用父类的fire()函数，将liveData()函数的线程参数类型指定成了Dispatchers.IO，这样的代码块中的所有代码都是运行在子线程中，如果请求状态码是200，则表示成功，那么就使用Kotlin内置的Result.success()方法来包装获取的疫情新闻数据，然后就调用Result.failure()方法来包装一个异常信息。
那么到这里为止，网络框架就搭建完成了，要使用的话还需要一些配置：
五、项目配置
这里我们在com.llw.goodnews包下自定义一个App类，继承自Application，代码如下：
代码语言：javascript复制class App : Application() {
companion object {
@SuppressLint("StaticFieldLeak")
lateinit var context: Context
}
override fun onCreate() {
super.onCreate()
context = applicationContext
}
}然后因为我们访问的API是http开头的，在Android9.0及以上版本中默认访问https，因此我们需要打开对http的网络访问，在res文件夹下新建一个xml文件夹，在xml文件夹下创建一个network_config.xml，里面的代码如下：
代码语言：javascript复制<network-security-config>
<base-config cleartextTrafficPermitted="true"/>
network-security-config>然后我们在AndroidManifest.xml中去配置，如下图所示：
现在万事具备，只差请求了。
六、网络请求
进入到MainActivity，新增如下代码：
代码语言：javascript复制 EpidemicNewsRepository.getEpidemicNews().observe(this@MainActivity) { result ->
val epidemicNews = result.getOrNull()
if (epidemicNews != null) {
Log.d("TAG", "onCreate: ${epidemicNews.code}")
Log.d("TAG", "onCreate: ${epidemicNews.msg}")
Log.d("TAG", "onCreate: ${epidemicNews.newslist?.get(0)?.news?.get(0)?.title}")
Log.d("TAG", "onCreate: ${epidemicNews.newslist?.get(0)?.news?.get(0)?.summary}")
} else {
Log.e("TAG", "onCreate: null")
}
}添加的位置为下图所示：
这里就是通过请求返回数据，然后打印一下数据，下面来运行一下：
OK，网络框架就没有啥问题了，主要有一个点不爽，就是这里的bean里面太多类，我们写到一个类里面，修改一下EpidemicNews.kt，里面的代码如下：
代码语言：javascript复制data class EpidemicNews(val msg: String = "",
val code: Int = 0,
val newslist: List<NewslistItem>?)
data class NewslistItem(val news: List<NewsItem>?,
val desc: Desc,
val riskarea: Riskarea)
data class NewsItem(val summary: String = "",
val sourceUrl: String = "",
val id: Int = 0,
val title: String = "",
val pubDate: Long = 0,
val pubDateStr: String = "",
val infoSource: String = "")
data class Desc(val curedCount: Int = 0,
val seriousCount: Int = 0,
val currentConfirmedIncr: Int = 0,
val midDangerCount: Int = 0,
val suspectedIncr: Int = 0,
val seriousIncr: Int = 0,
val confirmedIncr: Int = 0,
val globalStatistics: GlobalStatistics,
val deadIncr: Int = 0,
val suspectedCount: Int = 0,
val currentConfirmedCount: Int = 0,
val confirmedCount: Int = 0,
val modifyTime: Long = 0,
val createTime: Long = 0,
val curedIncr: Int = 0,
val yesterdaySuspectedCountIncr: Int = 0,
val foreignStatistics: ForeignStatistics,
val highDangerCount: Int = 0,
val id: Int = 0,
val deadCount: Int = 0,
val yesterdayConfirmedCountIncr: Int = 0)
data class Riskarea(val high: List<String>?,
val mid: List<String>?)
data class GlobalStatistics(val currentConfirmedCount: Int = 0,
val confirmedCount: Int = 0,
val curedCount: Int = 0,
val currentConfirmedIncr: Int = 0,
val confirmedIncr: Int = 0,
val curedIncr: Int = 0,
val deadCount: Int = 0,
val deadIncr: Int = 0,
val yesterdayConfirmedCountIncr: Int = 0)
data class ForeignStatistics(val currentConfirmedCount: Int = 0,
val confirmedCount: Int = 0,
val curedCount: Int = 0,
val currentConfirmedIncr: Int = 0,
val suspectedIncr: Int = 0,
val confirmedIncr: Int = 0,
val curedIncr: Int = 0,
val deadCount: Int = 0,
val deadIncr: Int = 0,
val suspectedCount: Int = 0)改完之后删除其他的类，只保留一个
再运行一下看看效果如何
OK，木有问题。
七、源码
GitHub：GoodNews CSDN：GoodNews_1.rar
CSDN的源码rar文件表示的是当前这篇文章的源码，后面即使更新文章，这个源码不会变，而GitHub上的源码是会是最新的源码。
