[ Android 五种数据存储方式之一 ] —— SharedPreferences存储数据

SharedPreferences类，它是一个轻量级的存储类，特别适合用于保存软件配置参数。

主要是保存一些常用的配置比如窗口状态，一般在Activity中 重载窗口状态onSaveInstanceState保存一般使用SharedPreferences完成，它提供了Android平台常规的Long长 整形、Int整形、String字符串型的保存。

SharedPreferences保存数据，其背后是用xml文件存放数据，文件存放在/data/data/<package name>/shared_prefs目录下：

分析以下几个方法：

Android中得到SharedPreference的方式有四种：

• ContextWrapper.getSharedPreferences(String name, int mode)
• Activity.getPreferences(int mode)
• PreferenceManager.getSharedPreferences()
• PreferenceManager.getDefaultSharedPreferences(Context context)

下面我们一起来跟踪下它们的源码：
1.ContextWrapper.getSharedPreferences(String name,int mode)
 
可以看出，我们可以自己设置SharedPreference的名字与模式

一、getSharedPreferences(name,mode)

方法的第一个参数用于指定该文件的名称，名称不用带后缀，后缀会由Android自动加上；

方法的第二个参数指定文件的操作模式，共有四种操作模式。

四种操作模式分别为：

1. MODE_APPEND: 追加方式存储

2. MODE_PRIVATE: 私有方式存储,其他应用无法访问

3. MODE_WORLD_READABLE: 表示当前文件可以被其他应用读取

4. MODE_WORLD_WRITEABLE: 表示当前文件可以被其他应用写入

二、edit()方法获取editor对象

Editor editor = sharedPreferences.edit();

editor存储对象采用key-value键值对进行存放，editor.putString("name", "wujaycode");

通过commit()方法提交数据

与之对应的获取数据的方法：

SharedPreferences share=getSharedPreferences("Acitivity",Activity.MODE_WORLD_READABLE);

int i=share.getInt("i",0);

String str=share.getString("str","");

boolean flag=share.getBoolean("flag",false);

getString()第二个参数为缺省值，如果preference中不存在该key，将返回缺省值

如果你想要删除通过SharedPreferences产生的文件，可以通过以下方法：

File file= new File("/data/data/"+getPackageName().toString()+"/shared_prefs","Activity.xml");

if(file.exists()){

file.delete();

Toast.makeText(TestActivity.this, "删除成功", Toast.LENGTH_LONG).show(); }

三、访问其他应用中的Preference

如果要访问其他应用中的Preference，必须满足的条件是，要访问的应用的Preference创建时指定了Context.MODE_WORLD_READABLE或者Context.MODE_WORLD_WRITEABLE权限。

举例，假如有个<package name>为com.wujay.action下面的应用使用了下面语句创建了Preference，getSharedPreferences("wujay", Context.MODE_WORLD_READABLE),

现在要访问该Preferences:

首先，需要创建上面的Context,然后通过Context访问Preferences，访问preference时会在应用所在包下的shared_prefs目录找到preference：

Context otherAppsContext = createPackageContext("com.wujay.action", Context.CONTEXT_IGNORE_SECURITY);
SharedPreferences sharedPreferences = otherAppsContext.getSharedPreferences("wujay", Context.MODE_WORLD_READABLE);
String name = sharedPreferences.getString("name", "");
int age = sharedPreferences.getInt("age", 0);

如果不通过创建Context访问其他应用的preference，可以以读取xml文件方式直接访问其他应用preference对应的xml文件，如：
File xmlFile = new File(“/data/data/<package name>/shared_prefs/itcast.xml”);//<package name>应替换成应用的包名。

2.Activity.getPreferences(int mode)
 
这种方式下，name是通过getLocalClassName()得到的，不能让我们自己设置，而且最终会调到ContextWrapper的getSharedPreferences()，getLocalClassName()定义如下：

3.PreferenceManager.getSharedPreferences()
 
这种方式我们是让PreferenceManager给我们维护一个SharedPreference，当然我们可以调用PreferenceManager的API来设置name和mode，并且最终也是调用到ContextWrapper的getSharedPreferences
4.PreferenceManager.getDefaultSharedPreferences(Context context)
 
这种方式得到的SharedPreference是某个包名下共享的，并且是私有的，不能让其他的包访问，而且Name和mode不能设置。最终也会调用到ContextWrapper的getSharedPreferences

总结：

获取SharedPreferences的两种方式:

1 调用Context对象的getSharedPreferences()方法

2 调用Activity对象的getPreferences()方法

两种方式的区别:

调用Context对象的getSharedPreferences()方法获得的SharedPreferences对象可以被同一应用程序下的其他组件共享.

调用Activity对象的getPreferences()方法获得的SharedPreferences对象只能在该Activity中使用.

 

 

使用方法

１、存数据

 SharedPreferences sp = getSharedPreferences("sp_demo", Context.MODE_PRIVATE);
 sp.edit().putString("name", "小张").putInt("age", 11).commit();

