开发者社区> 生命壹号> 正文

Android数据存储(二)----PreferenceFragment详解

简介:
+关注继续查看

【正文】

一、PreferenceFragment的引入:

PreferenceActivity是一个非常有用的基类,当我们开发Android项目时避免不了选项设置,这些设置习惯用Preference来保存。Android专门为这种Activity提供了便捷的基类PreferenceActivity。如果继承自Preference则不需要自己控制Preference的读写,PreferenceActivity会为我们处理一切。

PreferenceActivity与普通的Activity不同,它不是使用界面布局文件,而是使用选项设置的布局文件

选项设置布局文件以PreferenceScreen作为根元素来表示定义一个参数设置界面布局。

从Android 3.0以后官方不再推荐直接让PreferenceActivity加载选项设置布局文件,而是建议使用PreferenceFragment,二者用法类似。所以今天就来学习一下。

下面的这张截图就是一个典型的例子:

我们会看到整个页面被分为几组:无线和网络、个人、账户、设备、系统。这个分组(或者叫分类)就是PreferenceCategory

Wifi右边有开关,这一项就是CheckBoxPreference;其他还有ListPreference和EditTextPreference。

你的每一次设置,都会被Preference自动保存下来,这就是setting的数据持久化。每个Preference都是以键值对的形式保存下来的

PreferenceActivity的继承关系图:(不推荐使用)

