Retrofit根路径POST请求：@POST("/") 的应用与解析

import okhttp3.RequestBody
import retrofit2.Call
import retrofit2.http.Multipart
import retrofit2.http.POST
import retrofit2.http.Part

// 假设服务器响应的数据模型
data class Result(val status: String, val message: String)

/**
 * Retrofit 服务接口，定义了向根路径发送POST请求的方法。
 */
interface ApiService {
    @Multipart
    @POST("/") // 正确的写法：使用斜杠表示根路径
    fun updateProfile(
        @Part("tile_mode") fullName: Int,
        @Part("raw_image") image: RequestBody
    ): Call<Result>
}

import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.RequestBody
import okhttp3.RequestBody.Companion.toRequestBody
import retrofit2.Call
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactory
import retrofit2.adapter.rxjava2.RxJava2CallAdapterFactory // 针对 RxJava2，如果使用Kotlin协程可替换为 suspend 函数

fun main() {
    // 定义你的基础URL
    val baseUrl = "https://blog.banned.top:2054"

    // 1. 构建Retrofit实例
    val retrofit = Retrofit.Builder()
        .baseUrl(baseUrl)
        .addConverterFactory(GsonConverterFactory.create()) // 添加Gson转换器，用于JSON数据的序列化与反序列化
        // 根据你的项目需求选择合适的CallAdapterFactory，例如RxJava2CallAdapterFactory
        // 如果使用Kotlin协程，则通常不需要额外的CallAdapterFactory，直接在接口中使用suspend函数
        .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 示例使用RxJava2
        .build()

    // 2. 创建API服务实例
    val apiService = retrofit.create(ApiService::class.java)

    // 3. 准备请求参数
    val fullName = 123
    val imageContent = "This is some dummy image data.".toByteArray()
    // 使用toRequestBody扩展函数创建RequestBody，并指定媒体类型
    val image: RequestBody = imageContent.toRequestBody("image/*".toMediaTypeOrNull(), 0, imageContent.size)

    // 4. 发起请求
    val call: Call<Result> = apiService.updateProfile(fullName, image)

    // 5. 执行请求并处理响应
    // 在实际应用中，通常建议异步执行请求（使用call.enqueue()）以避免阻塞UI线程
    try {
        val response = call.execute() // 同步执行请求，仅用于示例
        if (response.isSuccessful) {
            println("请求成功: ${response.body()}")
        } else {
            println("请求失败: ${response.code()} - ${response.errorBody()?.string()}")
        }
    } catch (e: Exception) {
        println("请求异常: ${e.message}")
    }
}