当前位置：首页>安卓APP>保姆级学习开发安卓手机软件(二十八)--网络通信(上)

保姆级学习开发安卓手机软件(二十八)--网络通信(上)

  • 2026-10-20 06:11:19
保姆级学习开发安卓手机软件(二十八)--网络通信(上)
大家久等啦，实在是紧绷那么长时间想要好好放松一下，疯狂的摆烂中。。。后续会慢慢找回节奏啦~~~
这周我们一起整点不一样的吧，从互联网上获取数据。
用的初始代码就没有新建工程啦，就是之前的教程里面实现的：保姆级学习开发安卓手机软件（十八）--创建相片展示墙   。我打算把原有使用资源图片改成网络获取，通过这样一个简单的例子来学习怎么从网络获取数据。
这其中呢，使用 Retrofit 的第三方库进行实现。
这是对应的文档网址：https://square.github.io/retrofit/

这是对应的 GitHub 页面网址：https://github.com/square/retrofit

那首先，我们就是需要添加Retrofit 的第三方库依赖项。

添加 Retrofit 依赖项

Android Gradle 允许将外部库添加到项目中。除了库依赖项之外，还需要添加托管库的代码库。

  1. 打开模块级 Gradle 文件 build.gradle.kts (Module :app)。
  2. 在 dependencies 部分，为 Retrofit 库添加以下几行代码：
// Retrofit implementation("com.squareup.retrofit2:retrofit:2.9.0")// Retrofit with Scalar Converterimplementation("com.squareup.retrofit2:converter-scalars:2.9.0")
这两个库协同工作。第一个依赖项用于 Retrofit 2 库本身，而第二个依赖项则用于 Retrofit 标量转换器。Retrofit2 是 Retrofit 库的更新版本。此标量转换器允许 Retrofit 将 JSON 结果作为 String 返回。JSON 是一种在客户端和服务器之间存储和传输数据的格式。我们将在后面的部分中介绍 JSON。
  1. 点击 右上角“Sync Now”，以使用新的依赖项重建项目。

创建对象---添加一个数据层， 用来与 Web 服务通信。

  1. 右键点击 Android 项目窗格中的 com.example.photoalbum 软件包，然后依次选择 New > Package。
  2. 在弹出式窗口中，将 network 附加到建议软件包名称的末尾。
  3. 在新软件包“network”下创建新的 Kotlin 文件。将该文件命名为 MarsApiService。
4.打开 network/MarsApiService.kt。
5.添加引用
import retrofit2.Retrofitimport retrofit2.converter.scalars.ScalarsConverterFactory
6.为 Web 服务的基础网址添加以下常量。
private const val BASE_URL = "https://jsonplaceholder.typicode.com"
7.在该常量正下方添加 Retrofit 构建器，用于构建和创建 Retrofit 对象。
private val retrofit = Retrofit.Builder()   //创建 Retrofit 对象      .addConverterFactory(ScalarsConverterFactory.create())   //使用 ScalarsConverterFactory 实例对构建器调用 addConverterFactory()。      .baseUrl(BASE_URL)// Web 服务添加基础网址。      .build()//创建 Retrofit 对象。
    Retrofit 需要 Web 服务的基础 URI 和转换器工厂来构建 Web 服务 API。转换器会告知 Retrofit 如何处理它从 Web 服务获取的数据。在这种情况下，我们需要 Retrofit 从 Web 服务提取 JSON 响应，并将该响应作为 String返回。Retrofit 包含一个ScalarsConverter，它支持字符串和其他基元类型。
