数据同步管理器设计备忘录
转载时请注明出处和作者联系方式
作者联系方式：李先静 <xianjimli at hotmail dot com>
在设计数据同步管理器时，主要考虑到与不同的PC工具和服务器同步，提高与其它手机的互通性的，方便与第三方合作开发一些增值服务。其基本架构如下
SyncSource: 是对数据源的抽象，它提供获取数据对象和更新对象的接口。常见的数据源有名片、日程、短信、彩信、邮件、相片、录音和记事等等。这个本来是很简单的东西，但为了实现快同步，每次只传输变化的数据，要手机端记录ChangeLog，就变得有点麻烦了。
对于数据库记录的同步。每条记录要增加创建时间和最后修改时间字段，有了这两个字段，我们可以根据最后同步时间生成新增记录和修改记录两个集合。要生成删除记录集合，我们还要增加一个表，并为每个表增加一个删除触发器。在删除记录时，把表名、ID和删除时间加到删除表中，据此我们就可以得到删除集合了。
对于文件类的同步。我们在目录里放一个索引文件，里面记录文件的创建时间和删除时间，文件ID和文件名的对应关系。修改时间可以通过stat取到，就不用记录了。同样根据最后同步时间我们可以得到新增，修改，删除和正常四个集合。
SyncSource是插件的方式提供的，增加新的SyncSource只要按这个接口提供一个动态库就行了。它的接口如下：
typedef SyncRet (*SyncSrcRefFunc)(SyncSrc* thiz);
typedef SyncRet (*SyncSrcUnrefFunc)(SyncSrc* thiz);
typedef SyncID (*SyncSrcGetIDFunc)(SyncSrc* thiz);
typedef const char* (*SyncSrcGetTypeFunc)(SyncSrc* thiz);
typedef const char* (*SyncSrcGetNameFunc)(SyncSrc* thiz);
typedef const char* (*SyncSourceGetURLFunc)(SyncSrc* thiz);
typedef const char* (*SyncSourceGetDescFunc)(SyncSrc* thiz);
typedef size_t (*SyncSrcGetAllNrFunc)(SyncSrc* thiz);
typedef size_t (*SyncSrcGetDeletedNrFunc)(SyncSrc* thiz);
typedef size_t (*SyncSrcGetModifiedNrFunc)(SyncSrc* thiz);
typedef size_t (*SyncSrcGetNewNrFunc)(SyncSrc* thiz);
typedef SyncObject* (*SyncSrcGetObjectFunc)(SyncSrc* thiz, SyncObjectType type, size_t index);
typedef SyncRet (*SyncSrcSetObjectFunc)(SyncSrc* thiz, SyncObject* object);
typedef SyncRet (*SyncSrcAddObjectFunc)(SyncSrc* thiz, SyncObject* object);
typedef SyncRet (*SyncSrcUpdateObjectFunc)(SyncSrc* thiz, SyncObject* object);
typedef SyncRet (*SyncSrcDeleteObjectFunc)(SyncSrc* thiz, SyncObject* object);
typedef SyncRet (*SyncSrcBeginSyncFunc)(SyncSrc* thiz, SyncKind type, time_t last_sync, SyncDataFilter* filter);
typedef SyncRet (*SyncSrcEndSyncFunc)(SyncSrc* thiz, SyncRet result);
typedef SyncObject* (*SyncSrcCreateObjectFunc)(SyncSrc* thiz);
struct _SyncSrc
...{
SyncSrcRefFunc ref;
SyncSrcUnrefFunc unref;
SyncSrcGetIDFunc get_id;
SyncSrcGetTypeFunc get_type;
SyncSrcGetNameFunc get_name;
SyncSourceGetURLFunc get_url;
SyncSourceGetDescFunc get_desc;
SyncSrcBeginSyncFunc begin_sync;
SyncSrcEndSyncFunc end_sync;
SyncSrcGetAllNrFunc get_all_nr;
SyncSrcGetDeletedNrFunc get_deleted_nr;
SyncSrcGetModifiedNrFunc get_modified_nr;
SyncSrcGetNewNrFunc get_new_nr;
SyncSrcGetObjectFunc get_object;
SyncSrcSetObjectFunc set_object;
SyncSrcAddObjectFunc add_object;
SyncSrcUpdateObjectFunc update_object;
SyncSrcDeleteObjectFunc delete_object;
SyncSrcCreateObjectFunc create_object;
char priv[0];
};
SyncEngine: 是对具体同步方式的抽象。比如TCard备份是一个简单的engine，在备份时，它把SyncSource提供的数据存到TCard中，在恢复时，从Tcard中取出数据，并把数据存到 SyncSource中。Sync4JEngine负责通过SyncML与funambol服务器同步。ActiveSyncEngine负责与ActiveSync同步。第三方增加新的同步方式只要实现下面的接口：
typedef SyncRet (*SyncEngineRefFunc)(SyncEngine* thiz);
typedef SyncRet (*SyncEngineUnrefFunc)(SyncEngine* thiz);
typedef SyncID (*SyncEngineGetIDFunc)(SyncEngine* thiz);
typedef const char* (*SyncEngineGetNameFunc)(SyncEngine* thiz);
typedef SyncRet (*SyncEngineBeginSyncFunc)(SyncEngine* thiz, SyncPartnerConfig* partner_config, SyncDataFilter* filter);
typedef SyncRet (*SyncEngineSyncFunc)(SyncEngine* thiz, SyncSrc* source, time_t last_sync, SyncKind type);
typedef SyncRet (*SyncEngineCancelFunc)(SyncEngine* thiz);
typedef SyncRet (*SyncEngineEndSyncFunc)(SyncEngine* thiz);
typedef SyncRet (*SyncEngineRegEventListenerFunc)(SyncEngine* thiz, SyncOnEventFunc on_event, void* ctx);
typedef SyncRet (*SyncEngineRegProgressListenerFunc)(SyncEngine* thiz, SyncOnProgressFunc on_progress, void* ctx);
struct _SyncEngine
...{
SyncEngineRefFunc ref;
SyncEngineUnrefFunc unref;
SyncEngineGetIDFunc get_id;
SyncEngineGetNameFunc get_name;
SyncEngineBeginSyncFunc begin_sync;
SyncEngineSyncFunc sync;
SyncEngineCancelFunc cancel;
SyncEngineEndSyncFunc end_sync;
SyncEngineRegEventListenerFunc reg_event_listener;
SyncEngineRegProgressListenerFunc reg_progress_listener;
char priv[0];
};
SyncEngineSettings主要负责SyncEngine的设置，每个SyncEngine插件都要提供一个SyncEngineSettings插件，SyncEngineSettings是和ＧＵＩ相关的，所以与SyneEngine分开提供。SyncEngineSettings的接口很简单：
struct _SyncEngineSettings;
typedef struct _SyncEngineSettings SyncEngineSettings;
typedef SyncID (*SyncEngineSettingsGetIDFunc)(SyncEngineSettings* thiz);
typedef const char* (*SyncEngineSettingsGetNameFunc)(SyncEngineSettings* thiz);
typedef SyncRet (*SyncEngineSettingsEditPartnerFunc)(SyncEngineSettings* thiz, SyncPartnerConfig* partner_config, SyncSettingsEditDoneFunc done, void* ctx);
typedef SyncRet (*SyncEngineSettingsRefFunc)(SyncEngineSettings* thiz);
typedef SyncRet (*SyncEngineSettingsUnrefFunc)(SyncEngineSettings* thiz);
struct _SyncEngineSettings
...{
SyncEngineSettingsRefFunc ref;
SyncEngineSettingsUnrefFunc unref;
SyncEngineSettingsGetIDFunc get_id;
SyncEngineSettingsGetNameFunc get_name;
SyncEngineSettingsEditPartnerFunc edit_partner;
char priv[0];
};
~~end~~
发表于 @ 2008年04月20日 13:49:00|评论(loading...)|编辑