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() {@OverridepublicvoidonSharedPreferenceChanged(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”,15).commit();
intfirstValue = first.getInt(”key”,0));
// firstValue is 15
intsecondValue = second.getInt(”key”,0));
// 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 =2;publicstaticvoidmigrate(Context context) {SharedPreferences preferences = context.getSharedPreferences("pref", Context.MODE_PRIVATE);checkPreferences(preferences);}privatestaticvoidcheckPreferences(SharedPreferences thePreferences) {finaldoubleoldVersion = thePreferences.getInt(KEY_PREFERENCES_VERSION,1);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,0);}publicvoidremove(String key) {mPref.edit().remove(key).commit();}publicbooleanclear() {returnmPref.edit().clear().commit();}
}

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

转载于:https://www.cnblogs.com/zhujiabin/p/5286347.html