PreferenceFragment的继承关系图:(推荐使用

 

二、在XML文件中Preference的种类:

根节点中一定是<PreferenceScreen> 元素,在这个元素中可以添加不同的Preference。常见的Preference控件有:

  • 直接子类:DialogPreference, PreferenceGroup, RingtonePreference, TwoStatePreference
  • 非直接子类:CheckBoxPreference, EditTextPreferenceListPreference, MultiSelectListPreference, PreferenceCategory, PreferenceScreen, SwitchPreference

我们还是通过实际的例子来实现吧。 

【实例】

先新建一个工程文件:

新建类PrefFragment.java,让其继承PreferenceFragment,并加载选项设置的布局文件:(核心代码是第6行和13行)

复制代码
 1 package com.example.m05_preffragment01;
 2 
 3 import android.os.Bundle;
 4 import android.preference.PreferenceFragment;
 5 
 6 public class PrefFragment extends PreferenceFragment {
 7     @Override
 8     public void onCreate(Bundle savedInstanceState) {
 9         // TODO Auto-generated method stub
10         super.onCreate(savedInstanceState);
11         
12         //从xml文件加载选项 
13         addPreferencesFromResource(R.xml.preferences);
14     }
15 }
复制代码

然后,在MainActivity.java中加载上面的Fragment:

复制代码
 1 package com.example.m05_preffragment01;
 2 
 3 import android.app.Activity;
 4 import android.app.FragmentManager;
 5 import android.app.FragmentTransaction;
 6 import android.os.Bundle;
 7 
 8 public class MainActivity extends Activity {
 9 
10     @Override
11     protected void onCreate(Bundle savedInstanceState) {
12         super.onCreate(savedInstanceState);
13         setContentView(R.layout.activity_main);
14         
15         //加载PrefFragment
16         FragmentManager fragmentManager = getFragmentManager();
17         FragmentTransaction transaction = fragmentManager.beginTransaction();
18         PrefFragment prefFragment = new PrefFragment();
19         transaction.add(R.id.prefFragment, prefFragment);
20         transaction.commit();
21         
22     }
23     
24 }
复制代码

接下来的知识就是重头戏了,既然PrefFragment要加载选项设置的布局文件R.xml.preferences,那我们就来定义一下这个preferences.xml

在res目录下新建立一个xml目录,在该目录中新建文件preferences.xml:

关于preferences.xml的文件里面的代码,请看下面这一段。

 

五、preference详解:

1、<PreferenceCategory>的方式进行分组

preferences.xml举例如下:

复制代码
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" >
    
    <!-- 设置的类别 -->
    <PreferenceCategory 
        android:key="mylocation"
        android:summary="我的位置"
        android:title="我的位置源">              
        <CheckBoxPreference 
            android:key="wireless_network"
            android:summary="使用无线网络查看应用程序中的位置"
            android:title="使用无线网络"/>          
    </PreferenceCategory>
    
    <PreferenceCategory 
        android:key="mymsg"
        android:summary="个人信息"
        android:title="个人信息">              
        <EditTextPreference 
            android:key="myname"
            android:title="请输入真实姓名"
            android:summary="姓名"/>          
    </PreferenceCategory>    
    
</PreferenceScreen>
复制代码

上方代码中,一个<PreferenceCategory>就是一个类别,单个的<PreferenceCategory>可以放入任意的Preference控件。我们在第一个类别中放入了CheckBoxPreference控件,在第二个类别中放入了EditTextPreference控件。运行效果如下:

运行时候,会自动在/data/data/<packagename>/shared_prefs/目录生成一个文本文件:

注:这个文本的文件名太长了,我们可以在上方PrefFragment.java的第13行代码后面加上这样一句话来修改文件名:(这里我将文件名修改为:mysetting)

getPreferenceManager().setSharedPreferencesName("mysetting");

文本内容如下:

我们现在在CheckBoxPreference中打钩,然后在EditTextPreference中输入内容:

文本内容显示如下:

 

2、显示子屏幕subscreens方式的进行分组:

复制代码
 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android"
 3     android:title="Settings" >
 4 
 5     <PreferenceScreen
 6         xmlns:android="http://schemas.android.com/apk/res/android"
 7         android:summary="settings about emotions"
 8         android:title="Emotions" >
 9         <CheckBoxPreference
10             android:defaultValue="true"
11             android:summaryOff="No,I am sorry."
12             android:summaryOn="Yes,I love you!"
13             android:title="Love me?" >
14         </CheckBoxPreference>
15         <CheckBoxPreference
16             android:defaultValue="false"
17             android:summaryOff="No,you are a good person."
18             android:summaryOn="Yes,I hate you!"
19             android:title="Hate me?" >
20         </CheckBoxPreference>
21     </PreferenceScreen>
22     
23     <PreferenceScreen
24         xmlns:android="http://schemas.android.com/apk/res/android"
25         android:summary="settings about relations"
26         android:title="Relations" >
27         <CheckBoxPreference
28             android:defaultValue="true"
29             android:summaryOff="No,I am sorry."
30             android:summaryOn="Yes,we are family!"
31             android:title="Family?" >
32         </CheckBoxPreference>
33         <CheckBoxPreference
34             android:defaultValue="false"
35             android:summaryOff="No,I am sorry."
36             android:summaryOn="Yes,we are friends!"
37             android:title="Friends?" >
38         </CheckBoxPreference>
39     </PreferenceScreen>
40 
41 </PreferenceScreen>
复制代码

运行效果如下:

点击上方第一个preference,进入下图中左侧界面;点击上方第二个preference,进入下图中右侧界面。效果如下:

 

3、ListPreference控件:

点击该控件后,将列出一个单选按钮的列表。用法如下:

复制代码
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" >
    
    <PreferenceCategory 
        android:key="mylocation"
        android:summary="我的位置"
        android:title="我的位置源">    
        <ListPreference 
            android:key="mycities"
            android:title="所属城市"
            android:summary="点击弹出城市列表"
            android:dialogTitle="请选择城市"
            android:entries="@array/cities"
            android:entryValues="@array/cities"/>
    </PreferenceCategory>
    
</PreferenceScreen>
复制代码

上方代码中,PreferenceScreen为根标签,ListPreference为子标签。ListPreference的常见属性如下:

  • android:key 唯一标识符,和android:id相类似,PreferenceManager可以以其为参数通过findPreference获取指定的preference 。 注意,这个android:key的值也是Preference文件里面的XML“键”名
  • android:title 大标题
  • android:summary 标题下面的小字(这个要作为选项卡才有)
  • android:entries 弹出的对话框中,列表显示的文本内容,注意哦,这里指定的是一个数组。
  • android:entryValues 与android:entries相对应的值
  • android:defaultValue 当对应值不存在时的默认值
  • android:dialogTitle 弹出的对话框中的标题信息

关于android:entriesandroid:entryValues的区别,要强调一下:

  • android:entries:The human-readable array to present as a list. 是展现给用户的列表的值。
  • android:entryValues :he array to find the value to save for a preference when an entry from entries is selected. 展现的用户的选择列表的每个元素选择后,需要存储到手机中,这里的entryValues就是列表中各个元素被选择后存储到手机中的值(通过sharedPreferences保存在/data/data/<packagename>/shared_prefs/目录下)。简单的说就是此处是数据库中的值。上面的android:entries是展现给用户的列表的值。

我们在上方代码中的第13、14行引用了数据,紧接着我们要在values目录下的strings.xml文件中定义这个被引用的城市列表(即数据来源):

复制代码
 1 <?xml version="1.0" encoding="utf-8"?>
 2 <resources>
 3 
 4     <string name="app_name">m05_PrefFragment01</string>
 5     <string name="action_settings">Settings</string>
 6     <string name="hello_world">Hello world!</string>
 7 
 8     <string-array name="cities">
 9         <item>成都</item>
10         <item>重庆</item>
11         <item>黄冈</item>
12     </string-array>
13 
14 </resources>
复制代码

上方代码中,8至12行:即加粗部分,是我添加的数据源。

运行程序效果如下:

 

六、监听事件onPreferenceTreeClick()方法:

public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen Preference preference) 

