数据同步管理器设计备忘录
转载时请注明出处和作者联系方式
作者联系方式:李先静 <xianjimli at hotmail dot com>
在设计数据同步管理器时,主要考虑到与不同的PC工具和服务器同步,提高与其它手机的互通性的,方便与第三方合作开发一些增值服务。其基本架构如下

SyncSource: 是对数据源的抽象,它提供获取数据对象和更新对象的接口。常见的数据源有名片、日程、短信、彩信、邮件、相片、录音和记事等等。这个本来是很简单的东西,但为了实现快同步,每次只传输变化的数据,要手机端记录ChangeLog,就变得有点麻烦了。
对于数据库记录的同步。每条记录要增加创建时间和最后修改时间字段,有了这两个字段,我们可以根据最后同步时间生成新增记录和修改记录两个集合。要生成删除记录集合,我们还要增加一个表,并为每个表增加一个删除触发器。在删除记录时,把表名、ID和删除时间加到删除表中,据此我们就可以得到删除集合了。
对于文件类的同步。我们在目录里放一个索引文件,里面记录文件的创建时间和删除时间,文件ID和文件名的对应关系。修改时间可以通过stat取到,就不用记录了。同样根据最后同步时间我们可以得到新增,修改,删除和正常四个集合。
SyncSource是插件的方式提供的,增加新的SyncSource只要按这个接口提供一个动态库就行了。它的接口如下:
typedefSyncRet(*SyncSrcRefFunc)(SyncSrc*thiz);
typedefSyncRet(*SyncSrcUnrefFunc)(SyncSrc*thiz);
typedefSyncID(*SyncSrcGetIDFunc)(SyncSrc*thiz);
typedefconstchar*(*SyncSrcGetTypeFunc)(SyncSrc*thiz);
typedefconstchar*(*SyncSrcGetNameFunc)(SyncSrc*thiz);
typedefconstchar*(*SyncSourceGetURLFunc)(SyncSrc*thiz);
typedefconstchar*(*SyncSourceGetDescFunc)(SyncSrc*thiz);
typedefsize_t(*SyncSrcGetAllNrFunc)(SyncSrc*thiz);
typedefsize_t(*SyncSrcGetDeletedNrFunc)(SyncSrc*thiz);
typedefsize_t(*SyncSrcGetModifiedNrFunc)(SyncSrc*thiz);
typedefsize_t(*SyncSrcGetNewNrFunc)(SyncSrc*thiz);
typedefSyncObject*(*SyncSrcGetObjectFunc)(SyncSrc*thiz,SyncObjectTypetype,size_tindex);
typedefSyncRet(*SyncSrcSetObjectFunc)(SyncSrc*thiz,SyncObject*object);
typedefSyncRet(*SyncSrcAddObjectFunc)(SyncSrc*thiz,SyncObject*object);
typedefSyncRet(*SyncSrcUpdateObjectFunc)(SyncSrc*thiz,SyncObject*object);
typedefSyncRet(*SyncSrcDeleteObjectFunc)(SyncSrc*thiz,SyncObject*object);
typedefSyncRet(*SyncSrcBeginSyncFunc)(SyncSrc*thiz,SyncKindtype,time_tlast_sync,SyncDataFilter*filter);
typedefSyncRet(*SyncSrcEndSyncFunc)(SyncSrc*thiz,SyncRetresult);
typedefSyncObject*(*SyncSrcCreateObjectFunc)(SyncSrc*thiz);
struct_SyncSrc

