Android学习路线（二十七）键值对（SharedPreferences）存储

如果你又一个相对较小的键值对数据想要保存，你应该使用SharedPreferences APIs。一个SharedPreferences 对象指向一个包含键值对的文件，它提供简单的方法来读写他们。每个SharedPreferences 文件系统框架管理，它们可以是私有的也可以被共享。

本课将介绍如何使用SharedPreferences APIs来存储和获取简单的数据。

提示: SharedPreferences APIs 只能被用来操作键值对类型数据，不要把它和 Preference APIs弄混淆，Preference是用来帮助用户构建app设置界面的。更多关于 Preference APIs的信息，请移步Settings 向导。

获取SharedPreferences的引用（句柄）

你可以通过下面任意一种方式创建一个新的shared preference文件或者访问一个已经存在的shared preference文件：

• getSharedPreferences() — Use this if you need multiple shared preference files identified by name, which you specify with the first parameter. You can call this from any Context in your app.
• getSharedPreferences() — 如果你通过不同的名字保存了多个shared preference文件，那么你可以使用这个方法，这个方法的第一个参数即为文件名。你可以在应用中使用Context对象来调用它。
  
• getPreferences() — 如果你只需要在这个activity中使用一个shared preference文件，那么你可以在activity中调用这个方法。因为这个方法会返回属于这个activity的一个默认的shared preference文件，你不需要为它提供一个名字。

例如，以下的方法会在  Fragment 中被执行。它在内部访问了一个shared preferences文件，这个文件被 R.string.preference_file_key 这个字符串指定，并且它是被私有模式（private mode）打开的，因此只能被你的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);

注意: 如果你使用 MODE_WORLD_READABLE 或者 MODE_WORLD_WRITEABLE模式创建了一个shared preference文件，那么任何其他知道这个文件标识的app都能够访问到你的数据。

向Shared Preferences中写入数据

---

要向shared preferences文件中写入数据，你需要调用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();

从Shared Preferences中读取数据

---

要从shared preferences文件中获取数据，可以调用getInt()或者getString()等方法，只需要提供你想要获得的值对应的key就可以了；你也可以选择再传入一个默认值，如果通过传入的key没有取道值将会返回这个默认值。例如：

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);