8.在对 Retrofit 构建器的调用的下方，定义一个名为 MarsApiService 的接口，该接口定义 Retrofit 如何使用 HTTP 请求与网络服务器通信。向 MarsApiService 接口添加一个名为 getPhotos() 的函数，以从 Web 服务中获取响应字符串。将函数的返回值类型添加到 String。
import retrofit2.http.GET
interface MarsApiService {    @GET("photos")    suspend fungetPhotos(): String //从 Web 服务中获取响应字符串，suspend是设置为挂起函数，使其异步，并且不会阻塞发起调用的线程}
调用 getPhotos() 方法时，Retrofit 会将端点 photos 附加到您用于启动请求的基准网址（在 Retrofit 构建器中定义）。本文中访问的完整地址就是：https://jsonplaceholder.typicode.com/photos （大家可以自己看下这个链接的效果）。
使用 @GET 注解告知 Retrofit 这是 GET 请求，并为该 Web 服务方法指定端点。在这种情况下，端点为 photos。意思是将在此 Codelab 中使用 /photos 端点。
创建单例
在内存、速度和性能方面，对 Retrofit 对象调用 create() 函数的成本很高。因为我们的应用只需要一个 Retrofit API 服务实例，因此，可以使用对象声明向应用的其余部分公开该服务，也就是单例。（做过编程的朋友应该懂这个，单例不能乱用，因为它代表着难以预测的全局状态）
编码就是在 MarsApiService 接口声明外，定义一个名为 MarsApi 的公共对象，以初始化 Retrofit 服务。（此对象是应用的其余部分可以访问的公开单例对象。）
object MarsApi {    val retrofitService : MarsApiService by lazy { //延迟初始化的 Retrofit 对象属性(延迟初始化，确保其在首次使用时进行初始化)        retrofit.create(MarsApiService::class.java)//使用带有 MarsApiService 界面的 retrofit.create() 方法初始化 retrofitService 变量。    }}
到这，Retrofit 设置已完成！后续每次应用调用 MarsApi.retrofitService 时，调用方都会访问同一个单例 Retrofit 对象，该对象会实现在首次访问时创建的MarsApiService。
创建容器（ViewModel）
这个模型的作用是专门放网络请求、存接口返回 JSON 字符串的容器。（后续有机会我们学习下基础的MVVM 架构规范，随着真实做项目，我们应该还是需要界面、网络、业务分层好一些）
我们这里只做一个简单的分层：
  • network/MarsApiService
    ：仅定义接口、底层网络工具；
  • MarsViewModel
    ：调用网络、处理结果、保存返回的 JSON 字符串；
  • 主（Compose）界面：只读取 MarsViewModel（ViewModel） 给好的数据，渲染到屏幕。
1.再次新建一个kotlin文件“MarsViewModel”：
2.使其继承ViewModel。
（ViewModel 是谷歌 Jetpack 提供的页面数据 & 业务逻辑容器，专门用来把「联网、数据、计算」和「界面 UI 代码」分开，是 MVVM 架构里中间层。作用是数据不会随屏幕旋转丢失、统一存放网络请求逻辑，UI 完全不碰网络）
import androidx.lifecycle.ViewModelclassMarsViewModel: ViewModel()  {    }
3.完善模型的获取网络函数代码：
package com.example.photoalbumimport androidx.lifecycle.ViewModelimport com.example.photoalbum.network.MarsApiimport androidx.lifecycle.viewModelScopeimport kotlinx.coroutines.flow.MutableStateFlowimport kotlinx.coroutines.flow.StateFlowimport kotlinx.coroutines.launchclass MarsViewModel: ViewModel()  {    //最近的网络请求的状态    // 私有可变状态，内部修改    private val _marsUiState = MutableStateFlow("加载中...")//MutableStateFlow 是 ViewModel 专用的可观察可变状态容器，属于 Kotlin 协程 Flow 体系，专门用来存放页面 UI 数据。    // 对外只读状态，UI只能读取不能修改    val marsUiState: StateFlow<String> = _marsUiState    init {        getMarsPhotos()    }    private fungetMarsPhotos() {        viewModelScope.launch {  //使用异步执行发出 Web 服务请求            try {                val listResult  = MarsApi.retrofitService.getPhotos()//使用单例对象 MarsApi 从 retrofitService 接口调用 getPhotos() 方法。将返回的响应保存在名为 listResult 的 val 中。                _marsUiState.value = listResult            } catch (e: Exception) {                _marsUiState.value  = "请求失败：${e.message}"            }        }    }}
代码备注的比较详细，具体内容就不再累述。

添加互联网权限

权限旨在保护 Android 用户的隐私。Android 应用必须声明或请求访问敏感用户数据（如联系人、通话记录和某些系统功能，如相机或互联网）的权限。
因为连接到互联网会引起安全问题，因此默认应用没有连接互联网。所以我们需要 INTERNET 权限才能访问互联网。
打开 AndroidManifest.xml，<application> 标签上方添加：
<uses-permissionandroid:name="android.permission.INTERNET" />

MainActivity 挂载 ViewModel

先获取实例并传入对应的函数中：
private val marsViewModel: MarsViewModel byviewModels ()
在Greeting中接受数据并展示：
Text(                text = jsonText,                modifier = Modifier.padding(top = 20.dp),                fontSize = 12.sp            )
这里反应有点慢，需要耐心等一下，因为这个是境外的网址，模拟器访问会很慢，而完全免费、无密钥、国内直连、返回 [{id, 完整图片直链}] 数组的公开接口太难找了，大家有的话也可以评论区分享。
最后结果是这样的：
这个返回的JSON内容，我们可以看到有对应的id及图片的地址，说明我们已经成功的从网络上获取数据啦。
那因为本节已经很长啦，有关怎么解析JSON，以及如何对异常进行处理，我们下节再见吧~~~
本节的代码源码：photoalbum.zip     
若加密了，加密密码是yuanyuxin（后续如果有密码，都是这个哈）。
本文来自网友投稿或网络内容，如有侵犯您的权益请联系我们删除，联系邮箱：596563534@qq.com 。

鸿蒙生态里程碑!HarmonyOS 6设备破7000万,华为海量新机即将登场

安卓微信 8.0.76 正式版,支持删除撤回提示

最新文章

随机文章