Android-Storage-SharedPreferences

Android-Storage-SharedPreferences

只要是应用程序就会涉及数据存储。

Android 中App存储的数据（包括文件）都属于App私有，但同时也提供了 ContentProviders（数据共享），方便应用程序将私有的数据分享给其他程序使用。

数据存储方式共分为5种，分别为：

• SharedPreferences
• 内部存储（Internal Storage）
• 外部存储（External Storage）
• SQLite数据库存储
• 网络存储

其中，网络存储的本质是对网络资源的获取和访问，其内容属于网络编程内容。

此外，Android 系统框架提供了 ContentProvider 来实现各种应用程序间持久化数据的共享。

SharedPreferences

SharedPreferences 是 Android 系统提供的一个通用的数据持久化框架，用于存储和读取 key-value 类型的原始基本数据对。

目前仅支持 boolean、float、int、long 和 string 等基本类型的存储，对于自定义的复合数据类型，是无法使用 SharedPreferences 进行存储的。

SharedPreferences 主要用于存储系统的配置信息，类似.ini 文件(Windows下常用)。

例如上次登录的用户名、上次最后设置的信息等，通过保存上一次用户所做的修改或者自定义参数设定，当再次启动程序后依然保持原有设置。它是用键值对的方式存储的，方便管理写入和读取。

使用步骤：

1. 获取Preferences

每个 Activity 默认有一个 SharedPreferences 对象，获取 SharedPreferences 对象的方法有两种：

• SharedPreferences getSharedPreferences(String name, int mode)。

获取指定 name 的 SharedPreferences 对象，并获取对该 SharedPreferences 对象的读写控制权。

当应用程序中可能使用到多个 SharedPreferences 时使用该方法。

• SharedPreferences getPreferences(int mode)。

当应用程序中仅需要一个SharedPreferences对象时，使用该方法获取当前 Activity 对应的 SharedPreferences，而不需要指定 SharedPreferences 的名字。

其中，参数 mode 有 4 种取值，分别是：

• MODE_PRIVATE

  • 默认方式，只能被创建的应用程序或者与创建的应用程序具有相同用户 ID 的应用程序访问

• MODE_WORLD_READABLE

  • 允许其他应用程序对该 SharedPreferences 文件进行读操作

• MODE_WORLD_WRITEABLE

  • 允许其他应用程序对该 SharedPreferences 文件进行写操作

• MODE_MULTI_PROCESS

  • 在多进程应用程序中，当多个进程都对同一个 SharedPreferences 进行访问时，该文件的每次修改都会被重新核对

2. 获取 SharedPreferences.Editor

调用 edit() 方法获取 SharedPreferences.Editor，SharedPreferences 通过该接口对其内容进行更新。

3. 更新 SharedPreferences

通过 SharedPreferences.Editor 接口提供的 put 方法对 SharedPreferences 进行更新。

例如使用 putBoolean(String key, boolean value)、putFloat(String key, float value) 等方法将相应数据类型的数据与其 key 对应起来。

4. 提交

调用 SharedPreferences.Editor 的 commit() 方法将更新提交到 SharedPreferences 中。

使用 SharedPreferences

实例 SharedPreferencesDemo

实例 SharedPreferencesDemo 演示了 SharedPreferences 对象的使用方法。

图 1 SharedPreferencesDemo

当用户在该实例运行时，在文本框中输入电话号码和所在城市，例如 13800000000 和 beijing，单击回退按钮退出应用程序时，该应用程序将相关信息写入其对应的 SharedPreferences 中。

当用户再次启动该应用程序时，之前填写到文本框内的信息会被从 SharedPreferences 中读取并显示出来，以方便用户修改。

1. 布局文件 main.xml

放置了三个 TextView 和两个 EditText，其中两个 EditText 按照 TextView 的要求输入电话号码和城市。其代码如下：

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical">
    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="使用 Shared Preferences 存储程序信息" />
    <TextView
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:text="您的电话号码" />
    <EditText
        android:id="@+id/phone_text"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:hint="输入电话号码" />
    <EditText
        android:id="@+id/city_text"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:hint="输入城市名称" />
</LinearLayout>

2. AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="introduction.android.SharedPreferencesDemo"
    android:versionCode="1"
    android:versionName="1.0">
    <uses-sdk android:minSdkVersion="14" />
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

3. MainActivity.java

import javax.security.auth.PrivateCredentialPermission;
import android.app.Activity;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.widget.EditText;
public class MainActivity extends Activity {
    private EditText phoneText, cityText;
    private String phone, city;
    public static final String SET_INFO = "SET_Info";
    public static final String PHONE = "PHONE";
    public static final String CITY = "CITY";
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        phoneText = (EditText) findViewById(R.id.phone_text);
        cityText = (EditText) findViewById(R.id.city_text);
        /*获取Shared Preferences对象*/
        SharedPreferences setinfo = getPreferences(Activity.MODE_PRIVATE);
        /*取出保存的电话号码和地址信息*/
        phone = setinfo.getString(PHONE, "");
        city = setinfo.getString(CITY, "");
        /*将取出的信息分别放在对应的EditText中*/
        phoneText.setText(phone);
        cityText.setText(city);
    }
    @Override
    protected void onStop() {
        SharedPreferences setinfo = getPreferences(Activity.MODE_PRIVATE);
        setinfo.edit()
                .putString(PHONE, phoneText.getText().toString())
                .putString(CITY, cityText.getText().toString())
                .commit();
        super.onStop();
    }
}

该 Activity 启动时通过 onCreate() 从其 SharedPreferences 中获取相应数据，

在 onStop() 方法中将相应数据写入 SharedPreferences 中，

其中：SharedPreferences setinfo = getPreferences(Activity.MODE_PRIVATE);

用于获取当前 Activity 默认的 SharedPreferences 对象，该对象没有名字。

当然，也可以通过 getSharedPreferences(String name, int mode) 方法来创建并获取一个带有名字的 SharedPreferences。

该 SharedPreferences 被创建后，可以在应用程序的包路径下，即 data/data//shared_prefs 文件夹下找到该文件。