或者下面的写法也可以

 SharedPreferences sp = getSharedPreferences("sp_demo", Context.MODE_PRIVATE);
 Editor editor = sp.edit();
 editor.putString("name", "小张");
 editor.putInt("age", 11);
 editor.commit();

切记不要写成下面的形式，会导致数据无法存储

 SharedPreferences sp = getSharedPreferences("sp_demo", Context.MODE_PRIVATE);
 sp.edit().putString("name", "小张");
 sp.edit().putInt("age", 11);
 sp.edit().commit();

为什么这种方式无法存储，因为sp.edit()每次都会返回一个新的Editor对象，Editor的实现类EditorImpl里面会有一个缓存的Map，最后commit的时候先将缓存里面的Map写入内存中的Map，然后将内存中的Map写进XML文件中。使用上面的方式commit，由于sp.edit()又重新返回了一个新的Editor对象，缓存中的Map是空的，所以导致数据无法被存储。

２、取数据

 SharedPreferences sp = getSharedPreferences("sp_demo", Context.MODE_PRIVATE);
 String name = sp.getString("name", null);
 int age = sp.getInt("age", 0);

getSharedPreferences的具体实现是在frameworks/base/core/java/android/app/ContextImpl.java，代码如下：

 @Override
 public SharedPreferences getSharedPreferences(String name, int mode) {
     SharedPreferencesImpl sp;
     synchronized (ContextImpl.class) {
         ......
         final String packageName = getPackageName();
         ArrayMap<String, SharedPreferencesImpl> packagePrefs = sSharedPrefs.get(packageName);
         if (packagePrefs == null) {
             packagePrefs = new ArrayMap<String, SharedPreferencesImpl>();
             sSharedPrefs.put(packageName, packagePrefs);
         }

         ......
         sp = packagePrefs.get(name);
         if (sp == null) {
             File prefsFile = getSharedPrefsFile(name);
             sp = new SharedPreferencesImpl(prefsFile, mode);
             packagePrefs.put(name, sp);
             return sp;
         }
     }
     ......
     return sp;
 }

SharedPreferencesImpl是SharedPreferences接口的具体实现类，一个name对应一个SharedPreferencesImpl，一个应用程序中根据name的不同会有多个SharedPreferencesImpl。 
SharedPreferencesImpl的具体实现是在frameworks/base/core/java/android/app/SharedPreferencesImpl.java，我们可以通过getSharedPreferences获得

SharedPreferences sharedPreferences = getSharedPreferences("ljq", Context.MODE_PRIVATE);

//getString()第二个参数为缺省值，如果preference中不存在该key，将返回缺省值

String name = sharedPreferences.getString("name", "");

int age = sharedPreferences.getInt("age", 1);

如果访问其他应用中的Preference，前提条件是：该preference创建时指定了Context.MODE_WORLD_READABLE或者Context.MODE_WORLD_WRITEABLE权限。

如：有个<package name>为com.ljq.action的应用使用下面语句创建了preference。

getSharedPreferences("ljq", Context.MODE_WORLD_READABLE);

其他应用要访问上面应用的preference，首先需要创建上面应用的Context，然后通过Context 访问preference ，访问preference时会在应用所在包下的shared_prefs目录找到preference ：

Context otherAppsContext = createPackageContext("com.ljq.action", Context.CONTEXT_IGNORE_SECURITY);

SharedPreferences sharedPreferences = otherAppsContext.getSharedPreferences("ljq", Context.MODE_WORLD_READABLE);

String name = sharedPreferences.getString("name", "");

int age = sharedPreferences.getInt("age", 0);

如果不通过创建Context访问其他应用的preference，也可以以读取xml文件方式直接访问其他应用preference对应的xml文件，如：

File xmlFile = new File("/data/data/<package name>/shared_prefs/itcast.xml");//<package name>应替换成应用的包名

案例：

string.xml文件

 <?xml version="1.0" encoding="utf-8"?>
 <resources>
     <string name="hello">Hello World, SpActivity!</string>
     <string name="app_name">软件配置参数</string>
     <string name="name">姓名</string>
     <string name="age">年龄</string>
     <string name="button">保存设置</string>
     <string name="showButton">显示</string>
 </resources>

