深入探索Migrate框架：从接口对接至设备部署的全流程解析

### 深入探索 Migrate 框架：从接口对接至设备部署的全流程解析 #### 1. Migrate 框架基础要素 在使用 Migrate 框架时，有几个关键要素需要了解。首先是列名的定义，如下代码展示了一些常见列名的定义： ```java private Columns() {} public static final String FIRSTNAME = "firstname"; public static final String LASTNAME = "lastname"; public static final String EMAIL = "email"; public static final String PHONE_NUMBER = "phoneNumber"; ``` 此外，文件开头还定义了一个模式 ID（schema ID），这个 ID 用于告知 Migrate 应用程序希望使用其管理的众多数据存储中的哪一个。 合同中存在两个 URI： - **模式 URI（schema URI）**：用于元表（metatable），元表包含了 Migrate 管理的数据集的相关信息。应用程序可通过模式 ID 识别的元表行来发现其打算使用的数据集的状态。 - **对象 URI（object URI）**：用于实际的联系人数据，其权限部分同样属于 Migrate，它所标识的虚拟表将包含联系人数据。 此时，Migrate 框架已完全集成到 MigrateContacts 项目中，接下来只需编写使用它的代码。 #### 2. 与 Migrate REST 代理接口对接 MigrateContacts 项目的大部分代码直接取自其前身 restfulCachingProviderContacts。不过，有一半的类和超过一半的代码未被复制到新项目中，而是被 Migrate 框架所取代，仅保留了应用程序的 UI 组件。 在 migrate - client 源仓库中有一个新类 SchemaManager，它取代了应用程序早期版本中的整个数据和服务部分。下面详细分析其工作原理。 客户端应用程序面临的主要问题与 SQLiteOpenHelper 解决的初始化问题类似。新安装在设备上的应用程序在首次使用 SQLite 数据库之前必须对其进行初始化，这通过从 SQLiteOpenHelper 的子类请求打开的数据库实例来实现。当多次调用 getWritableDatabase 时，除第一次外，SQLiteOpenHelper 会直接返回缓存的打开数据库；第一次调用时，若数据库不存在或需要更新，它会进行创建或更新操作。 同样，Migrate 内容提供者在首次遇到某个模式时，必须先对其副本进行初始化，才能向客户端提供该模式的数据。这种初始化并非对模式数据的请求，而是一个元请求，要求 Migrate 初始化该模式。 使用 Migrate 框架时，获取游标和初始化框架这两个过程会结合起来：首先使用一个加载器初始化 Migrate 框架，然后使用另一个加载器查询所需数据。 以下是 SchemaManager 类的代码： ```java public class SchemaManager extends ContentObserver implements LoaderManager.LoaderCallbacks<Cursor> { public static interface SchemaLoaderListener { void onSchemaLoaded(); } private static boolean ready; private final int loaderId = new Random().nextInt(); private final Uri uri; private final String user; private final String schema; final Activity ctxt; final SchemaLoaderListener listener; public SchemaManager( Activity ctxt, String schema, Uri uri, String user, SchemaLoaderListener listener) { super(new Handler()); this.ctxt = ctxt; this.schema = schema; this.uri = uri; this.user = user; this.listener = listener; } public void initSchema() { if (ready) { listener.onSchemaLoaded(); } else { ctxt.getLoaderManager().initLoader(loaderId, null, this); } } @Override public boolean deliverSelfNotifications() { return true; } @Override public void onChange(boolean selfChange) { ctxt.getLoaderManager().restartLoader(loaderId, null, this); } @Override public Loader<Cursor> onCreateLoader(int id, Bundle args) { return new CursorLoader( ctxt, uri, new String[] { WebData.Schema.STATUS }, WebData.Schema.SCHEMA_ID + "=?", new String[] { schema }, null); } @Override public void onLoadFinished(Loader<Cursor> loader, Cursor data) { if (schemaReady(data)) { listener.onSchemaLoaded(); } else { data.registerContentObserver(this); startSync(); } } @Override public void onLoaderReset(Loader<Cursor> arg0) { } private boolean schemaReady(Cursor data) { ready = data.moveToFirst() && (WebData.Schema.STATUS_ACTIVE == data.getInt(data.getColumnIndex(WebData.Schema.STATUS))); return ready; } private void startSync() { ContentResolver.requestSync( new Account(user, WebData.ACCOUNT_TYPE), WebData.AUTHORITY, new Bundle()); } } ``` #### 3. SchemaManager 执行流程 为确保 Migrate 加载了必要的模式并获取该模式数据的游标，客户端需按以下步骤操作： 1. **验证模式初始化**：（代码行 32 - 35）客户端代码通过创建 SchemaManager 类的新实例并调用其 initSchema 方法来验证 Migrate 是否已初始化所需模式。若管理器已发现必要的数据集存在且就绪，则可跳过至步骤 9。 2. **获取元表**：（代码行 34）若管理器需确定请求的模式是否存在，它必须从 Migrate 获取元表。元表是 Migrate 所知的模式列表及其状态描述，并非包含联系人列表的表。为获取元表，模式管理器初始化一个加载器以请求其游标。 3. **标准查询**：（代码行 45 - 63）这是对元表（Migrate 的虚拟表之一）的标准游标加载器查询。模式管理器以典型的三阶段加载器方式初始化加载器管理器以从元表加载游标，加载器管理器通过 onCreateLoader 方法请求加载器，加载完成后，onLoadFinished 方法会被调用并传入返回的游标。 4. **判断模式状态**：（代码行 68 - 74）当加载器管理器将元