/**
     * 定义一个名为 coroutine 的函数，接受两个参数：
     * 1. context: CoroutineContext，协程的上下文，默认为 Dispatchers.IO。
     * 2. block: 一个挂起函数，该函数在协程内执行。
     */
    fun coroutine(
        // 协程的上下文，默认为 Dispatchers.IO
        context: CoroutineContext = Dispatchers.IO,
        block: suspend CoroutineScope.() -> Unit
    ): Job {
        // 创建一个 CoroutineScope，并使用给定的上下文启动一个协程。
        // 返回一个 Job 对象，用于管理和监控协程的状态。
        return CoroutineScope(context).launch {
            try {
                // 在协程内部创建一个新的 coroutineScope。
                coroutineScope {
                    // 调用传入的挂起函数 block。
                    block()
                }
            } catch (e: Exception) {
                // 捕获并处理协程内部的异常，打印异常堆栈信息。
                e.printStackTrace()
            }
        }
    }

class ServiceNET {
    companion object{
        // 服务器地址
        private const val BASE_URL = "http://124.93.196.45:10001/"

        private val retrofit = Retrofit.Builder()
            .baseUrl(BASE_URL)
            .addConverterFactory(GsonConverterFactory.create())
            .build()

        // 通过.Class对象进行网络请求: create(API接口对象)
        fun <E> create(service: Class<E>) : E = retrofit.create(service)

        // 以泛型的方式进行网络请求： create<接口对象>()
        inline fun <reified E> create() : E = create(E::class.java)

    }
}

interface api {
    // 比赛提供的Retrofit版本是支持kotlin协程的
   	// 不用Call<类名>了
    // 直接 : BannerModel
    
    // 获取轮播图
    @GET("/prod-api/api/rotation/list")
    suspend fun getBanner(@QueryMap mp: Map<String, Int>) : BannerModel
}

companion object {
    /*
        静态属性 api，用于进行网络访问请求
        create<Class?> 是我们封装Retrofit是创建的一个内联函数 
        inline fun <reified E> create() : E = create(E::class.java)
        
        使用也很简单， 我们直接调用api后跟个.来获取我们在接口中定义的挂起函数来访问网络
        使用: api.getBanner(传入参数)
    */
    val api = create<api>()
}

// 定义一个挂起函数 setBanner，用于异步获取广告轮播图数据。
private suspend fun setBanner() {
    // 调用 api 的 getBanner 方法，传入参数 mapOf("pageNum" to 1, "pageSize" to 8, "type" to 2)
    api.getBanner(mapOf("pageNum" to 1, "pageSize" to 8, "type" to 2)).apply {
        // 使用 apply 函数，将代码块作用于 api.getBanner() 的返回结果，即网络请求的响应实体。

        // 在这里直接通过 this 来获取实体类的数据，比如判断是否网络请求成功
        // 例如，判断返回的状态码是否为 200
        if (this.code == 200) {
            // 请求成功，可以在这里处理获取到的数据
            // 比如，可以通过 this.data 获取具体的数据
        } else {
            // 请求失败，可以在这里处理失败的情况
        }
    }
}

// 定义一个私有函数 runThread，它使用之前定义的 coroutine 函数启动一个协程。
private fun runThread() = coroutine {
    // 在这里可以调用挂起函数方法，这些方法将在协程中执行。

    // 例如：
    // 挂起函数方法 ...
    setBanner()
}

// 定义一个私有函数 runThread，它使用 coroutine 函数启动一个在主线程上执行的协程。
private fun runThread() = coroutine(Dispatchers.Main) {
    // 在这里可以调用挂起函数方法，这些方法将在主线程的协程中执行。

    // 例如：
    // 调用挂起函数
    setBanner()
}