main.xml布局文件

 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:orientation="vertical"
     android:layout_width="fill_parent"
     android:layout_height="fill_parent">
     <RelativeLayout
         xmlns:android="http://schemas.android.com/apk/res/android"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content">
         <TextView android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="@string/name"
             android:textSize="20px"
             android:id="@+id/nameLable" />
         <EditText android:layout_width="80px"
             android:layout_height="wrap_content"
             android:layout_toRightOf="@id/nameLable"
             android:layout_alignTop="@id/nameLable"
             android:layout_marginLeft="10px"
             android:id="@+id/name" />
     </RelativeLayout>
     <RelativeLayout
         xmlns:android="http://schemas.android.com/apk/res/android"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content">
         <TextView android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:textSize="20px"
             android:text="@string/age"
             android:id="@+id/ageLable" />
         <EditText android:layout_width="80px"
             android:layout_height="wrap_content"
             android:layout_toRightOf="@id/ageLable"
             android:layout_alignTop="@id/ageLable"
             android:layout_marginLeft="10px"
             android:id="@+id/age" />
     </RelativeLayout>
     <RelativeLayout
         xmlns:android="http://schemas.android.com/apk/res/android"
         android:layout_width="wrap_content"
         android:layout_height="wrap_content">
         <Button android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="@string/button"
             android:id="@+id/button" />
         <Button android:layout_width="wrap_content"
             android:layout_height="wrap_content"
             android:text="@string/showButton"
             android:layout_toRightOf="@id/button"
             android:layout_alignTop="@id/button"
             android:id="@+id/showButton" />
     </RelativeLayout>
     <TextView android:layout_width="fill_parent"
             android:layout_height="wrap_content"
             android:textSize="20px"
             android:id="@+id/showText" />
 </LinearLayout>

 package com.ljq.activity;

 import android.app.Activity;
 import android.content.Context;
 import android.content.SharedPreferences;
 import android.content.SharedPreferences.Editor;
 import android.os.Bundle;
 import android.view.View;
 import android.widget.Button;
 import android.widget.EditText;
 import android.widget.TextView;
 import android.widget.Toast;

 public class SpActivity extends Activity {
     private EditText nameText;
     private EditText ageText;
     private TextView resultText;
     @Override
     public void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         setContentView(R.layout.main);

         nameText = (EditText)this.findViewById(R.id.name);
         ageText = (EditText)this.findViewById(R.id.age);
         resultText = (TextView)this.findViewById(R.id.showText);

         Button button = (Button)this.findViewById(R.id.button);
         Button showButton = (Button)this.findViewById(R.id.showButton);
         button.setOnClickListener(listener);
         showButton.setOnClickListener(listener);

         // 回显
         SharedPreferences sharedPreferences=getSharedPreferences("ljq123",
                 Context.MODE_WORLD_READABLE+Context.MODE_WORLD_WRITEABLE);
         String nameValue = sharedPreferences.getString("name", "");
         int ageValue = sharedPreferences.getInt("age", 1);
         nameText.setText(nameValue);
         ageText.setText(String.valueOf(ageValue));
     }

     private View.OnClickListener listener = new View.OnClickListener(){
         public void onClick(View v) {
             Button button = (Button)v;
             //ljq123文件存放在/data/data/<package name>/shared_prefs目录下
             SharedPreferences sharedPreferences=getSharedPreferences("ljq123",
                     Context.MODE_WORLD_READABLE+Context.MODE_WORLD_WRITEABLE);
             switch (button.getId()) {
             case R.id.button:
                 String name = nameText.getText().toString();
                 int age = Integer.parseInt(ageText.getText().toString());
                 Editor editor = sharedPreferences.edit(); //获取编辑器
                 editor.putString("name", name);
                 editor.putInt("age", age);
                 editor.commit();//提交修改
                 Toast.makeText(SpActivity.this, "保存成功", Toast.LENGTH_LONG).show();
                 break;
             case R.id.showButton:
                 String nameValue = sharedPreferences.getString("name", "");
                 int ageValue = sharedPreferences.getInt("age", 1);
                 resultText.setText("姓名：" + nameValue + "，年龄：" + ageValue);
                 break;
             }
         }
     };
 }

运行结果

如何访问其他应用中的Preference？

 package com.ljq.sp;

 import java.io.File;
 import java.io.FileInputStream;

 import android.content.Context;
 import android.content.SharedPreferences;
 import android.test.AndroidTestCase;
 import android.util.Log;

 public class AccessSharePreferenceTest extends AndroidTestCase{
     private static final String TAG = "AccessSharePreferenceTest";

     /**
      * 访问SharePreference的方式一，注：权限要足够
      * @throws Exception
      */
     public void testAccessPreference() throws Exception{
         String path = "/data/data/com.ljq.activity/shared_prefs/ljq123.xml";
         File file = new File(path);
         FileInputStream inputStream = new FileInputStream(file);
         //获取的是一个xml字符串
         String data = new FileService().read(inputStream);
         Log.i(TAG, data);
     }

     /**
      * 访问SharePreference的方式二，注：权限要足够
      * @throws Exception
      */
     public void testAccessPreference2() throws Exception{
         Context context = this.getContext().createPackageContext("com.ljq.activity",
                 Context.CONTEXT_IGNORE_SECURITY);
         SharedPreferences sharedPreferences = context.getSharedPreferences("ljq123",
                 Context.MODE_WORLD_READABLE+Context.MODE_WORLD_WRITEABLE);
         String name = sharedPreferences.getString("name", "");
         int age = sharedPreferences.getInt("age", 1);
         Log.i(TAG, name + " : " +age);
     }
 }