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 的高级使用与原理,我们能够更好地理解和应用这一库,从而提高开发效率和代码质量。