【Android Training - 04】保存數據 [ Lesson 1 - 保存Key-Value]

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，謝謝！