Android SharedPreference最佳实践

Android提供多种方式保存应用数据，其中一种方式是SharedPreferences，使用键值对保存私有基本的数据。所有的逻辑仅基于以下三个类：

• SharedPreferences
• SharedPreferences.Editor
• SharedPreferences.OnSharedPreferenceChangeListener

SharedPreference

SharedPreference在这三个类是最重要的，负责获取（解析）存储数据。提供获取对象的编辑接口，在OnSharedPreferenceChangeListener中提供增加移出对象的接口。

• 创建SharedPreference对象，需要上下文对象（可以是应用程序的上下文）。
• getSharedPreferences 方法解析配置文件并创建相关的对象映射。
• 通过上下文有多种创建它，强烈建议使用MODE_PRIVATE。因为创建一个可读写的文件是非常危险的，容易在应用中产生安全漏洞。

// parse Preference file
SharedPreferences preferences = context.getSharedPreferences("<span class="skimlinks-unlinked">com.example.app", Context.MODE_PRIVATE);

// get values from Map
preferences.getBoolean("key", defaultValue)
preferences.get..("key", defaultValue)

// you can get all Map but be careful you must not modify the collection returned by this
// method, or alter any of its contents.
Map<String, ?> all = preferences.getAll();

// get Editor object
SharedPreferences.Editor editor = preferences.edit();

//add on Change Listener
preferences.registerOnSharedPreferenceChangeListener(mListener);

//remove on Change Listener
preferences.unregisterOnSharedPreferenceChangeListener(mListener);

// listener example
SharedPreferences.OnSharedPreferenceChangeListener mOnSharedPreferenceChangeListener
        =newSharedPreferences.OnSharedPreferenceChangeListener() {
    @Override
    publicvoidonSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
    }
};

Editor

SharedPreferences.Editor是用来修改SharedPreferences对象值的接口。你在editor 做出的修改都是待处理的，并没有被复制到SharedPreferences里，直到你调用commit()或apply()修改才会被执行。

• 使用简单的接口在Editor放入值。
• 同步保存数据使用commit() 方法或者异步保存数据使用apply()方法会更快点。实际上不同的线程使用commit()会更快点，这是我喜欢使用commit()方法的原因。
• 移出数据使用remove()方法，清除所有数据使用clear()方法。

// get Editor object
SharedPreferences.Editor editor = preferences.edit();

// put values in editor
editor.putBoolean("key", value);
editor.put..("key", value);

// remove single value by key
editor.remove("key");

// remove all values
editor.clear();

// commit your putted values to the SharedPreferences object synchronously
// returns true if success
booleanresult = editor.commit();

// do the same as commit() but asynchronously (faster but not safely)
// returns nothing
editor.apply();

性能和注意事项

SharedPreferences是单例对象，你可以很容易获取你想要的引用。只在你第一次调用getSharedPreferences方法时打开文件时，创建一个实例对象。

// There are 1000 String values in preferences
SharedPreferences first = context.getSharedPreferences("com.example.app", Context.MODE_PRIVATE);
// call time = 4 milliseconds

SharedPreferences second = context.getSharedPreferences("com.example.app", Context.MODE_PRIVATE);
// call time = 0 milliseconds

SharedPreferences third = context.getSharedPreferences("com.example.app", Context.MODE_PRIVATE);
// call time = 0 milliseconds

SharedPreferences 是单例对象，你可以改变它的实例，不用担心同一个对象数据会不同。

first.edit().putInt(”key”,).commit();
intfirstValue = first.getInt(”key”,));
// firstValue is 15
intsecondValue = second.getInt(”key”,));
// secondValue is also 15

当你第一次调用get方法时，它解析对象并把放入map中，第二次获取数据从map 中获取，不需再解析。

first.getString(”key”,null)
// call time = 147 milliseconds

first.getString(”key”,null)
// call time = 0 milliseconds

second.getString(”key”,null)
// call time = 0 milliseconds

third.getString(”key”,null)
// call time = 0 milliseconds

记住Preference的数据越大，get、commit、apply、remove和clear方法耗时越长。所以强烈建议把存储的数据分成小的对象。

当你的应用更新以后，你的Preferences不会被移除。所以有些情况下需要创建迁移数据的方案。比如，在应用启动的时候，你的应用解析本地JSON数据，实现这个你需要做的仅仅是存储标志数据（该数据是否为本地数据）。一段时间后，你更新JSON数据发布新的版本，用户会更新应用程序但是不会下载新的JSON数据，因为已经在本地存储了。

publicclassMigrationManager {
    privatefinalstaticString KEY_PREFERENCES_VERSION ="key_preferences_version";
    privatefinalstaticintPREFERENCES_VERSION =;

    publicstaticvoidmigrate(Context context) {
        SharedPreferences preferences = context.getSharedPreferences("pref", Context.MODE_PRIVATE);
        checkPreferences(preferences);
    }

    privatestaticvoidcheckPreferences(SharedPreferences thePreferences) {
        finaldoubleoldVersion = thePreferences.getInt(KEY_PREFERENCES_VERSION,);

        if(oldVersion < PREFERENCES_VERSION) {
            finalSharedPreferences.Editor edit = <spanclass="skimlinks-unlinked">thePreferences.edit</span>();
            <spanclass="skimlinks-unlinked">edit.clear</span>();
            edit.putInt(KEY_PREFERENCES_VERSION, currentVersion);
            edit.commit();
        }
    }
}

SharedPreferences 数据存储在app文件夹下的xml文件下。

// yours preferences
/data/data/YOUR_PACKAGE_NAME/shared_prefs/YOUR_PREFS_NAME.xml

// default preferences
/data/data/YOUR_PACKAGE_NAME/shared_prefs/YOUR_PACKAGE_NAME_preferences.xml

示例代码

publicclassPreferencesManager {

    privatestaticfinalString PREF_NAME ="<span class="skimlinks-unlinked">com.example.app.PREF_NAME";
    privatestaticfinalString KEY_VALUE ="<span class="skimlinks-unlinked">com.example.app.KEY_VALUE";

    privatestaticPreferencesManager sInstance;
    privatefinalSharedPreferences mPref;

    privatePreferencesManager(Context context) {
        mPref = context.getSharedPreferences(PREF_NAME, Context.MODE_PRIVATE);
    }

    publicstaticsynchronizedvoidinitializeInstance(Context context) {
        if(sInstance ==null) {
            sInstance =newPreferencesManager(context);
        }
    }

    publicstaticsynchronizedPreferencesManager getInstance() {
        if(sInstance ==null) {
            thrownewIllegalStateException(PreferencesManager.class.getSimpleName() +
                    " is not initialized, call initializeInstance(..) method first.");
        }
        returnsInstance;
    }

    publicvoidsetValue(longvalue) {
        mPref.edit()
                .putLong(KEY_VALUE, value)
                .commit();
    }

    publiclonggetValue() {
        returnmPref.getLong(KEY_VALUE,);
    }

    publicvoidremove(String key) {
        mPref.edit()
                .remove(key)
                .commit();
    }

    publicbooleanclear() {
        returnmPref.edit()
                .clear()
                .commit();
    }
}

本文代码可以在github上找到。