SharedPreferences

SharedPreferences是数据存储方案中持久化技术之一（其它还有文件存储，数据库存储等），它是一个轻量级的存储类，特别适合用于保存软件配置参数或者保存临时数据。使用 SharedPreferences保存数据，其背后是用xml文件（键值对）存放数据，，它存放在文件系统中的/data/data/package name/shared_prefs目录下。可以保存的类型有：boolean，float，int，long，String，String集合。

数据存储到SharedPreferences

获取SharedPreferences对象

首先我们需要获得SharedPreferences对象，才可以通过该对象来存储数据。获得SharedPreferences对象的方法有以下三种:

• Context类中的getSharedPreferences()方法，此方法需要两个参数：

  • 第一个参数用于指定SharedPreferences文件的名称，如果指定的不存在则会创建一个。
  • 第二个参数用于指定操作模式，主要有两种模式:MODE_PRIVATE和MODE_APPEND。
    • MODE_PRIVATE:默认操作模式，其值为0，表示只有当前的应用程序才可以对这个SharedPreferences文件进行读写。
    • MODE_APPEND:模式会检查文件是否存在，存在就往文件追加内容，否则就创建新文件。

  另外还有三个操作模式:MODE_MULTI_PROCESS(一般用于多个进程对同一个SharedPreferences文件进行读写的情况，在Api 23被废弃)，MODE_WORLD_WRITEABLE(用来控制其他应用是否有权限读写该文件，在Android 4.2被废弃)，MODE_WORLD_READABLE(用来控制其他应用是否有权限读写该文件，在Android 4.2被废弃)。如果需要跨进程管理数据，需要使用Content Provider。

    SharedPreferences pref = getActivity().
                        getSharedPreferences(
                                "android.example.com.datastorage_preferences",
                                Context.MODE_PRIVATE);

• Activity类中的getPreferences()方法，只接受一个操作模式参数，使用这个方法时回自动将当前活动的类名作为SharedPreferences的文件名。

    SharedPreferences pref = getActivity().getPreferences(Context.MODE_PRIVATE);

通过这种方法获得的SharedPreferences对象，若其它Activity想获得该SharedPreferences文件，则只能通过Context类中的getSharedPreferences()方法获取SharedPreferences对象，而且文件名必须是该SharedPreferences文件名。

• PreferenceManager类中的getDefaultSharedPreferences()方法，它接收一个context参数，并自动使用当前应用程序的包名作为前缀来命名SharedPreferences文件。

SharedPreferences.Editor editor= PreferenceManager.
                        getDefaultSharedPreferences(getActivity())

通过这种方式创建的SharedPreferences文件存放的位置不变，而xml名称为：package name_preferences.xml

向SharedPreferences文件中保存数据

获取到SharedPreferences对象以后就可以进行数据的存储操作，

1. 调用SharedPreferences对象的edit()方法来获取一个SharedPreferences.Editor（内部类）对象；
2. 通过putXXX()方法向Editor对象中添加数据；
3. 调用commit()方法提交数据，完成数据存储操作。

一般在onPause()方法中保存数据。

@Override
protected void onPause(){
   super.onPause();
   SharedPreferences sharedPreferences = getApplicationContext().getSharedPreferences("android.example.datastorage_preferences",0);
   SharedPreferences.Editor editor = sharedPreferences.edit();
   editor.putString("name","syt");
   editor.putLong("id",1);
   editor.commit();
}

从SharedPreferences中读取数据

通过SharedPreferences对象的getXXX()可以获取对应的数据，getXXX()方法接收两个参数，第一个参数是键（存数据时使用的键名），第二个参数为默认值，即当找不到对应的键时返回该值。

@Override
protected void onResume(){
  super.onResume();
  SharedPreferences sharedPreferences = getApplicationContext().getSharedPreferences("android.example.datastorage_preferences",0);
  String name = sharedPreferences.getString("name","");
  long id = sharedPreferences.getLong("id",0);
  SharedPreferences.Editor editor = sharedPreferences.edit();
  //清除SharedPreferences文件中的内容
  editor.clear();
  editor.commit();
}

效果

SharedPreferences.png

参考文献

SharedPreferences详解
SharedPreferences模式
SharedPreferences优化