连接网络

要在您的应用中执行网络操作，您的清单必须包含以下权限

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

安全网络通信的最佳实践

在向您的应用添加网络功能之前，您需要确保在通过网络传输时，应用中的数据和信息保持安全。为此，请遵循以下网络安全最佳实践

  • 最大程度减少通过网络传输的敏感或个人 用户数据 量。
  • 通过 SSL 发送应用的所有网络流量。

  • 考虑创建网络安全配置，允许您的应用信任自定义证书颁发机构 (CA) 或限制其用于安全通信的系统 CA 集。

有关如何应用安全网络原则的更多信息，请参阅网络安全提示。

选择 HTTP 客户端

大多数网络连接的应用使用 HTTP 发送和接收数据。Android 平台包含HttpsURLConnection 客户端，它支持 TLS、流式上传和下载、可配置超时、IPv6 和连接池。

还提供用于网络操作的高级 API 的第三方库。这些库支持各种便捷功能，例如请求正文的序列化和响应正文的反序列化。

  • Retrofit：来自 Square 的 JVM 的类型安全 HTTP 客户端，构建在 OkHttp 之上。Retrofit 允许您声明性地创建客户端接口，并支持多个序列化库。
  • Ktor：来自 JetBrains 的 HTTP 客户端，完全为 Kotlin 构建，并由协程提供支持。Ktor 支持各种引擎、序列化器和平台。

解析 DNS 查询

运行 Android 10（API 级别 29）及更高版本的设备通过明文查找和 DNS-over-TLS 模式内置支持专用 DNS 查找。该DnsResolverAPI 提供通用异步解析，允许您查找SRV、NAPTR和其他记录类型。解析响应留给应用执行。

在运行 Android 9（API 级别 28）及更低版本的设备上，平台 DNS 解析器仅支持A和AAAA记录。这允许您查找与名称关联的 IP 地址，但不支持任何其他记录类型。

对于基于 NDK 的应用，请参阅android_res_nsend。

使用存储库封装网络操作

为了简化执行网络操作的过程并减少应用各个部分中的代码重复，您可以使用存储库设计模式。存储库是一个处理数据操作并提供对某些特定数据或资源的简洁 API 抽象的类。

您可以使用 Retrofit 声明一个接口，该接口指定网络操作的 HTTP 方法、URL、参数和响应类型，如下例所示

Kotlin

interface UserService {
    @GET("/users/{id}")
    suspend fun getUser(@Path("id") id: String): User
}

Java

public interface UserService {
    @GET("/user/{id}")
    Call<User> getUserById(@Path("id") String id);
}

在存储库类中，函数可以封装网络操作并公开其结果。此封装确保调用存储库的组件不需要知道数据是如何存储的。对数据存储方式的任何未来更改也将隔离到存储库类中。例如，您可能会有一个远程更改，例如 API 端点的更新，或者您可能希望实现本地缓存。

Kotlin

class UserRepository constructor(
    private val userService: UserService
) {
    suspend fun getUserById(id: String): User {
        return userService.getUser(id)
    }
}

Java

class UserRepository {
    private UserService userService;

    public UserRepository(
            UserService userService
    ) {
        this.userService = userService;
    }

    public Call<User> getUserById(String id) {
        return userService.getUser(id);
    }
}

为了避免创建无响应的 UI，不要在主线程上执行网络操作。默认情况下，Android 要求您在主 UI 线程以外的其他线程上执行网络操作。如果您尝试在主线程上执行网络操作，则会抛出NetworkOnMainThreadException。

在上一个代码示例中，网络操作实际上并没有触发。 UserRepository的调用者必须使用协程或使用enqueue()函数来实现线程。有关更多信息，请参阅代码实验室从互联网获取数据，其中演示了如何使用 Kotlin 协程实现线程。

在配置更改后继续运行

当发生配置更改（例如屏幕旋转）时，您的片段或活动将被销毁并重新创建。任何未在片段活动的实例状态中保存的数据（只能保存少量数据）都会丢失。如果发生这种情况，您可能需要重新发出网络请求。

您可以使用ViewModel让您的数据在配置更改后继续存在。 ViewModel组件旨在以生命周期感知的方式存储和管理与 UI 相关的数据。使用前面的UserRepository，ViewModel可以发出必要的网络请求，并使用LiveData将结果提供给您的片段或活动。

Kotlin

class MainViewModel constructor(
    savedStateHandle: SavedStateHandle,
    userRepository: UserRepository
) : ViewModel() {
    private val userId: String = savedStateHandle["uid"] ?:
        throw IllegalArgumentException("Missing user ID")

    private val _user = MutableLiveData<User>()
    val user = _user as LiveData<User>

    init {
        viewModelScope.launch {
            try {
                // Calling the repository is safe as it moves execution off
                // the main thread
                val user = userRepository.getUserById(userId)
                _user.value = user
            } catch (error: Exception) {
                // Show error message to user
            }

        }
    }
}

Java

class MainViewModel extends ViewModel {

    private final MutableLiveData<User> _user = new MutableLiveData<>();
    LiveData<User> user = (LiveData<User>) _user;

    public MainViewModel(
            SavedStateHandle savedStateHandle,
            UserRepository userRepository
    ) {
        String userId = savedStateHandle.get("uid");
        Call<User> userCall = userRepository.getUserById(userId);
        userCall.enqueue(new Callback<User>() {
            @Override
            public void onResponse(Call<User> call, Response<User> response) {
                if (response.isSuccessful()) {
                    _user.setValue(response.body());
                }
            }

            @Override
            public void onFailure(Call<User> call, Throwable t) {
                // Show error message to user
            }
        });
    }
}

要详细了解此主题，请参阅以下相关指南