<meta content="text/html; charset=utf-8" http-equiv="CONTENT-TYPE">
<meta content="OpenOffice.org 2.3 (Unix)" name="GENERATOR">
<style type="text/css">
<!--
@page { size: 21cm 29.7cm; margin: 2cm }
P { margin-bottom: 0.21cm }
-->
</style>
数据同步管理器设计备忘录
转载时请注明出处和作者联系方式
作者联系方式:李先静 <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~~