保存鍵值集
如果您有想要保存的相對(duì)較小鍵值集合,您應(yīng)使用 SharedPreferences API。SharedPreferences 對(duì)象指向包含鍵值對(duì)的文件并提供讀寫(xiě)這些文件的簡(jiǎn)單方法。 每個(gè) SharedPreferences 文件由框架進(jìn)行管理并且可以專用或共享。
注:SharedPreferences API 僅用于讀寫(xiě)鍵值對(duì),您不得將其與 Preference API 混淆,后者幫助您為您的應(yīng)用設(shè)置構(gòu)建用戶界面(盡管它們使用 SharedPreferences 作為其實(shí)現(xiàn)以保存應(yīng)用設(shè)置)。 有關(guān)使用 Preference API 的信息,請(qǐng)參閱設(shè)置指南。
獲取共享首選項(xiàng)的句柄
您可以通過(guò)調(diào)用以下兩種方法之一創(chuàng)建新的共享首選項(xiàng)文件或訪問(wèn)現(xiàn)有的文件:
getSharedPreferences() — 如果您需要按照您用第一個(gè)參數(shù)指定的名稱識(shí)別的多個(gè)共享首選項(xiàng)文件,請(qǐng)使用此方法。 您可以從您的應(yīng)用中的任何 Context 調(diào)用此方法。
getPreferences() — 如果您只需使用 Activity 的一個(gè)共享首選項(xiàng),請(qǐng)從 Activity 中使用此方法。 因?yàn)榇朔椒〞?huì)檢索屬于該 Activity 的默認(rèn)共享首選項(xiàng)文件,您無(wú)需提供名稱。
例如,以下代碼在 Fragment 內(nèi)執(zhí)行。
它訪問(wèn)通過(guò)資源字符串 R.string.preference_file_key 識(shí)別的共享首選項(xiàng)文件并且使用專用模式打開(kāi)它,從而僅允許您的應(yīng)用訪問(wèn)文件。
Context context = getActivity();
SharedPreferences sharedPref = context.getSharedPreferences(
getString(R.string.preference_file_key), Context.MODE_PRIVATE);
命名您的共享首選項(xiàng)文件時(shí),您應(yīng)使用對(duì)于您的應(yīng)用而言唯一可識(shí)別的名稱,比如 "com.example.myapp.PREFERENCE_FILE_KEY"
或者,如果您只需 Activity 的一個(gè)共享首選項(xiàng)文件,您可以使用 getPreferences() 方法:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);
注意:如果您創(chuàng)建帶 MODE_WORLD_READABLE 或 MODE_WORLD_WRITEABLE 的共享首選項(xiàng)文件,那么知道文件標(biāo)識(shí)符的任何其他應(yīng)用都可以訪問(wèn)您的數(shù)據(jù)。
寫(xiě)入共享首選項(xiàng)
要寫(xiě)入共享首選項(xiàng)文件,請(qǐng)通過(guò)對(duì)您的 SharedPreferences 調(diào)用 edit() 來(lái)創(chuàng)建一個(gè) SharedPreferences.Editor。
傳遞您想要使用諸如 putInt() 和 putString() 方法寫(xiě)入的鍵和值。然后,調(diào)用 commit() 以保存所做的更改。例如:
SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);
SharedPreferences.Editor editor = sharedPref.edit();
editor.putInt(getString(R.string.saved_high_score), newHighScore);
editor.commit();
從共享首選項(xiàng)讀取信息
要從共享首選項(xiàng)文件中檢索值,請(qǐng)調(diào)用諸如 getInt() 和 getString() 等方法,為您想要的值提供鍵,并根據(jù)需要提供要在鍵不存在的情況下返回的默認(rèn)值。例如:
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);