学习本教程的前置条件：


  • Android 1.6 (API Level 4) 或者更高
  • 熟悉Map键值对集合
  • 数字Java文件IO的API
  • 熟悉SQL数据库


大多数Android应用需要存储数据，即使只是在onPause()期间存储有关应用的状态信息，以便用户的操作进度不会丢失掉。


即使是最非凡的应用也需要存储用户设置，而某些应用则必须在文件和数据库中管理大量的信息。


本课程向你介绍向你介绍在Android中存储数据的主要选择，包括:


  • 在一个共享的首选项文件中保存简单数据类型的键值对
  • 在Android的文件系统中保存任意文件
  • 使用有SQLite管理的数据库


保存键值对

如果你有一小撮键值对想要保存，你就应该使用SharedPreferences API. SharedPreferences对象指向一个包含键值对的文件，并且提供读写这些键值对的简单方法。

每一个SharedPreferences文件由框架来进行管理，并且可以是私有的或者是共享的。

这里向你展示如何使用SharedPreferences API来存储和获取简单的值。

注意：SharedPreferences API只用于读写键值对，而你不应该将它们同Preference API混淆，后者帮助你为你的应用设置构建用户界面（尽管它们使用了SharedPreferences作为它们保存应用设置的实现）。有关Preference的信息，见Settings指南。



得到一个处理SharedPreferences的Handle

通过调用下面两种方法之一，你可以创建一个新的，或者是访问一个已经存在的共享首选项文件：

  • getSharedPreferences() — 如果你需要多个由名称标示的共享首选项文件，就可以使用这个方法. 你可以从任何你的应用中的Context处调用这个方法.
  • getPreferences() — 如果你只需要一个用于activity的共享首选项，就可以使用这个方法. 因为这个方法会获取属于这个activity的共享首选项文件, 你没必要再给这个文件指定一个名称.


例如，下面的代码会在一个Fragment中被执行。它会访问有资源字符串 R.string.preference_file_key标识共享首选项文件, 并且使用私有模式打开它，那样这个文件就只能被你的应用所访问了.

Context context = getActivity();
SharedPreferences sharedPref = context.getSharedPreferences(
        getString(R.string.preference_file_key), Context.MODE_PRIVATE);
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);
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();
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);
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);