安卓训练-开始-保存数据-保存键值对集合

保存键值对集合

上一课

下一课

这节课教你

取得一个 SharedPreferences 的句柄（Handle）
写入共享首选项
读取共享首选项

你还需要阅读

使用共享首选项

如果你有一个比较小的键值对集合需要保存，你应该使用

SharedPreferences

API。一个

SharedPreferences

对象指向一个包含键值对的文件并提供简单的方法读写键值对。每个

SharedPreferences

文件都由框架管理，它可以是私有的或共享的。

这节课教你怎样使用

SharedPreferences

API 存储和检索简单的值。

注意：

SharedPreferences

API 只用于读写键值对，你不应该把它们与

Preference

API 混淆，Preference API 帮助你为应用的设置构建用户界面（尽管它们使用

SharedPreferences

作为它们的实现来保存应用设置）。关于使用

Preference

API 的信息，参见设置指南。

取得一个 SharedPreferences 的句柄（Handle）

你可以调用下面两个方法中的一个，创建一个新的共享首选项文件或使用一个已存在的文件：

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

上一课下一课