注：本文翻譯自Google官方的Android Developers Training文檔，譯者技術一般，由于喜愛安卓而產生了翻譯的念頭，純屬個人興趣愛好。

原文鏈接： http://developer.android.com/training/basics/data-storage/shared-preferences.html

如果你有一些希望存儲的相對較小的鍵值對數據集，你應該使用 SharedPreferences 的APIs。一個 SharedPreferences 對象指向一個包含鍵值對的文件，同時它還提供了一些簡便的方法來支持寫和讀。每個 SharedPreferences 文件由框架管理并且可以規定是私有的還是共享的。

這節課將會介紹如何使用 SharedPreferences APIs來存儲和恢復簡單的數據。

Note：

SharedPreferences 的API只能用來讀寫鍵值對，不要將它與 Preference 的APIs搞混了，后者被用來根據你的應用設置幫助你構建一個UI（雖然他們使用 SharedPreferences 作為它們的實現來保存應用的配置）更多關于使用 Preference 的信息，閱讀： Settings 。

?

一）. 獲取一個SharedPreferences句柄

你可以通過下面方法的任意一個來創建一個新的shared preferences文件或者獲得一個已經存在的文件：

• getSharedPreferences() ：使用該方法如果你需要多個以名字作為標識的 shared preferences文件，名字是方法的第一個參數。你可以在你應用中的任何 Context 下調用這個方法。
• getPreferences() ：在一個 Activity 使用該方法如果你在這個activity中僅需要一個 shared preferences文件。因為這將獲得一個屬于該activity的默認 shared preferences文件，所以你不需要提供一個名稱。

例如，下面的代碼在一個fragment中執行。它獲得一個 shared preferences文件，該文件的名字由資源字符串“ R.string.preference_file_key ”所指定，并且使用私有模式打開，這樣這個文件就只會被你的應用所訪問：

      Context context =
      
         getActivity();

SharedPreferences sharedPref 
      
      =
      
         context.getSharedPreferences(

        getString(R.string.preference_file_key), Context.MODE_PRIVATE);
      
    

當為 shared preferences文件起名時，你應該使用一個獨有的可以識別出你的應用的名字，比如：“ com.example.myapp.PREFERENCE_FILE_KEY ”。

當然，如果你只想要在activity中使用一個 shared preferences文件，你可以使用 getPreferences() 方法：

      SharedPreferences sharedPref = getActivity().getPreferences(Context.MODE_PRIVATE);
    

Caution：

如果你通過 MODE_WORLD_READABLE 或者 MODE_WORLD_WRITEABLE 創建了一個 shared preferences文件，那么任何知道這個文件名的其他應用都可以獲取你的數據。

?

二）. 寫入SharedPreferences

為了寫入一個 shared preferences文件，通過在你的 SharedPreferences 上調用 edit() 來創建一個 SharedPreferences.Editor 。

將你希望寫入的鍵和值通過響應的方法寫入，如： putInt() 和 putString() 等。之后調用 commit() 來保存變更：

      SharedPreferences sharedPref =
      
         getActivity().getPreferences(Context.MODE_PRIVATE);

SharedPreferences.Editor editor 
      
      =
      
         sharedPref.edit();

editor.putInt(getString(R.string.saved_high_score), newHighScore);

editor.commit();
      
    

?

三）. 讀取SharedPreferences

為了從 shared preferences文件中獲取數據，調用響應的方法，比如： getInt() 和 getString() 等，提供值所對應的鍵，還有一個可選的默認值，在鍵不存在時會返回 該值：

      SharedPreferences sharedPref =
      
         getActivity().getPreferences(Context.MODE_PRIVATE);


      
      
        int
      
       defaultValue =
      
         getResources().getInteger(R.string.saved_high_score_default);


      
      
        long
      
       highScore = sharedPref.getInt(getString(R.string.saved_high_score), defaultValue);
    

【Android Developers Training】 24. 保存鍵值對