...{
SyncSrcRefFuncref;
SyncSrcUnrefFuncunref;
SyncSrcGetIDFuncget_id;
SyncSrcGetTypeFuncget_type;
SyncSrcGetNameFuncget_name;
SyncSourceGetURLFuncget_url;
SyncSourceGetDescFuncget_desc;
SyncSrcBeginSyncFuncbegin_sync;
SyncSrcEndSyncFuncend_sync;
SyncSrcGetAllNrFuncget_all_nr;
SyncSrcGetDeletedNrFuncget_deleted_nr;
SyncSrcGetModifiedNrFuncget_modified_nr;
SyncSrcGetNewNrFuncget_new_nr;
SyncSrcGetObjectFuncget_object;
SyncSrcSetObjectFuncset_object;
SyncSrcAddObjectFuncadd_object;
SyncSrcUpdateObjectFuncupdate_object;
SyncSrcDeleteObjectFuncdelete_object;
SyncSrcCreateObjectFunccreate_object;

charpriv[0];
};
SyncEngine: 是对具体同步方式的抽象。比如TCard备份是一个简单的engine,在备份时,它把SyncSource提供的数据存到TCard中,在恢复时,从Tcard中取出数据,并把数据存到 SyncSource中。Sync4JEngine负责通过SyncML与funambol服务器同步。ActiveSyncEngine负责与ActiveSync同步。第三方增加新的同步方式只要实现下面的接口:
typedefSyncRet(*SyncEngineRefFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineUnrefFunc)(SyncEngine*thiz);
typedefSyncID(*SyncEngineGetIDFunc)(SyncEngine*thiz);
typedefconstchar*(*SyncEngineGetNameFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineBeginSyncFunc)(SyncEngine*thiz,SyncPartnerConfig*partner_config,SyncDataFilter*filter);
typedefSyncRet(*SyncEngineSyncFunc)(SyncEngine*thiz,SyncSrc*source,time_tlast_sync,SyncKindtype);
typedefSyncRet(*SyncEngineCancelFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineEndSyncFunc)(SyncEngine*thiz);
typedefSyncRet(*SyncEngineRegEventListenerFunc)(SyncEngine*thiz,SyncOnEventFuncon_event,void*ctx);
typedefSyncRet(*SyncEngineRegProgressListenerFunc)(SyncEngine*thiz,SyncOnProgressFuncon_progress,void*ctx);
struct_SyncEngine
...{
SyncEngineRefFuncref;
SyncEngineUnrefFuncunref;
SyncEngineGetIDFuncget_id;
SyncEngineGetNameFuncget_name;
SyncEngineBeginSyncFuncbegin_sync;
SyncEngineSyncFuncsync;
SyncEngineCancelFunccancel;
SyncEngineEndSyncFuncend_sync;
SyncEngineRegEventListenerFuncreg_event_listener;
SyncEngineRegProgressListenerFuncreg_progress_listener;
charpriv[0];
};
SyncEngineSettings主要负责SyncEngine的设置,每个SyncEngine插件都要提供一个SyncEngineSettings插件,SyncEngineSettings是和GUI相关的,所以与SyneEngine分开提供。SyncEngineSettings的接口很简单:
struct_SyncEngineSettings;
typedefstruct_SyncEngineSettingsSyncEngineSettings;
typedefSyncID(*SyncEngineSettingsGetIDFunc)(SyncEngineSettings*thiz);
typedefconstchar*(*SyncEngineSettingsGetNameFunc)(SyncEngineSettings*thiz);
typedefSyncRet(*SyncEngineSettingsEditPartnerFunc)(SyncEngineSettings*thiz,SyncPartnerConfig*partner_config,SyncSettingsEditDoneFuncdone,void*ctx);
typedefSyncRet(*SyncEngineSettingsRefFunc)(SyncEngineSettings*thiz);
typedefSyncRet(*SyncEngineSettingsUnrefFunc)(SyncEngineSettings*thiz);
struct_SyncEngineSettings
...{
SyncEngineSettingsRefFuncref;
SyncEngineSettingsUnrefFuncunref;
SyncEngineSettingsGetIDFuncget_id;
SyncEngineSettingsGetNameFuncget_name;
SyncEngineSettingsEditPartnerFuncedit_partner;
charpriv[0];
};
~~end~~
609

被折叠的 条评论
为什么被折叠?



