/* * Copyright (C) 2019 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.settings.core; import android.content.Context; import androidx.annotation.NonNull; import androidx.annotation.VisibleForTesting; import androidx.annotation.WorkerThread; import androidx.fragment.app.Fragment; import androidx.lifecycle.MutableLiveData; import androidx.preference.Preference; import androidx.preference.PreferenceScreen; import com.android.settings.R; import com.android.settingslib.utils.ThreadUtils; /** * This controller is targeted at the time consuming-bound controller. */ public abstract class LiveDataController extends BasePreferenceController { @VisibleForTesting protected CharSequence mSummary; private Preference mPreference; private MutableLiveData mData; public LiveDataController(Context context, String preferenceKey) { super(context, preferenceKey); mData = new MutableLiveData<>(); mSummary = context.getText(R.string.summary_placeholder); } /** * Initialize controller as live data controller and * execute the background task for retrieving the summary text right away. * @param fragment the owner of the live data observer. */ public void initLifeCycleOwner(@NonNull Fragment fragment) { mData.observe(fragment, str -> { mSummary = str; refreshSummary(mPreference); }); ThreadUtils.postOnBackgroundThread(() -> { mData.postValue(getSummaryTextInBackground()); }); } @Override public void displayPreference(PreferenceScreen screen) { super.displayPreference(screen); mPreference = screen.findPreference(getPreferenceKey()); } @Override public CharSequence getSummary() { return mSummary; } /** * Execute the time consuming work. */ @WorkerThread protected abstract CharSequence getSummaryTextInBackground(); }