Android 中的 SharedPreferences 是使用键值对来存储数据的,存储的值支持不同的数据类型。
1 存储数据
要想使用 SharedPreferences 来存储数据,首先要获取到 SharedPreferences 对象。Android 提供了以下三种方法来得到 SharedPreferences 对象:
类名 | 方法名 | 说明 |
Context | getSharedPreferences() | 此方法接收两个参数,第一个参数指定 SharedPreferences 文件的名称,如果指定的文件不存在,就会创建一个新文件;第二个参数指定操作模式,目前只有 MODE_PRIVATE 一种模式,表示只有当前应用程序才可以对这个文件进行读写操作。其他的几种模式已被废弃。 |
Activity | getPreferences() | 此方法和上面的方法相似,但只接收一个参数(指定操作模式),使用这个方法时,会自动将当前活动的类名作为 SharedPreferences 的文件名。 |
PreferenceManager | getDefaultSharedPreferences() | 这是一个静态方法,它接收一个 Context 参数,并自动使用当前应用程序的包名作为前缀来命名 SharedPreferences 文件。 |
向 SharedPreferences 文件中存储数据,分为以下步骤:
1. 调用 SharedPreferences 对象的 edit() 方法来获取一个 SharedPreferences.Editor 对象。
2. 向 SharedPreferences.Editor 对象中添加数据,添加数据的方法与数据的类型相比,比如要添加一个布尔型数据使用 putBoolean 方法,以此类推。
3. 调用 apply() 方法提交需要添加的数据,从而完成数据存储操作 。
SharedPreferences.Editor 还有一个 commit 方法,它与 apply 方法的区别是:
比较 | commit 方法 | apply 方法 |
是否有返回值 | 返回 boolean,表示是否提交成功 | 否 |
实现方式 | 同步提交到硬件磁盘,因此在存在多个并发的提交 commit 操作时,它们会等待正在处理的 commit 真正保存到磁盘后再执行操作,所以效率不高 。 | apply 是对内容进行原子级别的提交,而后再异步提交到磁盘。如果后续还有调用 apply 函数,那么将会直接覆盖前面的内存数据,所以效率很高 。 |
布局文件:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context="net.deniro.android.sharedpreferences.MainActivity">
<Button
android:id="@+id/save_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="保存"
></Button>
</RelativeLayout>
这里放一个按钮,用于把数据存储到 SharedPreferences 文件中。
主活动类:
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
findViewById(R.id.save_data).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
SharedPreferences.Editor editor = getSharedPreferences("data", MODE_PRIVATE).edit();
editor.putString("name","deniro");
editor.putInt("age",18);
editor.putBoolean("isOK",true);
editor.apply();
}
});
}
}
这里,我们为 SharedPreferences.Editor 对象新建了 3 中不同类型的数据。
运行程序,点击按钮后,数据就保存成功 。 接下来借助 Android Device Monitor 的 File Explorer 来查看我们刚刚保存的数据(在 /data/data/<包名>/shared_prefs /目录下):
下载并打开这个 data.xml :
<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
<map>
<string name="name">deniro</string>
<boolean name="isOK" value="true" />
<int name="age" value="18" />
</map>
这些就是我们刚刚保存的数据,SharedPreferences 文件是使用 XML 格式来保存数据的。
2 获取数据
SharedPreferences 对象中提供了一系列的 get 方法用于获取存储的数据,每种 get 方法都对应了 SharedPreferences. Editor 中的一种 put 方法。这些 get 方法接收两个参数,第一个参数是键,即传入存储数据时使用的键;第二个参数是默认值,即当传入的键找不到对应的值时,就会返回这个默认值。
我们修改主界面文件,新增一个【获取】数据的按钮:
<Button
android:id="@+id/get_data"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="获取"
></Button>
修改主活动类,为这个按钮添加获取数据的逻辑:
findViewById(R.id.get_data).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
SharedPreferences pref = getSharedPreferences("data", MODE_PRIVATE);
Log.d(TAG, "姓名: " + pref.getString("name", ""));
Log.d(TAG, "年龄: " + pref.getInt("age", 16));
Log.d(TAG, "是否健康: " + pref.getBoolean("isOK", true));
}
});
重新运行程序,然后点击【获取】按钮,然后查看日志:
是不是很简单呀 O(∩_∩)O哈哈~