android用Retrofit进行网络请求和解析

Retrofit 的原理

Retrofit的核心原理包括动态代理与Service Method的构建、注解解析与请求配置、网络请求执行与响应处理等。它是一个类型安全的HTTP客户端，用于Android和Java平台，通过将HTTP API转化为Java接口的方式，简化了网络请求的编写工作。
Retrofit利用Java的注解处理器分析定义好的HTTP接口，将注解（如@GET, @POST等）转化为OkHttp请求的具体配置。当调用接口方法时，Retrofit通过动态代理机制，根据接口注解生成OkHttp的Request对象。

再者，Retrofit在内部实现上，主要依赖于其姊妹项目OkHttp来完成实际的网络请求。Retrofit相当于是OkHttp的一个封装层，提供了更简洁易用的API供开发者使用。它通过注解的方式来描述HTTP请求的配置，省去了手动创建和管理HTTP请求的复杂性。

增加依赖

由于Retrofit是基于OkHttp开发的，因此添加下面的依赖会自动将Retrofit、OkHttp和Okio这几个库一起下载，我们无须再手动引入OkHttp库。另外，Retrofit还会将服务器返回的JSON数据自动解析成对象，因此下面的第二条依赖就是一个Retrofit的转换库，它是借助GSON来解析JSON数据的，所以会自动将GSON库一起下载下来，这样我们也不用手动引入GSON库了。除了GSON之外，Retrofit还支持各种其他主流的JSON解析库，包括Jackson、Moshi等，不过毫无疑问GSON是最常用的。
在dependencies中添加如下依赖：

implementation("com.squareup.retrofit2:retrofit:2.6.1")
implementation("com.squareup.retrofit2:converter-gson:2.6.1")

程序设置网络访问

java.lang.SecurityException: Permission denied (missing INTERNET permission?)你的应用程序缺少访问互联网的权限。

在AndroidManifest.xml 的manifest标签中增加代码：

<uses-permission android:name="android.permission.INTERNET" />

java.lang.RuntimeException: Unable to start activity ComponentInfo{com.example.playtest/com.example.playtest.MainActivity}: android.os.NetworkOnMainThreadException
这个错误是因为你在主线程中进行了网络操作。在Android中，主线程用于处理UI和用户交互，因此不能进行耗时的操作，如网络请求。你需要将网络操作放在一个单独的线程中执行。你可以使用AsyncTask或者HandlerThread来实现。
要在 Android 的 Activity 或 Fragment 中使用异步任务，可以这样做：

CoroutineScope(Dispatchers.Main).launch {
            // 在这里执行异步任务
        }

新增一个基础接口返回类，如下
所示：

data class Example (
    val code: Long,
    val data: Data,
    val msg: String
)

同时创建一个service,

interface PlatformService {

    @GET("/service/anonymous/public/config/domain")
    fun getConfig(): Call<Example>
}

调用该接口并使用gson解析：

        CoroutineScope(Dispatchers.Main).launch {
                    val retrofit = Retrofit.Builder()
                        //必须为ip或者域名地址
                        .baseUrl("https://localhost:8080/")
                        .addConverterFactory(GsonConverterFactory.create())
                        .build()
                    val appService = retrofit.create(PlatformService::class.java)
                    appService.getConfig().enqueue(object : Callback<ExampleGenerate> {
                        override fun onResponse(
                            call: Call<ExampleGenerate>,
                            response: Response<ExampleGenerate>
                        ) {
                            val body = response.body()
                            println("返回数据")
                            if (body != null) {
                                println( body.data.catering)
                                println(body.toString())
                            }
                        }

                        override fun onFailure(call: Call<ExampleGenerate>, t: Throwable) {
                            t.printStackTrace()
                        }

                    })
                }

结论

Retrofit 是一款功能强大的网络请求库，简化了开发流程，提供高效的网络请求能力。通过深入学习 Retrofit 的高级使用与原理，我们能够更好地理解和应用这一库，从而提高开发效率和代码质量。