Android - 数据存储（一）之 SharedPreferences

SharedPreferences

1. SharedPreferences 是 Android 提供的一个通用的数据持久化框架，其以键值对形式来存储数据；
2. SharedPreferences 采用单例模式设计；
3. SharedPreferences 支持的数据类型为 boolean、int、float、long、String 等，不支持自定义的对象类型；
4. SharedPreferences 主要用于存储配置信息，如果想存储用户的配置信息，可以使用 PreferenceFragment 或 PreferenceActivity。

SharedPreferences 的使用

写入数据：

1. 得到 SharedPreferences 的实例（由于 SharedPreferences 是一个接口，无法直接创建实例，只能通过 Context.getSharedPreferences(String name, int mode) 方法来获取实例）；

• name：存放数据的文件名称，该文件位于 data/data/应用包名/shared_prefs 目录下；
• mode：文件的操作模式：
  • MODE_PRIVATE：默认操作模式，文件只能被应用本身访问（每次写入数据都会覆盖之前的数据）；
  • MODE_APPEND：检查文件是否存在，若存在将往文件里面追加数据，不存在则新建一个文件；
  • MODE_WORLD_READABLE：该文件能被其他应用读取；
  • MODE_WORLD_WRITEABLE：该文件能被其他应用读写，执行写操作时会覆盖原有的数据；
    注意： 从 Android 4.2 开始不推荐使用 MODE_WORLD_READABLE 和 MODE_WORLD_WRITEABLE 两种模式让其它程序来读写本应用数据，因为这容易导致安全漏洞。如需要将本应用数据提供给其它应用访问可使用 ContentProvider。

2. 得到 SharedPreferences.Editor 的实例，（由于 SharedPreferences.Editor 是一个接口，无法直接创建实例，只能通过调用 SharedPreferences 对象的 edit() 方法来获取）；
3. 使用 SharedPreferences.Editor 提供的 put 类方法来写入数据；
4. 调用 SharedPreferences.Editor 的 commit() 方法，提交数据。

读取数据：

1. 得到 SharedPreferences 的实例；
2. 通过调用 SharedPreferences 提供的get 类方法来读取数据。

实现记住密码的功能

1. 布局文件，activity_main.xml：

2. Java 代码，MainActivity.java：

public class MainActivity extends AppCompatActivity {

    private EditText et_account;
    private EditText et_password;
    private CheckBox mRemember;
    private SharedPreferences pref;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 得到 SharedPreferences 的实例
        pref = getSharedPreferences("userData", MODE_PRIVATE);

        initView();

        boolean isRememberPass = pref.getBoolean("rememberPass", false);
        if (isRememberPass) {
            // 读取数据
            // 第一个参数为需要读取的数据的键，
            // 第二个参数为默认值，当找不到对应的键时，默认使用该值
            String prefAccount = pref.getString("account", "");
            String prefPassword = pref.getString("password", "");
            et_account.setText(prefAccount);
            et_password.setText(prefPassword);
        }

    }

    /*
     * 登录
     */
    public void login(View view) {
        String account = et_account.getText().toString().trim();
        String password = et_password.getText().toString().trim();
        // 监听复选框是否被选中
        if (mRemember.isChecked()) {
            // 存储数据
            SharedPreferences.Editor editor = pref.edit(); // 得到 SharedPreferences.Editor 的实例
            // 以键值对形式存储数据
            editor.putBoolean("rememberPass", true);
            editor.putString("account", account);
            editor.putString("password", password);
            editor.commit(); // 提交数据
            Toast.makeText(MainActivity.this, "登录成功。", Toast.LENGTH_SHORT).show();
        }
        if (TextUtils.isEmpty(account) || TextUtils.isEmpty(password)){
            Toast.makeText(MainActivity.this, "登录失败，账号或密码不能为空。", Toast.LENGTH_SHORT).show();
        }else {
            Toast.makeText(MainActivity.this, "登录成功。", Toast.LENGTH_SHORT).show();
        }
    }

    /*
     * 初始化布局中的控件
     */
    private void initView() {
        et_account = (EditText) findViewById(R.id.et_account);
        et_password = (EditText) findViewById(R.id.et_password);
        mRemember = (CheckBox) findViewById(R.id.cb_remember);
    }

}

3. 效果演示：

接下来打开 DDMS，在 data/data/应用包名/shared_prefs 目录下找到 userData.xml 文件，将其导出到电脑，打开文件，可以看到里面的数据跟我们输入的数据是一样的。