Сохранение состояния фрагментами,Сохранение состояния фрагментами

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

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

• Переменные: локальные переменные во фрагменте.
• Состояние представления: любые данные, принадлежащие одному или нескольким представлениям во фрагменте.
• SavedState: данные, присущие этому экземпляру фрагмента, которые следует сохранить в onSaveInstanceState() .
• NonConfig: данные, полученные из внешнего источника, например сервера или локального репозитория, или созданные пользователем данные, которые отправляются на сервер после фиксации.

Часто переменные обрабатываются так же, как SavedState , но в следующей таблице различаются эти две вещи, чтобы продемонстрировать влияние различных операций на каждую из них.

* Состояние NonConfig можно сохранить после смерти процесса с помощью модуля Saved State для ViewModel .

Таблица 1: Различные операции по разрушению фрагментов и их влияние на разные типы состояний.

Давайте рассмотрим конкретный пример. Рассмотрим экран, который генерирует случайную строку, отображает ее в TextView и предоставляет возможность редактировать строку перед отправкой ее другу:

В этом примере предположим, что как только пользователь нажимает кнопку редактирования, приложение отображает представление EditText , в котором пользователь может редактировать сообщение. Если пользователь нажимает CANCEL , представление EditText должно быть очищено, а его видимость установлена ​​на View.GONE . Для обеспечения бесперебойной работы такого экрана может потребоваться управление четырьмя частями данных:

Таблица 2: Указывает, что приложение генератора случайного текста должно управлять.

В следующих разделах описывается, как правильно управлять состоянием ваших данных с помощью разрушительных операций.

Посмотреть состояние

Представления отвечают за управление собственным состоянием. Например, когда представление принимает вводимые пользователем данные, представление несет ответственность за сохранение и восстановление этих вводимых данных для обработки изменений конфигурации. Все представления, предоставляемые платформой Android, имеют собственную реализацию onSaveInstanceState() и onRestoreInstanceState() , поэтому вам не нужно управлять состоянием представления внутри фрагмента.

Например, в предыдущем сценарии отредактированная строка хранится в EditText . EditText знает значение отображаемого текста, а также другие детали, такие как начало и конец любого выделенного текста.

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

<EditText
    android:id="@+id/good_deed_edit_text"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

Как упоминалось в таблице 1, представления сохраняют и восстанавливают свое ViewState посредством всех операций, которые не удаляют фрагмент или не уничтожают хост.

SavedState

Ваш фрагмент отвечает за управление небольшими объемами динамического состояния, которые являются неотъемлемой частью функционирования фрагмента. Вы можете сохранить легко сериализуемые данные, используя Fragment.onSaveInstanceState(Bundle) . Подобно Activity.onSaveInstanceState(Bundle) данные, которые вы помещаете в пакет, сохраняются при изменениях конфигурации, а также смерти и воссоздании процесса и доступны в onCreate(Bundle) вашего фрагмента, onCreateView(LayoutInflater, ViewGroup, Bundle) и onViewCreated(View, Bundle) методы.

Продолжая предыдущий пример, randomGoodDeed — это документ, который отображается пользователю, а isEditing — это флаг, определяющий, показывает или скрывает фрагмент EditText . Это сохраненное состояние следует сохранить с помощью onSaveInstanceState(Bundle) , как показано в следующем примере:

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    outState.putBoolean(IS_EDITING_KEY, isEditing)
    outState.putString(RANDOM_GOOD_DEED_KEY, randomGoodDeed)
}

@Override
public void onSaveInstanceState(@NonNull Bundle outState) {
    super.onSaveInstanceState(outState);
    outState.putBoolean(IS_EDITING_KEY, isEditing);
    outState.putString(RANDOM_GOOD_DEED_KEY, randomGoodDeed);
}

Чтобы восстановить состояние в onCreate(Bundle) извлеките сохраненное значение из пакета:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    isEditing = savedInstanceState?.getBoolean(IS_EDITING_KEY, false)
    randomGoodDeed = savedInstanceState?.getString(RANDOM_GOOD_DEED_KEY)
            ?: viewModel.generateRandomGoodDeed()
}

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    if (savedInstanceState != null) {
        isEditing = savedInstanceState.getBoolean(IS_EDITING_KEY, false);
        randomGoodDeed = savedInstanceState.getString(RANDOM_GOOD_DEED_KEY);
    } else {
        randomGoodDeed = viewModel.generateRandomGoodDeed();
    }
}

Как указано в таблице 1, обратите внимание, что переменные сохраняются, когда фрагмент помещается в стек. Обращение с ними как с сохраненным состоянием гарантирует, что они сохранятся при всех разрушительных операциях.

Неконфигурируемый

Данные NonConfig следует размещать за пределами вашего фрагмента, например, в ViewModel . В предыдущем примере выше seed (наше состояние NonConfig) генерируется в ViewModel . Логика поддержания его состояния принадлежит ViewModel .

public class RandomGoodDeedViewModel : ViewModel() {
    private val seed = ... // Generate the seed

    private fun generateRandomGoodDeed(): String {
        val goodDeed = ... // Generate a random good deed using the seed
        return goodDeed
    }
}

public class RandomGoodDeedViewModel extends ViewModel {
    private Long seed = ... // Generate the seed

    private String generateRandomGoodDeed() {
        String goodDeed = ... // Generate a random good deed using the seed
        return goodDeed;
    }
}

Класс ViewModel по своей сути позволяет данным сохраняться при изменении конфигурации, например повороте экрана, и оставаться в памяти, когда фрагмент помещается в задний стек. После смерти и воссоздания процесса ViewModel создается заново и создается новое seed . Добавление модуля SavedState в вашу ViewModel позволяет ViewModel сохранять простое состояние даже при прекращении и воссоздании процесса.

Дополнительные ресурсы

Дополнительные сведения об управлении состоянием фрагмента см. в следующих дополнительных ресурсах.

Кодлабы

• Лаборатория разработки компонентов с учетом жизненного цикла

Путеводители

• Модуль сохраненного состояния для модели представления
• Сохранение состояний пользовательского интерфейса