5.1 保存鍵值集
如果您有想要保存的相對較小鍵值集合,您應使用 SharedPreferences
API。SharedPreferences
對象指向包含鍵值對的文件並提供讀寫這些文件的簡單方法。 每個 SharedPreferences
文件由框架進行管理並且可以專用或共享。
本課向您展示如何使用 SharedPreferences
API 存儲和檢索簡單的值。
註:SharedPreferences
API 僅用於讀寫鍵值對,您不得將其與 Preference
API 混淆,後者幫助您為您的應用設置構建用戶界面(盡管它們使用 SharedPreferences
作為其實現以保存應用設置)。 有關使用 Preference
獲取共享首選項的句柄
您可以通過調用以下兩種方法之一創建新的共享首選項文件或訪問現有的文件:
getSharedPreferences()
— 如果您需要按照您用第一個參數指定的名稱識別的多個共享首選項文件,請使用此方法。 您可以從您的應用中的任何Context
調用此方法。getPreferences()
— 如果您只需使用 Activity 的一個共享首選項,請從Activity
中使用此方法。 因為此方法會檢索屬於該 Activity 的默認共享首選項文件,您無需提供名稱。
例如,以下代碼在 Fragment
內執行。它訪問通過資源字符串 R.string.preference_file_key
Context context = getActivity(); SharedPreferences sharedPref = context.getSharedPreferences( getString(R.string.preference_file_key), Context.MODE_PRIVATE);
命名您的共享首選項文件時,您應使用對於您的應用而言唯一可識別的名稱,比如 "com.example.myapp.PREFERENCE_FILE_KEY"
或者,如果您只需 Activity 的一個共享首選項文件,您可以使用 getPreferences()
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);
註意:如果您創建帶 MODE_WORLD_READABLE
或 MODE_WORLD_WRITEABLE
的共享首選項文件,那麽知道文件標識符的任何其他應用都可以訪問您的數據。
寫入共享首選項
要寫入共享首選項文件,請通過對您的 SharedPreferences
調用 edit()
來創建一個 SharedPreferences.Editor
。
傳遞您想要使用諸如 putInt()
和 putString()
方法寫入的鍵和值。然後,調用 commit()
以保存所做的更改。例如:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE); SharedPreferences.Editor editor = sharedPref.edit(); editor.putInt(getString(R.string.saved_high_score), newHighScore); editor.commit();
從共享首選項讀取信息
要從共享首選項文件中檢索值,請調用諸如 getInt()
和 getString()
等方法,為您想要的值提供鍵,並根據需要提供要在鍵不存在的情況下返回的默認值。例如:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE); int defaultValue = getResources().getInteger(R.string.saved_high_score_default); long highScore = sharedPref.getInt(getString(R.string.saved_high_score), defaultValue);
5.1 保存鍵值集