当任何一个preference控件被点击,都将触发该方法。但是可以通过preference.getKey()这个方法找到具体是哪个preference被点击了,因为每个preference的key都是唯一的

【实例】

现将preferences.xml这个设置选项的布局文件,定义如下:

复制代码
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android" >

    <!-- 设置的类别 -->
    <PreferenceCategory
        android:key="mylocation"
        android:summary="我的位置"
        android:title="我的位置源" >
        <CheckBoxPreference
            android:key="wireless_network"
            android:summary="使用无线网络查看应用程序(例如Google地图)中的位置"
            android:title="使用无线网络" />
        <CheckBoxPreference
            android:key="gps_satellite_setting"
            android:summary="定位时,精确到街道级别(取消选择可节约电量)"
            android:title="启用GPS卫星设置" />
    </PreferenceCategory>
    
    <PreferenceCategory
        android:key="mymessage"
        android:summary="个人信息设置"
        android:title="个人信息设置" >
        <CheckBoxPreference
            android:key="yesno_save_individual_info"
            android:title="是否保存个人信息" />
        <EditTextPreference
            android:key="individual_name"
            android:summary="请输入真实姓名"
            android:title="姓名 " />
        <ListPreference
            android:entries="@array/cities"
            android:entryValues="@array/cities"
            android:key="mycity"
            android:summary="所属城市"
            android:title="所属城市" />
    </PreferenceCategory>

</PreferenceScreen>
复制代码

运行效果如下:

现在我们需要做的是,选中上方红框中的CheckBoxPreference,对应下面的EditTextPreference为编辑状态;否则,如果CheckBoxPreference没有被选中,则EditTextPreference为不可编辑状态。修改PrefFragment.java的代码,其完整版代码如下:

复制代码
 1 package com.example.m05_preffragment01;
 2 
 3 import android.os.Bundle;
 4 import android.preference.CheckBoxPreference;
 5 import android.preference.EditTextPreference;
 6 import android.preference.Preference;
 7 import android.preference.PreferenceFragment;
 8 import android.preference.PreferenceScreen;
 9 
10 public class PrefFragment extends PreferenceFragment {
11 
12     @Override
13     public void onCreate(Bundle savedInstanceState) {
14         // TODO Auto-generated method stub
15         super.onCreate(savedInstanceState);
16         
17         //从xml文件加载选项 
18         addPreferencesFromResource(R.xml.preferences);
19     }
20     
21     @Override
22     public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen,
23             Preference preference) {
24         //如果“保存个人信息”这个按钮被选中,将进行括号里面的操作
25         if("yesno_save_individual_info".equals(preference.getKey())) {            
26             CheckBoxPreference checkBoxPreference = (CheckBoxPreference)findPreference("yesno_save_individual_info");
27             EditTextPreference editTextPreference = (EditTextPreference)findPreference("individual_name");
28             //让editTextPreference和checkBoxPreference的状态保持一致
29             editTextPreference.setEnabled(checkBoxPreference.isChecked());
30         }
31         // TODO Auto-generated method stub
32         return super.onPreferenceTreeClick(preferenceScreen, preference);
33     }
34 }
复制代码

