Как хранить константные параметры типа "ключ-значение" в DataStore

Хранение констант "ключ-значение" в Android DataStore

Для хранения константных параметров типа "ключ-значение" в DataStore рекомендуется использовать Preferences DataStore, который идеально подходит для простых пар ключ-значение в отличие от Proto DataStore, требующего определения схемы через protobuf.

Основные подходы к хранению констант

1. Определение ключей через Preferences.Key<T>

Ключи в DataStore строго типизированы, что обеспечивает типобезопасность:

object PreferencesKeys {
    val USER_NAME = stringPreferencesKey("user_name")
    val USER_AGE = intPreferencesKey("user_age")
    val IS_PREMIUM = booleanPreferencesKey("is_premium")
    val LAST_SYNC_TIME = longPreferencesKey("last_sync_time")
}

2. Создание DataStore экземпляра

DataStore создается с использованием контекста приложения:

val Context.settingsDataStore: DataStore<Preferences> by preferencesDataStore(
    name = "settings"
)

Работа с константными параметрами

Запись значений:

suspend fun saveUserName(context: Context, name: String) {
    context.settingsDataStore.edit { preferences ->
        preferences[PreferencesKeys.USER_NAME] = name
    }
}

Чтение значений:

val userNameFlow: Flow<String> = context.settingsDataStore.data
    .map { preferences ->
        preferences[PreferencesKeys.USER_NAME] ?: "default_value"
    }

Паттерны для управления константами

1. Repository слой для инкапсуляции логики

class SettingsRepository(private val dataStore: DataStore<Preferences>) {
    
    val userName: Flow<String> = dataStore.data
        .map { it[PreferencesKeys.USER_NAME] ?: "" }
    
    suspend fun updateUserName(name: String) {
        dataStore.edit { it[PreferencesKeys.USER_NAME] = name }
    }
    
    companion object {
        @Volatile
        private var INSTANCE: SettingsRepository? = null
        
        fun getInstance(dataStore: DataStore<Preferences>): SettingsRepository {
            return INSTANCE ?: synchronized(this) {
                INSTANCE ?: SettingsRepository(dataStore).also { INSTANCE = it }
            }
        }
    }
}

2. Обработка дефолтных значений

DataStore не поддерживает дефолтные значения на уровне API, поэтому их нужно обрабатывать вручную:

object DefaultValues {
    const val DEFAULT_USER_NAME = "Guest"
    const val DEFAULT_USER_AGE = 0
    const val DEFAULT_IS_PREMIUM = false
}

val userAgeWithDefault = dataStore.data.map {
    it[PreferencesKeys.USER_AGE] ?: DefaultValues.DEFAULT_USER_AGE
}

Кеширование для производительности

Для константных параметров, которые редко меняются, полезно добавить кеширование:

class CachedSettingsRepository(
    private val dataStore: DataStore<Preferences>
) {
    private var cachedUserName: String? = null
    
    val userName: Flow<String> = dataStore.data
        .map { preferences ->
            preferences[PreferencesKeys.USER_NAME] ?: DefaultValues.DEFAULT_USER_NAME
        }
        .onEach { cachedUserName = it }
        .distinctUntilChanged()
    
    fun getCachedUserName(): String? = cachedUserName
}

Миграция с SharedPreferences

DataStore предоставляет простую миграцию с SharedPreferences:

val Context.settingsDataStore: DataStore<Preferences> by preferencesDataStore(
    name = "settings",
    produceMigrations = { context ->
        listOf(
            SharedPreferencesMigration(
                context,
                "legacy_settings_prefs"
            )
        )
    }
)

Ключевые рекомендации

1. Используйте Preferences DataStore для простых констант "ключ-значение"
2. Все операции DataStore должны быть асинхронными - используйте coroutines
3. Не храните большие данные - DataStore не предназначен для больших бинарных данных
4. Обрабатывайте ошибки при чтении/записи
5. Используйте Dependency Injection для управления зависимостями DataStore

// Пример с обработкой ошибок
suspend fun safeUpdateSetting(key: Preferences.Key<String>, value: String) {
    try {
        dataStore.edit { it[key] = value }
    } catch (e: IOException) {
        Log.e("DataStore", "Failed to update setting", e)
        // Возможно, кешировать значение для повторной попытки
    }
}

DataStore предоставляет надежный, асинхронный и типобезопасный способ хранения константных параметров с лучшей производительностью и надежностью по сравнению с SharedPreferences, особенно для критически важных настроек приложения.