Saving Key-Value Sets
如果你有一個相對較小的key-value集合需要保存,你應該使用SharedPreferences
APIs。 SharedPreferences
對象指向了一個保存key-value
pairs的文件,並且它提供了簡單的方法來讀寫這個文件。每一個 SharedPreferences
文件都是由framework管理的並且可以是私有或者可分享的。
這節課會演示如何使用 SharedPreferences
APIs
來存儲與檢索簡單的數據。
Note: SharedPreferences APIs 僅僅提供了讀寫key-value對的功能,請不要與 Preference APIs相混淆。後者可以幫助你建立一個設置用戶配置的頁面(儘管它實際上是使用SharedPreferences 來實現保存用戶配置的)。如果想了解更多關於Preference APIs的信息,請參考Settings 指南。
Get a Handle to a SharedPreferences [獲取SharedPreference的Handle]
你可以通過下面兩個方法之一來創建或者訪問shared preference 文件:
getSharedPreferences()
— 如果你需要多個通過名稱參數來區分的shared preference文件, 名稱可以通過第一個參數來指定。你可以在你的app裏面通過任何一個Context
來執行這個方法。getPreferences()
— 當你的activity僅僅需要一個shared preference文件時。因爲這個方法會檢索activitiy下的默認的shared preference文件,並不需要提供文件名稱。
例如:下面的示例是在 Fragment
中被執行的,它會訪問名爲 R.string.preference_file_key
的shared
preference文件,並使用private模式來打開它,這樣的話,此時文件就僅僅可以被你的app訪問了。
Context context = getActivity(); SharedPreferences sharedPref = context.getSharedPreferences( getString(R.string.preference_file_key), Context.MODE_PRIVATE);
當命名你的shared preference文件時,你應該像 "com.example.myapp.PREFERENCE_FILE_KEY"
這樣來命名。
當然,如果你的activity僅僅需要一個shared preference文件時,你可以使用 getPreferences()
方法:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);Caution: 如果你創建了一個
MODE_WORLD_READABLE
或者 MODE_WORLD_WRITEABLE
模式的shared
preference文件,那麼任何其他的app只要知道文件名,則可以訪問這個文件。
Write to Shared Preferences [寫Shared Preference]
爲了寫shared preferences文件,需要通過執行 edit()
來創建一個 SharedPreferences.Editor。
通過類似 putInt()
與 putString()
方法來傳遞keys與values。然後執行 commit()
來提交改變。[後來有建議除非是出於線程同步的需要,否則請使用apply()方法來替代commit(),因爲後者有可能會卡到UI
Thread.]
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE); SharedPreferences.Editor editor = sharedPref.edit(); editor.putInt(getString(R.string.saved_high_score), newHighScore); editor.commit();
Read from Shared Preferences [讀Shared Preference]
爲了從shared preference中檢索讀取數據,可以通過類似getInt()
與 getString()
等方法來讀取。在那些方法裏面傳遞你想要獲取value對應的key,並且提供一個默認的value。如下:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE); long default = getResources().getInteger(R.string.saved_high_score_default)); long highScore = sharedPref.getInt(getString(R.string.saved_high_score), default);
學習自:http://developer.android.com/training/basics/data-storage/shared-preferences.html,歡迎交流!
轉載請註明出自:http://blog.csdn.net/kesenhoo,謝謝!