代码解释:

当任何一个preference控件被点击,都将触发onPreferenceTreeClick()方法(22行),但是可以通过preference.getKey()这个方法找到具体是哪个preference被点击(25行)。

26行、27行:通过public Preference findPreference(CharSequence key)找到对应的preference,然后强转为它的子类。

29行:核心代码,让editTextPreference和checkBoxPreference的状态保持一致。

运行效果如下:

这样,我们的功能就实现了。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Android网络与数据存储——网络编程数据处理(网络请求解析Json,解析xml)
Android网络与数据存储——网络编程数据处理(网络请求解析Json,解析xml)
46 0
android中数据存储的contentprovider的使用方法
android中数据存储的contentprovider的使用方法
47 0
【Android】6.0SharedPreferences简单数据存储
如果您有想要保存的相对较小键值对集合,则应使用 SharedPreferences API。SharedPreferences 对象指向包含键值对的文件,并提供读写这些键值对的简单方法。每个 SharedPreferences 文件均由框架进行管理,可以是私有文件,也可以是共享文件。 例如:我们登录qq并不是每次都会要输入账号密码,而是会记住密码和用户的登录状态,这些轻量的数据可以通过SharedPreferences以键值对的方式存储在本地
30 0
Android数据存储
在Android开发中,数据存储的方式有五种
54 0
Android 数据存储(四)-Room
一、概述 1.1 描述 上文介绍到了SQLite Api,今天咱们介绍一下 Room ( Android Jetpack 重要成员之一 )。 Room 持久性库在 SQLite 之上提供了一个抽象层,以允许流畅的数据库访问,同时利用 SQLite 的全部功能。特别是,Room 提供以下好处: SQL 查询的编译时验证。 方便的注释,最大限度地减少重复和容易出错的样板代码。 简化的数据库迁移路径。 由于这些考虑,我们强烈建议您使用 Room 而不是直接使用 SQLite API。
130 0
Android 数据存储(二)-SP VS DataStore VS MMKV
一、SharedPreferences 不同于文件的存储方式,如果要保存的键值集合相对较小,则应使用SharedReferences API。SharedReferences对象指向一个包含键值对的文件,并提供简单的读写方法。 本文从SharedReferences开始逐步引入Preference、MMKV。
478 0
Android 数据存储(一)-文件存储
一、数据存储概念 Android系统提供了提供了多种保存应用数据的选项: 文件存储: 应用程序专属文件存储: 内部存储(保存其他应用不应访问的敏感信息) 共享文件存储:存储你的应用打算与其他应用共享的文件,包括媒体、文档和其他文件。 Preferences:默认情况下,Preferences 使用 SharedPreferences 来保存值。 数据库:使用 Room 持久性库将结构化数据存储在私有数据库中。 瞬时数据:是指那些存储在内存当中,有可能会因为程序关闭或其他原因导致内存被回收而丢失的数据。
314 0
深入剖析Android中最简单的数据存储方式:SharedPreferences
深入剖析Android中最简单的数据存储方式:SharedPreferences
307 0
Android移动应用基础教程【数据存储】(2)
Android移动应用基础教程【数据存储】(2)
75 0
Android移动应用基础教程【数据存储】(1)
Android移动应用基础教程【数据存储】(1)
87 0
+关注
生命壹号
个人网站:smyhvae.com。博客园:cnblogs.com/smyhvae。微信公众号:生命团队 | vitateam
文章
问答
文章排行榜
最热
最新
相关电子书
更多
Android组件化实现
立即下载
蚂蚁聚宝Android秒级编译—— Freeline
立即下载
Android开发之多进程架构
立即下载