SharedPreferences对象使用常规的XML文件来存储数据，这些文件存储在应用程序的数据目录内。该XML文件的结构很简单，因为它只允许存储键/值对，不过Android API还提供了非常方便的抽象，允许开发者以类型安全的方式读写数据。

创建SharedPreferences对象最简单的方式是使用PreferenceManager.getDefaultSharedPreferences()方法，它会返回应用程序默认的偏好对象。使用该方式来存储主要的偏好设置很方便，因为框架会自动管理好文件名。但是，如果应用程序有多个偏好文件，最好使用Context.getSharedPreference()方法，它允许开发者自由地命名文件。如果只是创建和Activity相关的偏好文件，可以使用Activity.getPreference()方法，它会在调用时得到Activity的名字。

PreferenceManager.getDefaultSharedPreferences()创建的偏好文件名是由包名以及后缀_preferences组成的，如com.liyuanjinglyj.code_preferences。虽然很少需要这个名字，但如果要实现文件备份代理该名字就很重要。

SharedPreferences支持的存储值的类型有int,float.long.boolean,String以及set<String>对象。键名必须是一个有效的字符串，常见的做法是使用点符号按组结构化多个键值。

例如，如果偏好文件包含用于网络配置以及用户界面设置相关的值，可以通过为每个键添加network或者ui前缀来把它们分组。通过该方式，开发者可以轻松的管理键/值对，避免命名冲突。下面的例子演示了如何通过使用前缀并在单独的Java接口文件中定义键来结构化偏好数据：

 

public interface Constants {    public static final String NETWORK_PREFIX = "network.";    public static final String UI_PREFIX = "ui.";    public static final String NETWORK_RETRY_COUNT= NETWORK_PREFIX + "retryCount";    public static final String NETWORK_CONNECTION_TIMEOUT= NETWORK_PREFIX + "connectionTimeout";    public static final String NETWORK_WIFI_ONLY= NETWORK_PREFIX + "wifiOnly";    public static final String UI_BACKGROUND_COLOR= UI_PREFIX + "backgroundColor";    public static final String UI_FOREGROUND_COLOR= UI_PREFIX + "foregroundColor";    public static final String UI_SORT_ORDER= UI_PREFIX + "sortOrder";    public static final int SORT_ORDER_NAME = 10;    public static final int SORT_ORDER_AGE = 20;    public static final int SORT_ORDER_CITY = 30;}

 

 

推荐使用上面的方法访问存储的偏好值，而不是把键名硬编码在代码中。这样做可以避免误拼写，从而减少由于拼写导致的bug。

下面的代码演示了使用之前定义的Constants类来访问偏好文件：

 

private void readUiPreferences() {    SharedPreferences preferences            = PreferenceManager.getDefaultSharedPreferences(this);    int defaultBackgroundColor = getResources().            getColor(R.color.default_background);    int backgroundColor = preferences.getInt(            Constants.UI_BACKGROUND_COLOR,defaultBackgroundColor);View view = findViewById(R.id.background_view);view.setBackgroundColor(backgroundColor);}

 

 

要修改存储在偏好文件中的值，首先需要获取Editor实例，它提供了相应的PUT方法，以及用于提交修改的方法。在Android2.3之前，通过使用commit()方法把修改同步提交到存储设备中。但在2.3版本中，Editor提供了用于异步执行写操作的apply()方法。因为要尽可能地避免在主线程执行阻塞的操纵，apply()方法比之前的commit()方法更好。这使得在主线程直接从UI操作更新SharedPreferences很安全。

 

public void doToggleWifiOnlyPreference(View view) {    SharedPreferences preferences = PreferenceManager.            getDefaultSharedPreferences(this);    boolean currentValue = preferences.            getBoolean(Constants.NETWORK_WIFI_ONLY, false);preferences.edit()            .putBoolean(Constants.NETWORK_WIFI_ONLY, !currentValue)            .apply();}

 

 

上面的代码显示了使用点击监听器来切换存储在Constants.NETWORK_WIFI_ONLY中的偏好值。如果使用之前的commit()方法，主线程可能会被阻塞，导致用户体验差。使用apply()方法就不需要担心上面的问题。

在同一个进程中，每个偏好文件都只有实例。所以即便从二个不同的组件使用相同的名字获取二个SharedPreference对象，它实际上还是共享同一个实例，所以对于一个对象的改变会立即影响到另一个对象。

为了能在偏好值被修改的时候收到通知，开发者需要注册一个监听器回调函数，每当调用apply()或者commit()方法时都会触发该监听器回调函数。最常见的例子是，在Activity中修改偏好值应该影响后台Service的行为，如下所示：

 

public class NetworkService extends IntentService        implements SharedPreferences.OnSharedPreferenceChangeListener {    public static final String TAG = "NetworkService";    private boolean mWifiOnly;    public NetworkService() {        super(TAG);}    @Overridepublic void onCreate() {        super.onCreate();SharedPreferences preferences = PreferenceManager                .getDefaultSharedPreferences(this);preferences.registerOnSharedPreferenceChangeListener(this);mWifiOnly = preferences.getBoolean(Constants.NETWORK_WIFI_ONLY,                false);}    @Overrideprotected void onHandleIntent(Intent intent) {        ConnectivityManager connectivityManager                = (ConnectivityManager)                getSystemService(CONNECTIVITY_SERVICE);NetworkInfo networkInfo                = connectivityManager.getActiveNetworkInfo();        int type = networkInfo.getType();        if (mWifiOnly && type != ConnectivityManager.TYPE_WIFI) {            Log.d(TAG, "只执行WIFI网络");            return;}        performNetworkOperation(intent);}    @Overridepublic void onSharedPreferenceChanged(SharedPreferences preferences,String key) {        if (Constants.NETWORK_WIFI_ONLY.equals(key)) {            mWifiOnly = preferences                    .getBoolean(Constants.NETWORK_WIFI_ONLY, false);            if(mWifiOnly) {                cancelNetworkOperationIfNecessary();}        }    }    @Overridepublic void onDestroy() {        super.onDestroy();SharedPreferences preferences = PreferenceManager                .getDefaultSharedPreferences(this);preferences.unregisterOnSharedPreferenceChangeListener(this);}    private void cancelNetworkOperationIfNecessary() {        // 取消网络操作。}    private void performNetworkOperation(Intent intent) {        // 连上网络操作}}

 

 

 

版权声明：本文为博主原创文章，未经博主允许不得转载。