Подключиться к сети

Для выполнения сетевых операций в вашем приложении ваш манифест должен включать следующие разрешения:

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

Лучшие практики безопасного сетевого взаимодействия

Прежде чем добавлять сетевые функции в своё приложение, необходимо убедиться, что данные и информация в нём будут защищены при передаче по сети. Для этого следуйте следующим рекомендациям по сетевой безопасности:

  • Минимизируйте объем конфиденциальных или личных данных пользователей , передаваемых по сети.
  • Отправляйте весь сетевой трафик из вашего приложения по протоколу SSL .
  • Рассмотрите возможность создания конфигурации безопасности сети , которая позволит вашему приложению доверять пользовательским центрам сертификации (ЦС) или ограничить набор системных ЦС, которым оно доверяет для безопасной связи.

Дополнительную информацию о применении принципов безопасности сетей см. в советах по безопасности сетей .

Выберите HTTP-клиент

Большинство приложений, подключенных к сети, используют HTTP для отправки и получения данных. Платформа Android включает в себя клиент HttpsURLConnection , который поддерживает TLS, потоковые загрузки и загрузки, настраиваемые тайм -ауты, IPv6 и объединение соединений.

Также доступны сторонние библиотеки, предлагающие высокоуровневые API для сетевых операций. Они поддерживают различные удобные функции, такие как сериализация тел запросов и десериализация тел ответов.

  • Retrofit : типобезопасный HTTP-клиент для JVM от Square, построенный на основе OkHttp. Retrofit позволяет декларативно создавать клиентский интерфейс и поддерживает несколько библиотек сериализации.
  • Ktor : HTTP-клиент от JetBrains, полностью разработанный для Kotlin и работающий на основе сопрограмм. Ktor поддерживает различные движки, сериализаторы и платформы.

Разрешение DNS-запросов

Устройства под управлением Android 10 (уровень API 29) и выше имеют встроенную поддержку специализированных DNS-запросов как с открытым текстом, так и в режиме DNS-over-TLS. API DnsResolver обеспечивает универсальное асинхронное разрешение, позволяющее искать записи SRV , NAPTR и других типов. Анализ ответа выполняется приложением.

На устройствах под управлением Android 9 (уровень API 28) и ниже DNS-преобразователь платформы поддерживает только записи A и AAAA . Это позволяет искать IP-адреса, связанные с именем, но не поддерживает другие типы записей.

Для приложений на основе NDK см. android_res_nsend .

Инкапсуляция сетевых операций с помощью репозитория

Чтобы упростить процесс выполнения сетевых операций и уменьшить дублирование кода в различных частях приложения, можно использовать шаблон проектирования «Репозиторий». Репозиторий — это класс, который обрабатывает операции с данными и предоставляет понятную абстракцию API для определенных данных или ресурсов.

Вы можете использовать Retrofit для объявления интерфейса, который определяет метод HTTP, URL, аргументы и тип ответа для сетевых операций, как в следующем примере:

Котлин 

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

Ява 

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

В классе репозитория функции могут инкапсулировать сетевые операции и предоставлять их результаты. Такая инкапсуляция гарантирует, что компонентам, обращающимся к репозиторию, не нужно знать, как хранятся данные. Любые будущие изменения способа хранения данных также будут изолированы в классе репозитория. Например, это может быть удалённое изменение, такое как обновление конечных точек API, или может потребоваться реализовать локальное кэширование.

Котлин 

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

Ява 

class UserRepository {
    private UserService userService;

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

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

Чтобы избежать зависания пользовательского интерфейса, не выполняйте сетевые операции в основном потоке. По умолчанию Android требует, чтобы сетевые операции выполнялись в потоке, отличном от основного потока пользовательского интерфейса. При попытке выполнить сетевые операции в основном потоке возникает исключение NetworkOnMainThreadException .

В предыдущем примере кода сетевая операция фактически не запускается. Вызывающий UserRepository должен реализовать потоковую обработку либо с помощью сопрограмм, либо с помощью функции enqueue() . Подробнее см. в практической работе « Получение данных из интернета» , где показано, как реализовать потоковую обработку с помощью сопрограмм Kotlin.

Пережить изменения конфигурации

При изменении конфигурации, например, повороте экрана, фрагмент или активность уничтожаются и создаются заново. Все данные, не сохранённые в состоянии экземпляра для активности фрагмента, которая может содержать лишь небольшие объёмы данных, теряются. В этом случае может потребоваться повторить сетевые запросы.

Вы можете использовать ViewModel , чтобы ваши данные сохраняли актуальность при изменении конфигурации. Компонент ViewModel предназначен для хранения и управления данными пользовательского интерфейса с учётом жизненного цикла. Используя предшествующий UserRepository , ViewModel может выполнять необходимые сетевые запросы и предоставлять результат фрагменту или активности с помощью LiveData :

Котлин 

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
            }

        }
    }
}

Ява 

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
            }
        });
    }
}

Более подробную информацию по этой теме можно найти в следующих руководствах: