SharedPreferencesBackupHelper

public class SharedPreferencesBackupHelper
extends Object implements BackupHelper

这可以结合使用一个辅助类BackupAgentHelper管理的备份SharedPreferences 。 无论何时执行备份，它都会备份自上次备份操作以来发生更改的所有命名共享首选项。

要使用这个类，应用程序的备份代理类应该扩展BackupAgentHelper 。 然后，在代理的onCreate()方法中，应该在BackupAgentHelper框架内分配和安装该类的一个实例作为备份/恢复处理程序。 例如，支持具有两组SharedPreferences数据的应用程序的备份和恢复的代理可能如下所示：

 import android.app.backup.BackupAgentHelper;
 import android.app.backup.SharedPreferencesBackupHelper;

 public class MyBackupAgent extends BackupAgentHelper {
     // The names of the SharedPreferences groups that the application maintains.  These
     // are the same strings that are passed to getSharedPreferences(String, int).
     static final String PREFS_DISPLAY = "displayprefs";
     static final String PREFS_SCORES = "highscores";

     // An arbitrary string used within the BackupAgentHelper implementation to
     // identify the SharedPreferenceBackupHelper's data.
     static final String MY_PREFS_BACKUP_KEY = "myprefs";

     // Simply allocate a helper and install it
     void onCreate() {
         SharedPreferencesBackupHelper helper =
                 new SharedPreferencesBackupHelper(this, PREFS_DISPLAY, PREFS_SCORES);
         addHelper(MY_PREFS_BACKUP_KEY, helper);
     }
 }

不需要进一步的实施; BackupAgentHelper机制会根据情况自动将BackupAgent.onBackup()和BackupAgent.onRestore()回调分派给SharedPreferencesBackupHelper。

Summary

Inherited methods
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为此对象调用方法 notify()或方法 notifyAll() ，或其他某个线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface android.app.backup.BackupHelper abstract void performBackup(ParcelFileDescriptor oldState, BackupDataOutput data, ParcelFileDescriptor newState) 基于 oldState ，确定需要备份什么应用程序内容，将其写入 data ，并填写完整状态（现在存在）的 newState 。 abstract void restoreEntity(BackupDataInputStream data) 由 BackupAgentHelper调用以从还原数据集中还原单个实体。 abstract void writeNewStateDescription(ParcelFileDescriptor newState) 在恢复操作之后由 BackupAgentHelper调用以写入由助手处理的与数据相对应的备份状态文件。

Public constructors

SharedPreferencesBackupHelper (Context context, 
                String... prefGroups)

Public methods

void performBackup (ParcelFileDescriptor oldState, 
                BackupDataOutput data, 
                ParcelFileDescriptor newState)

void restoreEntity (BackupDataInputStream data)

void writeNewStateDescription (ParcelFileDescriptor fd)

Protected methods

void finalize ()